# HG changeset patch # User diego # Date 1050970944 0 # Node ID 0ed75f50f2dfe61deafdeaa4315b5d93c852e54c # Parent 9deb7e948fa69459f561e09728fee96cfad2fd18 Updates for the new xxx:// syntax and numerous clarifications. Patch by Albeu, further corrections by me. diff -r 9deb7e948fa6 -r 0ed75f50f2df DOCS/en/mplayer.1 --- a/DOCS/en/mplayer.1 Mon Apr 21 23:14:21 2003 +0000 +++ b/DOCS/en/mplayer.1 Tue Apr 22 00:22:24 2003 +0000 @@ -71,14 +71,62 @@ .in .B mplayer 'in +\n[.k]u -.RI [ dvd | vcd | cdda | cddb | tv ] ://title +.RI [ mms[t] | http | http_proxy | rt[s]p ] :// +[user:passwd@]\fIURL\fP[:port] [options] +.br +.in +.B mplayer +'in +\n[.k]u +.I dvd://title +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I vcd://track[/device] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I tv://[channel] [options] .br .in .B mplayer 'in +\n[.k]u -.RI [ mms[t] | http | http_proxy | rt[s]p ] :// -[user:passwd@]\fIURL\fP[:port] [options] +.I mf://filemask +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I [cdda|cddb]://track[:speed][/device] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I cue://file[:track] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I dvdnav://[device] +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I sdp://file +[options] +.br +.in +.B mplayer +'in +\n[.k]u +.I mpst://host[:port]/URL +[options] .br .in .B mencoder @@ -171,9 +219,11 @@ .br flip=yes .br -# Decode/\:encode multiple files from png, start with -mf on -.br -mf= type=png:fps=25 +# Decode/\:encode multiple files from png, +.br +# start with mf://filemask +.br +mf=type=png:fps=25 You can also write file-specific configuration files. If you wish to have a config file for a file called 'movie.avi', create a file @@ -183,8 +233,12 @@ .SH "PLAYER OPTIONS (MPLAYER ONLY)" .TP .B \-, \-use-stdin -Read data from stdin. -The \-idx option does not work in conjunction with this. +The standard input (aka. stdin) will be used to read data instead of key +events. If you open /dev/stdin (or the equivalent on your system), use stdin +in a playlist or intend to read from stdin later on via the openfile or +openlist commands you +.B need +this option. .TP .B \-autoq (use with \-vf pp) Dynamically changes the level of postprocessing depending on available spare @@ -213,6 +267,10 @@ Prints some statistics on CPU usage and dropped frames at the end. Use in combination with \-nosound and \-vo null for benchmarking only the video codec. +.br +.I NOTE: +With this option MPlayer will also ignore frame duration when playing +only video (you can think of that as infinite fps). .TP .B \-edl Enables edit decision list (EDL) actions during playback. @@ -284,6 +342,10 @@ .IPs file Read commands from the given file. Mostly useful with a fifo. +.br +.I NOTE: +When the given file is a fifo MPlayer opens both ends so you can do several +\'echo "seek 10" > mp_pipe\' and the pipe will stay valid. .RE .PD 1 . @@ -318,17 +380,20 @@ .TP .B \-playlist Play files according to a playlist (1 file per row or Winamp or ASX format). +.br +.I NOTE: +This option is considered an entry so options found after it will apply +only to the elements of this playlist. .TP .B \-quiet \ \ -Display less output and status messages. +Don't display the status messages. With this option the status line +(i.e. A: 0.7 V: 0.6 A-V: 0.068 ...) will not be displayed. It's +particulary useful when your terminal does not understand carriage +return (i.e. \\r) like the XEmacs one. .TP .B \-really\-quiet \ \ Display even less output and status messages. .TP -.B \-sdp -Specifies that the input file is a SDP ('Session Description Protocol') -file that describes an RTP session (see http://www.live.com/mplayer/). -.TP .B \-shuffle \ \ Play files in random order. .TP @@ -497,10 +562,6 @@ (old-style DVD option) This option is used to override the default location of libcss.so. .TP -.B \-cuefile (see \-vcd too) -Play (S)VCD from CDRwin's (bin/cue fileformat) disk image, described by the -specified file. -.TP .B \-demuxer Force demuxer type. Give the demuxer ID as defined in demuxers.h. @@ -520,15 +581,6 @@ .B \-dumpvideo (MPLAYER only) Dump raw compressed video stream to ./\:stream.dump (not very usable). .TP -.B \-dvd -Tell MPlayer which movies (specified by title id) to play. -For example sometimes '1' is a trailer, and '2' is the real movie. - -.I NOTE: -.br -Sometimes deinterlacing is required for DVD playback, -see the \-vf pp=0x20000 option. -.TP .B \-dvd\-device Override default DVD device name /dev/\:dvd. .TP @@ -545,14 +597,15 @@ this option gives the CSS key needed to decrypt the VOB (the key is printed when authenticating with the DVD drive using \-dvdauth). .TP -.B \-dvdnav (BETA CODE!) -Force usage of libdvdnav. -.TP .B \-forceidx Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc). Seeking will be possible. You can fix the index permanently with MEncoder (see the documentation). +.br +.I NOTES: +You can only use this option if the underlying media supports seeking +(i.e. not with stdin, pipe, etc). .TP .B \-fps Override video framerate (if value is wrong/\:missing in the header) (float @@ -572,6 +625,10 @@ Rebuilds INDEX of the AVI if no INDEX was found, thus allowing seeking. Useful with broken/\:incomplete downloads, or badly created AVIs. +.br +.I NOTES: +You can only use this option if the underlying media supports seeking +(i.e. not with stdin, pipe, etc). .TP .B \-mc Maximum A-V sync correction per frame (in seconds). @@ -583,8 +640,6 @@ .PD 0 .RSs -.IPs on\ \ \ -turns on multifile support .IPs w= width of the output (autodetect) .IPs h= @@ -824,9 +879,6 @@ .B \-user (see \-passwd option too) Specify user name for http authentication. .TP -.B \-vcd -Play video CD track from a device or image file (see \-cuefile). -.TP .B \-vid Select video channel [MPG: 0\-15 ASF: 0\-255]. .TP @@ -3641,7 +3693,7 @@ .SH "SLAVE MODE PROTOCOL" If the \-slave option is given, playback is controlled by a line\-based protocol. -Each line must contain one command otherwise one of the following tokens: +Each line must contain one of the following commands: .TP .B Commands .RSs @@ -3650,6 +3702,8 @@ Type 0 is a relative seek of +/\:- seconds. Type 1 seek to % in the movie. Type 2 is a seek to an absolute position of seconds. +.IPs "edl_mark" +???? .IPs "audio_delay " Adjust the audio delay of value seconds .IPs quit @@ -3669,25 +3723,53 @@ Adjust the subtitles delay of +/\:- seconds or set it to seconds when abs is non zero. .IPs "osd [level=]" -Toggle osd mode or set it to level when level > 0. +Toggle OSD mode or set it to level when level >= 0. .IPs "volume " Increase/\:decrease volume +.IPs "use_master" +Switch volume control betwen master and pcm. +.IPs "mute" +Mute/\:unmute sound output. .IPs "[contrast|brightness|hue|saturation] <\-100\-100> [abs=]" Set/\:Adjust video parameters. .IPs "frame_drop [type=]" Toggle/\:Set frame dropping mode. +.IPs "sub_alignment " +Set subtitle alignment. .IPs "sub_visibility" Toggle subtitle visibility. .IPs "sub_pos " Adjust subtitles position. -.IPs vo_fullscreen +.IPs "vobsub_lang" +Switch the subtitle language when using VOBSub subtitles. +.IPs "get_percent_pos" +??? +.IPs "get_time_length" +??? +.IPs "vo_fullscreen" Switch to fullscreen mode. +.IPs "panscan value [value2]" +??? +.IPs "loadfile url" +Load the given file/\:url. +.IPs "loadlist file" +Load the given playlist file. +.IPs "change_rectangle val1 val2" +??? used by the rectangle video filter. +.IPs "dvdnav button" +Press the given dvdnav button. +.br +1 is up, 2 is down, 3 is left, 4 is right, 5 is menu and 6 is select. .IPs "tv_step_channel " Select next/\:previous tv channel. .IPs "tv_step_norm" Change TV norm. .IPs "tv_step_chanlist" Change channel list. +.IPs "tv_set_channel channel" +Set the current TV channel. +.IPs "tv_last_channel" +Set the current TV channel to the last one. .IPs "gui_[loadsubtitle|about|play|stop]" GUI actions .RE @@ -3740,19 +3822,19 @@ .SH EXAMPLES .TP .B Quickstart DVD playing -mplayer \-dvd 1 +mplayer dvd://1 .TP .B Play in japanese with english subtitles -mplayer \-dvd 1 \-alang ja \-slang en +mplayer dvd://1 \-alang ja \-slang en .TP .B Play only chapters 5, 6, 7 -mplayer \-dvd 1 \-chapter 5\-7 +mplayer dvd://1 \-chapter 5\-7 .TP .B Multiangle DVD playing -mplayer \-dvd 1 \-dvdangle 2 +mplayer dvd://1 \-dvdangle 2 .TP .B Playing from a different DVD device -mplayer \-dvd 1 \-dvd\-device /dev/\:dvd2 +mplayer dvd://1 \-dvd\-device /dev/\:dvd2 .TP .B Old style DVD (VOB) playing mplayer \-dvdauth /dev/\:dvd /mnt/\:dvd/\:VIDEO_TS/\:VTS_02_4.VOB @@ -3766,37 +3848,40 @@ .B Convert subtitle to MPsub (to ./\:dump.mpsub) mplayer dummy.avi \-sub source.sub \-dumpmpsub .TP +.B Convert subtitle to MPsub without watching the movie +mplayer /dev/zero \-rawvideo on:pal:fps=xx \-vc null \-vo null \-noframedrop +\-benchmark \-sub source.sub \-dumpmpsub +.TP .B Input from standard V4L -mplayer \-tv on:driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 +mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv .TP .B Encoding DVD title #2, only selected chapters -mencoder \-dvd 2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc divx4 +mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc divx4 .TP .B Encoding DVD title #2, resizing to 640x480 -mencoder \-dvd 2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc divx4 +mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc divx4 .TP .B Encoding DVD title #2, resizing to 512xHHH (keep aspect ratio) -mencoder \-dvd 2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy +mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy \-ovc divx4 .TP .B The same, but with libavcodec family, MPEG4 (Divx5) compression -mencoder \-dvd 2 \-o title2.avi \-ovc lavc +mencoder dvd://2 \-o title2.avi \-ovc lavc \-lavcopts vcodec=mpeg4:vhq:vbitrate=1800 \-oac copy .TP .B The same, but with libavcodec family, MJPEG compression -mencoder \-dvd 2 \-o titel2.avi \-ovc lavc +mencoder dvd://2 \-o titel2.avi \-ovc lavc \-lavcopts vcodec=mjpeg:vhq:vbitrate=1800 \-oac copy .TP .B Encoding all *.jpg files in the current dir -mencoder \\*.jpg \-mf on:fps=25 \-o output.avi \-ovc divx4 +mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc divx4 .TP .B Encoding from tuner -mencoder \-tv on:driver=v4l:width=640:height=480 \-o tv.avi \-ovc rawrgb +mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc rawrgb .TP .B Encoding from a pipe -rar p test-SVCD.rar | mencoder \-ovc divx4 \-divx4opts br=800 \-ofps 24 -\-\- \- +rar p test-SVCD.rar | mencoder \-ovc divx4 \-divx4opts br=800 \-ofps 24 \- .TP .B Encoding multiple *.vob files cat *.vob | mencoder \-