From b341b3ce2861ffd0a41754cab7fa4640a3c1473e Mon Sep 17 00:00:00 2001 From: arpi Date: Sun, 5 May 2002 21:04:25 +0000 Subject: [PATCH] merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@5989 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/mencoder.1 | 442 ------------- DOCS/mplayer.1 | 1632 +++++++++++++++++++++++++++++------------------ 2 files changed, 1022 insertions(+), 1052 deletions(-) delete mode 100644 DOCS/mencoder.1 diff --git a/DOCS/mencoder.1 b/DOCS/mencoder.1 deleted file mode 100644 index 7572f114fd..0000000000 --- a/DOCS/mencoder.1 +++ /dev/null @@ -1,442 +0,0 @@ -.\" MEncoder (C) 2000-2002 Arpad Gereoffy -.\" This manpage was/is done by Gabucino -.\" -.TH "MEncoder" "1" "2002-05-03" - -.SH NAME -mencoder \- Movie Encoder for Linux - -.SH "SYNOPSIS" -.B mencoder -.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ]\ [\-o\ file] -.BR -.B mencoder -.RB [global\ options]\ \fIfile1\fP\ [specific\ options]\ [file2]\ [specific\ options]\ [\-o\ file] -.BR -.B mencoder -.RB [global\ options]\ {\fIgroup\ of\ files\ and\ options\fP}\ [group\ specific\ options]\ [\-o\ file] -.BR -.B mencoder -.RB [dvd|vcd|tv]://[title]\ [options]\ [\-o\ file] -.BR -.B mencoder -.RB [mms|http]://URL[:port]\ [options]\ [\-o\ file] - -.SH DESCRIPTION -.B mencoder -MEncoder (MPlayer's Movie Encoder) is a simple movie encoder, designed to -encode MPlayer-playable movies (AVI/DVD/VCD/VOB/MPG/MOV/VIV/VIV/FLI/RM/NUV/NET) -to other MPlayer-playable formats (see below). It encodes to DivX4 -(1, 2 or 3 passes), xvid, codecs of libavcodec, PCM/MP3/VBRMP3 audio. -Also has stream copying abilities, a powerfull plugin system -(crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more. - -.SH "OPTIONS" -.I NOTE -Every "flag" option has "noflag" pair, e.g. -flag opposite is -noflag -.BR -.I NOTE -CHECK THE HTML DOCUMENTATION TOO! -.BR -.I NOTE -As MEncoder uses the same 'libmpdemux' as MPlayer, their options are -_sometimes the same_! So although for example the -sid option isn't -mentioned here, you can use it in MEncoder too! (for encoding DVD with -subtitles) -.TP -.B \-ac3file -.TP -.B \-ac -Use specified codec (according to codecs.conf) for decoding input audio -stream. -.TP -.B \-afm -Force decoding by using a specific codec FAMILY, and FALLBACK to default -if failed. For examples see MPlayer manpage. -.TP -.B \-aid -If the source media contains multiple audio streams (for example DVDs), encode -the specified one. -.TP -.B \-audiofile -Copy audio from external file. -.TP -.B \-chapter -Use with -dvd option (see above). Start encoding at the specified chapter. -.TP -.B \-divx4opts -If encoding to DivX4, you can specify its parameters here, like: - - -divx4opts br=1800:deinterlace:key=250 - -Available options: - - help get help - br= specify bitrate in - kbit <4\-16000> or - bit <16001\-24000000> - key= maximum keyframe interval - (in frames) - deinterlace enable deinterlacing - (don't use, DivX4 is buggy!) - q= quality (1\-fastest, 5\-best) - min_quant= minimum quantizer (0\-32) - max_quant= maximum quantizer (0\-32) - rc_period= rate control period - rc_reaction_period= - rate control reaction period - rc_reaction_ratio= - rate control reaction ratio - crispness= (0\-100) -.TP -.B \-dvd -Encode the specified DVD title. -.TP -.B \-dvdangle <angle id> -Use with -dvd option (see above), and if the DVD disc has multiple angles. -It will encode the angle specified here. -.TP -.B \-dvdkey <CSS key> -Used to decrypt CSS-encrypted streams on hard disk (with given CSS decrypt -key). -.TP -.B \-endpos <time> -Stop encoding at given time. Can be specified in many was : - - -endpos 56 encode only 56 seconds - -endpos 01:10:00 encode only 1 hours - -Can be used in conjuction with -ss! -.TP -.B \-ffourcc fourcc -Can be used to force the video fourcc of the output file. For example -ffourcc -div3 will have the output file contain "div3" as video fourcc. -.TP -.B \-frames <number> -Encode only given number of frames. -.TP -.B \-include -Specify config file to be parsed after the default -.TP -.B \-lameopts <options> -If encoding to MP3 with libmp3lame, you can specify its parameters here, like: - - -lameopts br=192:cbr - -Available options: - - help get help - vbr=<value> variable bitrate method - 0=cbr - 1=mt - 2=rh(default) - 3=abr - 4=mtrh - abr average bitrate - cbr constant bitrate - br=<value> specify bitrate in - kbit <0-1024> - (only for CBR and ABR) - q=<value> Quality - (0-highest, 9-low) - (for VBR) - aq=<value> ? - ratio=<value> compression ratio <1-100> - vol=<value> set audio input gain <0-10> - mode=<value> 0=stereo - 1=joint-stereo - 2=dualchannel - 3=mono - (default: auto) - padding=<value> 0=no - 1=all - 2=adjust -.TP -.B \-lavcopts <options> -If encoding with a codec from libavcodec, you can specify its parameters here, -like: - - -lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 - -Available options: - - help get help - - vcodec=<value> use the specified codec : - mjpeg - Motion JPEG - h263 - H263 - h263p - H263 Plus - mpeg4 - DivX 4/5 - msmpeg4 - DivX 3 - rv10 - an old RealVideo codec - mpeg1video - MPEG1 video :) - There's no default, you must - specify it. - - vbitrate=<value> specify bitrate in - kbit <4-16000> or - bit <16001-24000000> - (warning: 1kbit = 1000 bits) - default = 800k - - vratetol=<value> approximated *filesize* tolerance - in kbits. - (warning: 1kbit = 1000 bits) - default = 1024*8 kbits = 1MByte - - keyint=<value> interval between keyframes - (specify in frames, >300 are not - recommended) - default = 250 (one key frame every - ten seconds in a 25fps movie) - - vhq high quality mode, macro blocks - will be encoded multiple times and - the smallest will be used. - default = HQ disabled - - vme=<value> [0..5] motion estimation method : - 0 - no ME at all - 1 - ME_FULL - 2 - ME_LOG - 3 - ME_PHODS - 4 - ME_EPZS - 5 - ME_X1 - EPZS usually gives best results, - but you can try X1 too. FULL is - very slow and the others are - experimental. - default = EPZS - - vqcomp=<value> if the value is set to 1.0, the - quantizer will stay nearly - constant (high motion scenes will - look bad). If it's 0.0, the - quantizer will be changed - to make all frames approximately - equally sized (low motion scenes - will look bad). - default = 0.5 - - vqblur=<value> blurs the quantizer graph over - time. - 0.0 : no blur - 1.0 : average all past - quantizers - default = 0.5 - - vqscale=<value> [2..31] gives each frame the same - quantizer (selects fixed quantizer - mode). - default = 0 (fixed quantizer mode - disabled) - - vrc_strategy=<value> - [0..2] different strategies to - decide which frames should get - which quantizer. - default = 2 - - v4mv 4 motion vectors per macroblock, - may gives you slightly better - quality, can only be used in HQ - mode and is buggy with B frames - currently. - default = disabled - - vpass=<value> [1,2] select internal first pass - or second pass of 2-pass mode. - default = 0 (1-pass mode) - -The next 3 options apply only to I & P frames : - - vqmin=<value> [1..31] minimum quantizer, - default = 3 - - vqmax=<value> [1..31] maximum quantizer - default = 15 - - vqdiff=<value> [1..31] quantizer difference. - Limits the maximum quantizer - difference between frames. - default = 3 - -The following options apply only to B frames : - - vmax_b_frames=<value> - [0..4] maximum number of frames - between each I/P frame. - default = 0 (B-frames generation - disabled) - - vb_strategy=<value> - strategy to choose between - I/P/B frames : - 0 allways use max B - 1 avoid B frames in high - motion / scene change (can - lead to filesize miss - prediction) - default = 0 - - vb_qfactor=XXX quantizer factor between b - and i/p frames (larger means - higher quantizer for b frames) - default = 2.0 - -In fixed quantizer mode you can use those options : - vqscale, vmax_b_frames, vhq, vme, keyint - -You can use the following options only in pass 1 of 2-pass mode or in 1-pass mode : - vqblur, vqdiff - -You can use the following options only in pass 2 of 2-pass mode : - vrc_strategy, vb_strategy - -All other options can be used in all modes. -.TP -.B \-mc\ <seconds/frame> -Maximum sync correction per frame (in seconds). -Use -mc 0 to disable input A/V sync. -.TP -.B \-mf <multifile options> -Used when encoding from multiple JPEG files. -Its sub-options are: - - on turns on multifile support - w=<value> width of the output file [autodetected] - h=<value> height of the output file [autodetected] - fps=<value> fps of the output file [default: 25fps] - type=<value> type of input files (jpeg, png) -.TP -.B \-nobps -Used only for AVIs. Doesn't use the bps value in the AVI header, instead -calculates it. -.TP -.B \-nosound -Encode only video, no audio stream. -.TP -.B \-o <filename> -Outputs to the given filename, instead of the default 'test.avi'. -.TP -.B \-oac <codec name> -Encode with the given codec (codec names are from codecs.conf, -use -ovc help to get a list of available codecs). -Examples: - - -oac copy no encoding, just streamcopy - -oac pcm encode to uncompressed PCM - -oac mp3lame encode to MP3 (using Lame) -.TP -.B \-ofps <fps> -The output file will have different frame/sec than the source. -You MUST set it for variable fps (asf, some mov) and progressive -(29.97fps telecined mpeg) files. -.TP -.B \-ovc <codec name> -Encode with the given codec (codec names are from codecs.conf, -use -ovc help to get a list of available codecs). -Examples: - - -ovc copy no encoding, just streamcopy - -ovc divx4 encode to DivX4/DivX5 or XviD - -ovc rawrgb encode to uncompressed RGB24 - -ovc lavc encode with a libavcodec codec -.TP -.B \-pass <1/2> -With this you can encode 2pass DivX4 files. First encode with -pass 1, then -with the same parameters, encode with -pass 2. -NOTE: for libavcodec 2-pass use -lavcopts vpass=1/2 instead of -pass 1/2 -.TP -.B \-passlogfile <filename> -When encoding in 2pass mode, MEncoder dumps first pass' informations -to the given file instead of the default divx2pass.log. -.TP -.B \-pp <value> -See man mplayer. -.TP -.B \-ss <time> -Seek to given time position. For example: - - -ss 56 seeks to 56 seconds - -ss 01:10:00 seeks to 1 hour 10 min - -Can start only from keyframes! -.TP -.B \-sub <filename> -Given VOBsub/text subtitle will be encoded INTO the output file. Text -subtitles need fonts properly installed. -.TP -.B \-sws <software scaler type> -Type of scaling method (use with -vop scale=w:h) - - 0 fast bilinear (default) - 1 bilinear - 2 bicubic (best quality) - 3 ? - 4 nearest neighbor (bad quality) - 5 area averageing scaling support -.TP -.B \-v, \-\-verbose -Increase verbosity. -.TP -.B \-vc <codec name> -Use specified codec (according to codecs.conf) for decoding input video -stream. -.TP -.B \-vcd <track> -Encode the specified VCD track. -.TP -.B \-vfm <codec family> -Force decoding by using a specific codec FAMILY, and FALLBACK to default -if failed. For examples see MPlayer manpage. -.TP -.B \-vid <stream id> -If the source media contains multiple video streams, encode the specified one. - -.SH "EXAMPLES" -.B Encoding DVD title #2 -mencoder -dvd 2 -o title2.avi -.TP -.B Encoding DVD title #2, only selected chapters -mencoder -dvd 2 -chapter 10-15 -o title2.avi -.TP -.B The same, but with libavcodec family, MJPEG compression -mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg -ffourcc mjpg -.TP -.B Encoding all *.jpg files in the current dir -mencoder \*.jpg -mf on:w=800:h=600:fps=25 -o output.avi -.TP -.B Encoding from HTTP -mencoder http://mplayer.hq/example.avi -o example.avi -.TP -.B Encoding from tuner (see documentation!) -mencoder -tv on:driver=v4l:width=640:height=480 -o tv.avi -.TP -.B Encoding from a pipe -rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- - -.TP -.B Encoding multiple *.vob files -cat *.vob | mencoder <options> - - -.SH BUGS -Probably. PLEASE, double-check the documentation (especially bugreports.html), -the FAQ and the mail archive before! - -Send your complete bugreports to the MPlayer-users mailing list at -<mplayer-users@mplayerhq.hu>. We love complete bugreports :) - -.SH AUTHORS -Check documentation! - -MPlayer is (C) 2000\-2002 -.I Arpad Gereoffy <sendmail@to.mplayer-users> - -This manpage is written and maintained by -.I Gabucino <sendmail@to.mplayer\-users>. - -.SH STANDARD DISCLAIMER -Use only at your own risk! There may be errors and inaccuracies that could -be damaging to your system or your eye. Proceed with caution, and although -this is highly unlikely, the author doesn't take any responsibility for that! -.\" end of file diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1 index 5b6acaf780..3e7dd89819 100644 --- a/DOCS/mplayer.1 +++ b/DOCS/mplayer.1 @@ -1,10 +1,13 @@ .\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users> -.\" This manpage was/is done by Gabucino +.\" This manpage was/is done by Gabucino <sendmail@to.mplayer-users> +.\" (Patches done by Jonas Jermann <sendmail@to.mplayer-users>) .\" -.TH "MPlayer" "1" "2002-05-03" +.TH "MPlayer" "1" "2002-05-04" .SH "NAME" mplayer \- Movie Player for Linux +.br +mencoder \- Movie Encoder for Linux .SH "SYNOPSIS" .B mplayer @@ -20,12 +23,18 @@ mplayer \- Movie Player for Linux .RB [dvd|vcd|tv]://[title]\ [options] .br .B mplayer -.RB [mms|http]://URL[:port]\ [options] +.RB [mms|http|http_proxy|ftp]://URL[:port]\ [options] +.br +.B mencoder +.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ]\ [\-o\ file] +.br +.B gmplayer +.RB [options]\ [\-skin\ skin] .SH "DESCRIPTION" .B mplayer is a movie player for LINUX (runs on many other Unices, and non\-x86 -CPUs, see section 6). It plays most MPEG, VOB, AVI, VIVO, ASF/WMV, QT/MOV, FLI, +CPUs, see DOCS section 6). It plays most MPEG, VOB, AVI, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV movies too (and you don't need the avifile library at all!). @@ -44,228 +53,162 @@ etc), cyrillic, korean fonts are supported (10 supported subtitle formats: Micro SubViewer, SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, VobSub, and our own: MPsub). -.SH "GUI OPTIONS" -.I NOTE: -The GUI code has to be compiled in *explicitly* (see documentation). +.B mencoder +(MPlayer's Movie Encoder) is a simple movie encoder, designed to +encode MPlayer-playable movies (AVI/DVD/VCD/VOB/MPG/MOV/VIV/VIV/FLI/RM/NUV/NET) +to other MPlayer-playable formats (see below). It encodes to DivX4 +(1, 2 or 3 passes), xvid, codecs of libavcodec, PCM/MP3/VBRMP3 audio. +Also has stream copying abilities, a powerfull plugin system +(crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more. + +.B gmplayer +is MPlayer with a graphical user interface. +It has the same options as MPlayer. + +.SH GENERAL NOTES +Every "flag" option has "noflag" pair, e.g. \-fs opposite is \-nofs. +.br +.B Check the html documentation too! + +.SH "DEMUXER/STREAM OPTIONS" +.TP +.B \-aid <id> +Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...] .br .I NOTE: -The GUI code is STILL exterimental, it is under heavy development, parts of it (for example: playlist) not yet implemented. -.TP -.B \-gui -Start MPlayer in GUI mode. -.TP -.B \-skin <skin\ directory> -Load skin from this directory (WITHOUT path name!). For example '\-skin fittyfene' tries these: - - /usr/local/share/mplayer/Skin/fittyfene - ~/.mplayer/Skin/fittyfene - -.SH "DVD OPTIONS" -.I NOTE: -These options are valid only with DVD support compiled in (see documentation). -.br -.I NOTE: -DVD playback sometimes requires deinterlacing: see '\-pp 0x20000' or '\-npp lb' options. -.TP -.B \-alang\ <audio\ stream\ language> +Use \-alang to define the language by name. +.TP +.B \-alang <audio\ stream\ language> Used when playing DVD disks. Expects a two\-letter country code(s) as parameter, and always tries to play back audio streams those language matches the given code. For example: \-alang hu,en will always try to play hungarian or if it's non\-existant then english audio streams if there are any. -.TP -.B \-chapter\ <chapter\ id>[-<end chapter id>] +.TP +.B \-audio\-demuxer <number> +Force audio demuxer type for \-audiofile. +Give the demuxer ID as defined in demuxers.h. +.TP +.B \-audiofile <filename> +Play audio from an external file (WAV, MP3 or Vorbis) +.TP +.B \-cdrom\-device <path\ to\ device> +Override default CDROM drive name /dev/cdrom +.TP +.B \-cache <kbytes> +This option specifies how much memory to use when precaching a file/URL. +Especially useful on slow media (default is \-nocache). +.TP +.B \-chapter <chapter\ id>[-<end chapter id>] Specify which chapter to start playing at. Optionally specify which chapter to end playing at. Examples can be found below. -.TP +.TP .B \-csslib <filename> (old-style DVD option) This option is used to override the default location of libcss.so -.TP -.B \-dvd\ <title\ id> +.TP +.B \-demuxer <number> +Force demuxer type. Give the demuxer ID as defined in demuxers.h. +.TP +.B \-dumpaudio (MPLAYER only) +Dumps raw compressed audio stream to ./stream.dump (usefull with mpeg/ac3) +.TP +.B \-dumpfile <filename> (MPLAYER only) +Specify to which file MPlayer should dump to. Should be used together +with \-dumpaudio/\-dumpvideo/\-dumpstream. +.TP +.B \-dumpstream (MPLAYER only) +Dumps the raw steram to ./stream.dump . Useful for example +when ripping from DVD or network. +.TP +.B \-dumpsub (MPLAYER only) +Dumps the subtitle substream from VOB streams. +.TP +.B \-dumpvideo (MPLAYER only) +Dump raw compressed video stream to ./stream.dump (not very usable) +.TP +.B \-dvd <title\ id> Tell MPlayer which movies (marked with titleid) to play. For example -sometimes '1' are trailers, and '2' is the real movie. -.TP -.B \-dvd\-device\ <path\ to\ device> +sometimes '1' are trailers, and '2' is the real movie. Sometimes deinterlacing +is required for DVD playback: see '\-pp 0x20000' or '\-npp lb' options too. +.TP +.B \-dvd\-device <path\ to\ device> Override default DVD device name /dev/dvd -.TP -.B \-dvdangle\ <angle\ id> +.TP +.B \-dvdangle <angle\ id> Some DVD discs contain scenes that can be viewed from multiple angles. Here you can tell MPlayer which angles to use. Examples can be found below. -.TP +.TP .B \-dvdauth <DVD\ device> (old-style DVD option) Turns on DVD authentication using the given device. -.TP +.TP .B \-dvdkey <CSS\ key> (old-style DVD option) When decoding from non-DVD, this option gives the CSS key needed to crack the DVD (the key is printed when authenticating with DVD). -.TP -.B \-dvdnav +.TP +.B \-dvdnav (BETA CODE) Force usage of libdvdnav. -.TP -.B \-sid\ <id> -Turns on DVD subtitle displaying. Also, you MUST specify a number which -corresponds to a DVD subtitle language (0\-31). For the list of available -subtitles, use with the \-v switch and look at the output. -.br -.I NOTE: -Use \-slang to define the subtitle language by name. -.TP -.B \-skipopening -Skip dvd opening (dvdnav only). -.TP -.B \-slang\ <subtitle\ language> -See the \-sid option, but this one needs a two\-letter parameter, a country code. -Like: \-slang hu,en will always select hungarian or if it's non existant then -english subtitles, if there are any. For the list of available subtitles, use -with the \-v switch and look at the output. - -.SH "GENERAL OPTIONS" -.I NOTE: -Every "flag" option has "noflag" pair, e.g. \-fs opposite is \-nofs -.TP -.B \-ao\ <driver>[:<device>] -Select audio output driver and optinaly device. "device" is valid with -SDL too, it means sub\-driver then (for example: \-vo sdl:esd). -If using OSS, you can specify which sound device to use like this: - - \-ao oss:/dev/dsp1 (replaces the old \-dsp option) - -You can get the list of available drivers executing -.I mplayer \-ao help -.TP -.B \-aspect <ratio> -Set aspect ratio of movies. It's autodetected on MPEG files, and can't be -autodetected on AVI files. Examples: - - \-aspect 4:3 or \-aspect 1.3333 - \-aspect 16:9 or \-aspect 1.7777 -.TP -.B \-audiofile\ <filename> -Play audio from an external file (WAV, MP3 or Vorbis) -.TP -.B \-autoq\ <quality> -Dynamically changes the level of postprocess, depending on spare CPU time -available. The number you specify will be the maximum level used. Usually you -can use some big number. You may not use together with \-pp but it's ok with -\-npp! -.TP -.B \-benchmark -Prints some statistics on CPU usage and dropped frames at the end. -Used in combination with \-nosound and \-vo null for benchmarking only video codec. -.TP -.B \-cdrom\-device\ <path\ to\ device> -Override default CDROM drive name /dev/cdrom -.TP -.B \-dr -Turns on direct rendering (not supported by all codecs and video outputs) -(default is off). -.TP -.B \-ffactor\ <number> -Resample alphamap of the font. Can be: - - 0 plain white fonts - 0.75 very narrow black outline [default] - 1 narrow black outline - 10 bold black outline -.TP -.B \-font\ <path\ to\ font.desc\ file> -Search for the OSD/SUB fonts in an alternative directory (default: -~/.mplayer/font/font.desc). For example: - - \-font ~/.mplayer/arial\-14/font.desc -.TP -.B \-fs -Fullscreen playing (centers movie, and makes black -bands around it). Toggle it with the 'f' key (not all video -outputs support it). .TP -.B \-h, --help -Show short summary of options -.TP -.B \-ifo <vobsub\ ifo\ file> -Indicate the file that will be used to load palette and frame size for VOBSUB -subtitles. -.TP -.B \-lircconf\ <config\ file> -Specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc -.TP -.B \-loop\ <num> -Loops movie playback <num> times. 0 means forever. +.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). .TP -.B \-mf\ <multifile\ options> -Used when decoding from multiple PNG or JPEG files. The sub\-options are separated by ":" +.B \-fps <value> +Force frame rate (if value is wrong in the header) (float number) +.TP +.B \-frames <number> +MPlayer plays <number> frames, then quits. +.TP +.B \-hr\-mp3\-seek +Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, +as we need to seek to the very exact position to keep A/V sync. It can be slow +especially when seeking backwards \- it has to rewind to the beginning to find +the exact frame. +.TP +.B \-idx (see \-forceidx option too!) +Rebuilds INDEX of the AVI if no INDEX was found, +thus allowing seeking. Useful with broken/incomplete +downloads, or badly created AVIs. +.TP +.B \-mc <seconds/frame> +Maximum A-V sync correction per frame (in seconds) +.TP +.B \-mf <option1:option2:...> +Used when decoding from multiple PNG or JPEG files. (see documentation). They are: on turns on multifile support - w=<value> width of the output - h=<value> height of the output - fps=<value> fps of the output + w=<value> width of the output (autodetect) + h=<value> height of the output (autodetect) + fps=<value> fps of the output (default: 25) type=<value> type of input files (available types : jpeg, png) -.TP -.B \-mixer\ <device> -This option will tell MPlayer to use a different device for mixing than -/dev/mixer. -.TP -.B \-monitoraspect <ratio> -Set aspect ratio of your screen. Examples: - - \-monitoraspect 4:3 or 1.3333 - \-monitoraspect 16:9 or 1.7777 -.TP -.B \-noautosub -Turns off automatic subtitles -.TP -.B \-nosound -Don't play sound -.TP -.B \-osdlevel\ <level> -Specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer) -(default = 2) -.TP -.B \-playlist <file> -Play files according to this filelist (1 file/row or Winamp or ASX format). -.TP -.B \-quiet -Display less output, status messages. -.TP -.B \-rootwin -Play movie in the root window (desktop background) instead of opening -a new one. Works only with the xv and xmga drivers. -.TP -.B \-ss\ <time> (see \-sb option too!) +.TP +.B \-ni +Force usage of non\-interleaved AVI parser (fixes playing +of some bad AVI files). +.TP +.B \-nobps +Don't use avg. byte/sec value for A\-V sync (AVI). +Helps with some AVI files with broken header. +.TP +.B \-skipopening +Skip dvd opening (dvdnav only). +.TP +.B \-sb <byte\ position> (see \-ss option too!) +Seek to byte position. Useful for playback from cdrom +images / vob files with junk at the beginning. +.TP +.B \-srate <Hz> +Specifies Hz to playback audio on. Has effect on playback speed! +.TP +.B \-ss <time> (see \-sb option too!) Seek to given time position. For example: \-ss 56 seeks to 56 seconds \-ss 01:10:00 seeks to 1 hour 10 min -.TP -.B \-sub\ <subtitle\ file> -Use/display this subtitle file -.TP -.B \-subdelay\ <sec> -Delays subtitles by <sec> seconds. Can be negative. -.TP -.B \-subfps\ <rate> -Specify frame/sec rate of subtitle file (float number) -(ONLY for frame\-based SUB files, i.e. NOT MicroDVD format!) -(default: the same fps as the movie) -.TP -.B \-subpos <0 \- 100> -Specify the position of subtitles on screen -.TP -.B \-sws\ <software\ scaler\ type> -This option sets the quality (and speed, respectively) of the software scaler, -with the \-zoom option. For example with x11 or other outputs which lack -hardware acceleration. Possible settings are: - - 0 fast bilinear (default) - 1 bilinear - 2 bicubic (best quality) - 3 ? - 4 nearest neighbor (bad quality) - 5 area averageing scaling support -.TP -.B \-tv\ <sub\-options> -This option enables the TV grabbing feature of MPlayer. The sub\-options are separated -by ":" (see documentation). They are: +.TP +.B \-tv <option1:option2:...> +This option enables the TV grabbing feature of MPlayer (see documentation). +Available options are: on use TV input noaudio no sound @@ -279,40 +222,19 @@ by ":" (see documentation). They are: norm=<value> available: PAL, SECAM, NTSC channel=<value> set the tuner to the given channel chanlist=<value> available: us-bcast, us-cable, europe-west, europe-east, etc -.TP -.B \-v -Enable verbose output (more \-v means more verbosity) -.TP -.B \-vcd\ <track> +.TP +.B \-vcd <track> Play video cd track from device instead of plain file -.TP -.B \-vm -Try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl -output drivers support it. -.TP -.B \-vo\ <driver>[:<device>] -Select video output driver and optinally device. "device" is valid with -SDL and GGI too, it means sub\-driver then (for example: \-vo sdl:aalib). - -You can get the list of available drivers executing -.I mplayer \-vo help .TP -.B \-vobsub\ <vobsub\ file\ without\ extention> -Specify the VobSub files that are to be used for subtitle. This is -the full pathname without extensions, i.e. without the ".idx", ".ifo" -or ".sub". -.TP -.B \-vobsubid\ <vobsub\ subtitle\ id> -Specify the VobSub subtitle id. Valid values range from 0 to 31. - -.SH "ADVANCED OPTIONS" -.I NOTE: -These options can help you solve your particular problem (see documentation too!) or help in fine-tuning codec/driver parameters. +.B \-vid <id> +Select video channel [MPG: 0\-15 ASF: 0\-255 ] +.TP +.B \-vivo <sub\-options> (DEBUG CODE) +Force audio parameters for the .vivo demuxer (for debugging purposes) + + +.SH "DECODING/FILTERING OPTIONS" .TP -.B \-aa* -Used for \-vo aa. You can get a list and an explanation of available options executing -.I mplayer \-aahelp -.TP .B \-ac <codec name> Force usage of a specific audio codec, according to its name in codecs.conf, for example: @@ -325,221 +247,34 @@ for example: \-ac ffmp3 use ffmpeg's MP3 decoder (SLOW) See '\-ac help' for FULL list! -.TP -.B \-aid\ <id> -Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...] -.br -.I NOTE: -Use \-alang to define the language by name. .TP -.B \-aofile <filename> -Filename for \-ao pcm. -.TP -.B \-aop\ <sub\-options> -Specify audio plugin(s) and their options, separated by ":" (see documentation!!). -Available sub\-options are: +.B \-afm <1\-12> (OBSOLETE) +Force usage of a specific audio format. For example: - list=[plugins] comma separated list of plugins - (resample, format, surround, format, volume, extrastereo, volnorm) - delay=<sec> example plugin, don't use! - format=<format> output format (format plugin only) - fout=<Hz> output frequency (resample plugin only) - volume=<0-255> volume (volume plugin only) - mul=<value> stereo coefficient, defaults to 1 (extrastereo plugin only) - softclip compressor/"soft\-clipping" capabilities (volume plugin only) - -.TP -.B \-audio\-demuxer <number> -Force audio demuxer type for \-audiofile. Give the demuxer ID as defined in -demuxers.h. -.TP -.B \-blue_intensity <\-1000\ \-\ 1000> -Adjust intensity of blue component of video signal (default 0). -.TP -.B \-bpp\ <depth> -Use different color depth than autodetect. Not all \-vo drivers support -it (fbdev, dga2, svga, vesa). -.TP -.B \-brightness <\-1000\ \-\ 1000> -Adjust brightness of video output (default 0). It changes intensity of -RGB components of video signal from black to white screen. -.TP -.B \-cache\ <kbytes> -This option specifies how much memory to use when precaching a file/URL. -Especially useful on slow media (default is \-nocache). -.TP -.B \-channels <n> -Select number of audio output channels to be used + \-afm 1 use libmp3 (mp2/mp3, but not mp1) + \-afm 2 suppose raw PCM audio + \-afm 3 use libac3 + \-afm 4 use a matching Win32 codec + \-afm 5 use aLaw/uLaw driver + \-afm 10 use libvorbis + \-afm 11 use ffmpeg's MP3 decoder (even mp1) - Stereo 2 - Surround 4 - Full 5.1 6 - -Currently this option is only honoured for AC3 audio. -.TP -.B \-contrast <\-1000\ \-\ 1000> -Adjust contrast of video output (default 0). Works in similar manner as brightness. -.TP -.B \-delay\ <secs> -Audio delay in seconds (may be +/\- float value) -.TP -.B \-demuxer <number> -Force demuxer type. Give the demuxer ID as defined in demuxers.h. -.TP -.B \-display <name> -Specify the hostname and display number of the X server you want -to display on. For example: \-display xtest.localdomain:0 -.TP -.B \-double -Enables doublebuffering. Fixes flicker by storing two frames in memory, and -displaying one while decoding another. Can effect OSD. Needs twice the memory -than a single buffer, so it won't work on cards with very few video memory. -.TP -.B \-dumpaudio -Writes audio stream of the file to ./stream.dump (mostly usable -with mpeg/ac3) +See \-ac help for FULL list! +.TP +.B \-aspect <ratio> +Override aspect ratio of movies. It's autodetected on MPEG files, but can't be +autodetected on most AVI files. Examples: + + \-aspect 4:3 or \-aspect 1.3333 + \-aspect 16:9 or \-aspect 1.7777 .TP -.B \-dumpfile <filename> -Specify to which file MPlayer should dump to. Should be used together -with \-dumpaudio/\-dumpvideo. -.TP -.B \-dumpmpsub -Convert the given subtitle (specified with the \-sub switch) to MPlayer's -subtitle format, MPsub. Creates a dump.mpsub file in current directory. -.TP -.B \-dumpstream -Dumps the file to ./stream.dump . Useful for example -when ripping from DVD. -.TP -.B \-fb\ <device> (FBdev or DirectFB only) -Specifies the framebuffer device to use. By default it uses /dev/fb0. -.TP -.B \-fbmode\ <modename> (FBdev only) -Change videomode to the one that is labelled as <modename> in /etc/fb.modes. -.br -.I NOTE: -VESA framebuffer doesn't support mode changing. -.TP -.B \-fbmodeconfig\ <filename> (FBdev only) -Use this config file instead of the default /etc/fb.modes. -Only valid for the fbdev driver. -.TP .B \-flip -Flip image upside-down. -.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). -.TP -.B \-forcexv (SDL only) -Force using XVideo -.TP -.B \-fps\ <value> -Force frame rate (if value is wrong in the header) (float number) -.TP -.B \-framedrop (see \-hardframedrop option too!) -Frame dropping: decode all (except B) frames, video may skip. Usefull for playback on slow VGA card/bus. -.TP -.B \-frames\ <number> -MPlayer plays <number> frames, then quits. -.TP -.B \-fsmode\ <mode> -This option workarounds some problems when using specific windowmanagers and -fullscreen mode. If you experience fullscreen problems, try changing this -value between 0 and 7. - - \-fsmode 0 new method - \-fsmode 1 ICCCWM patch - (for KDE2/icewm) - \-fsmode 2 old method - \-fsmode 3 ICCCWM patch - plus Motif method +Flip image upside-down .TP -.B \-green_intensity <\-1000\ \-\ 1000> -Adjust intensity of green component of video signal (default 0). +.B \-nosound +Don't play/encode sound .TP -.B \-hardframedrop -More intense frame dropping (breaks decoding). Leads to image disortion! -.TP -.B \-hr\-mp3\-seek -Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, as -we need to seek to the very exact position to keep A/V sync. It can be slow -especially when seeking backwards \- it has to rewind to the beginning to find -the exact frame. -.TP -.B \-hue <\-1000\ \-\ 1000> -Adjust hue of video signal (default 0). You can get colored negative -of image with this option. -.TP -.B \-idx (see \-forceidx option too!) -Rebuilds INDEX of the AVI if no INDEX was found, -thus allowing seeking. Useful with broken/incomplete -downloads, or badly created AVIs. -.TP -.B \-include <configfile> -Specify config file to be parsed after the default -.TP -.B \-input <commands> -This option can be used to configure certain parts of the input system. - - conf=<file> read alternative input.conf. - If given without pathname, - $HOME/.mplayer is assumed. - ar\-delay delay in msec before we start - to autorepeat a key - (0 to disable) - ar\-rate how many keypress/second when - we autorepeat - keylist prints all keys that can be - bound to - cmdlist prints all commands that can - be bound - js\-dev specifies the joystick device - to use - (default is /dev/input/js0) - -.I NOTE: -Autorepeat is currently only supported by joysticks. -.TP -.B \-jpeg <sub\-options> -Specify options for for JPEG output, separated by ":" (see documentation!). -Available sub\-options are [no]progressiv, [no]baseline, -optimize, smooth, quality and outdir. -.TP -.B \-mc\ <seconds/frame> -Maximum A-V sync correction per frame (in seconds) -.TP -.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (FBdev only) -Look into etc/example.conf for further information and in DOCS/video.html. -.TP -.B \-monitor_hfreq <horizontal frequency range> (FBdev only) -.TP -.B \-monitor_vfreq <vertical frequency range> (FBdev only) -.TP -.B \-ni -Force usage of non\-interleaved AVI parser (fixes playing -of some bad AVI files). -.TP -.B \-nobps -Don't use avg. byte/sec value for A\-V sync (AVI). Helps with some AVI files with broken header. -.TP -.B \-nojoystick -Turns off joystick support. Default is on, if compiled in. -.TP -.B \-nolirc -Turns off lirc support. -.TP -.B \-nortc -Turns off usage of /dev/rtc (real-time clock) -.TP -.B \-noslices -Disable the use of draw_slice by codecs. -.TP -.B \-nowaveheader (-ao pcm only) -Don't include wave header. Used for RAW PCM. -.TP -.B \-npp\ <options> +.B \-npp <option1,option2,...> This option allows to give more litterate options for postprocessing, and is another way of calling it (not with \-pp). @@ -547,7 +282,7 @@ and is another way of calling it (not with \-pp). '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' -The options for \-npp are a coma separated list you can get by executing +You can get a list of options for \-npp by executing .I mplayer \-npp help .br These keywords accept a '\-' prefix to disable the option. @@ -568,14 +303,20 @@ Each filter defaults to 'c' (chrominance). '\-npp hb:y,vb:a \-autoq 6' means 'deblock horizontal only luminance, and automatically switch vertical deblocking on/off depending on available cpu time' -.TP -.B \-pp\ <quality> (see \-npp option too!) +.TP +.B \-pp <quality> (see \-npp option too!) Apply postprocess filter on decoded image -Postprocessing effect depends on the codec and works only for MPEG1/2, -libavcodec codecs (ff*). It doesn't work for Win32/XAnim codecs. +Value given by -pp is sent to the codec, if the codec has built-in postprocess +filter (newer win32 DShow DLLs, divx4linux) otherwise the external postprocess +filter plugin (-vop pp) is auto-loaded and used. Note, that -npp only works +with external pp. Also note, that you can use the built-in and external pp at the +same time, use -pp to set internal pp, and -vop pp=value to set up the external! -This is the numerical mode to use postprocessing. The '\-npp' option described +The valid range of -pp value for built-in pp filters vary on codecs, mostly +0-6, where 0=disable 6=slowest/best. + +For the external pp filter, this is the numerical mode to use postprocessing. The '\-npp' option described below has the same effects but with letters. To have several filters at the same time, simply add the hexadecimal values. @@ -584,59 +325,35 @@ The following values are known to give good results: \-pp 0x20000 <=> \-npp lb (deinterlacing \- for DVD/MPEG2 playback e.g.) \-pp 0x7f <=> \-npp hb,vb,dr,al (smooth the images) .TP -.B \-red_intensity <\-1000\ \-\ 1000> -Adjust intensity of red component of video signal (default 0). +.B \-ssf <mode> (BETA CODE) +Specifies SwScaler parameters. Available options are: + + lgb=[0..100] gaussian blur filter (luma) + cgb=[0..100] gaussian blur filter (chroma) + ls=[0..100] sharpen filter (luma) + cs=[0..100] sharpen filter (chroma) + cvs=x chroma vertival shifting + chs=x chroma horizontal shifting .TP -.B \-saturation <\-1000\ \-\ 1000> -Adjust saturation of video output (default 0). You can get grayscale output -with this option. -.TP -.B \-sb\ <byte\ position> (see \-ss option too!) -Seek to byte position. Useful for playback from cdrom images / vob files with junk at the beginning. -.TP -.B \-screenw\ <pixels> \-screenh\ <pixels> -If you use an output driver which can't know the resolution of the screen -(fbdev/x11 and/or TVout) this is where you can specify the horizontal and vertical -resolution. -.TP -.B \-slave -This option switches on slave mode. This is intended for use -of MPlayer as a backend to other programs. Instead of intercepting keyboard -events, MPlayer will read simplistic command lines from its stdin. -See section -.B SLAVE MODE PROTOCOL -For the syntax. -.TP -.B \-softsleep -Uses high quality software timers. Efficient as the RTC, doesn't need root, -but requires more CPU. -.TP -.B \-srate <Hz> -Specifies Hz to playback audio on. Has effect on playback speed! -.TP -.B \-sstep <sec> -Specifies seconds between displayed frames. Usefull for slideshows. -.TP .B \-stereo <mode> Select type of MP2/MP3 stereo output. Stereo 0 Left channel 1 Right channel 2 -.TP -.B \-subcp\ codepage -If your system supports iconv(3), you can use this option to -specify codepage of the subtitle. Examples: +.TP +.B \-sws <software\ scaler\ type> +This option sets the quality (and speed, respectively) of the software scaler, +with the \-zoom option. For example with x11 or other outputs which lack +hardware acceleration. Possible settings are: - \-subcp latin2 - \-subcp cp1250 -.TP -.B \-unicode -Tells MPlayer to handle the subtitle file as UNICODE. -.TP -.B \-utf8 -Tells MPlayer to handle the subtitle file as UTF8. -.TP + 0 fast bilinear (default) + 1 bilinear + 2 bicubic (best quality) + 3 ? + 4 nearest neighbor (bad quality) + 5 area averageing scaling support +.TP .B \-vc <codec name> Force usage of a specific video codec, according to its name in codecs.conf, for example: @@ -648,113 +365,8 @@ for example: \-vc divx4 use ProjectMayo's DivX codec See '\-vc help' for FULL list! -.TP -.B \-vid\ <id> -Select video channel [MPG: 0\-15 ASF: 0\-255 ] -.TP -.B \-vop <plugin> -Activate video filters (see documentation!). -Available plugins are: - - crop[=w:h:x:y] simple cropping plugin - expand[=w:h:x:y:o] expanding and (optional) OSD rendering plugin - flip flips image upside-down - mirror horizontal mirroring - rotate[=x] rotate image +/\- 90 degrees - scale[=w:h] software scaling (zoom) and yuv<\->rgb colorspace conversion - yuy2 forced software YV12/I420 \-> YUY2 conversion - rgb2bgr[=swap] RGB 24/32 <\-> BGR 24/32 colorspace conversion (default) - optional with R<\->B swapping - palette RGB/BGR 8 \-> RGB/BGR 15/16/24/32 colorspace conversion using palette - format[=fourcc] restrict the list of supported colorspaces to a single fourcc - (default 'yuy2', may be rgb12, bgr24, yv12 etc...) - pp[=flags] postprocessing filter (see \-pp option) - lavc fast software YV12\->MPEG1 conversion - fame fast software YV12\->MPEG1 conversion .TP -.B \-vsync -Enables VBI for vesa -.TP -.B \-wid\ <window\ id> -This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a -browser (with the plugger extension for instance) -.TP -.B \-xineramascreen <screen\ number> -In Xinerama configurations (i.e. a single desktop that spans across multiple -displays) this option tells MPlayer which screen to display movie on. Range 0 \- ... -.TP -.B \-x\ <x> -Scale image to x width (if sw/hw scaling available). Disables aspect calcs. -.TP -.B \-xy\ <x> - x<=8 Scale image by factor <x> - x>8 Set width to <x> and calculate height to keep correct aspect ratio -.TP -.B \-y\ <y> -Scale image to y height (if sw/hw scaling available). Disables aspect calcs. -.TP -.B \-zoom -Allow software scaling, where available. Could be used to force scaling with -vop scale -(-vop scale will IGNORE options -x/-y/-xy/-fs/-aspect without -zoom) -.TP -.B \-z\ <0\-9> -Specifies compression level for PNG output (-vo png) - 0 no compression - 9 max compression -.TP -.B \-zr* -Used for \-vo zr. You can get a list and an explanation of available options executing -.I mplayer \-zrhelp - -.SH "ALPHA/BETA CODE" -.I NOTE: -These are included in this manpage just for completeness! These may or may NOT -work! If you don't know what are these, you DON'T need these! In either case, -double\-check the documentation! -.TP -.B \-dumpvideo -Dump raw compressed video stream to ./stream.dump (not very usable) -.TP -.B \-ssf <mode> -Specifies SwScaler filters. Available modes are: - - lgb gaussian blur filter (luma) - cgb gaussian blur filter (chroma) - cvs chroma vertival shifting - chs chroma horizontal shifting - ls sharpen filter (luma) - cs sharpen filter (chroma) -.TP -.B \-sub\-demuxer <number> -Force subtitle demuxer type for \-subfile. -.TP -.B \-subfile <filename> -Currently useless. Same as \-audiofile, but for subtitle streams. (OggDS?) -.TP -.B \-vivo <sub\-options> -Force audio parameters for the .vivo demuxer (for debugging purposes) - -.SH "OBSOLETE OPTIONS" -.I NOTE: -These options are obsoleted and may be removed in future. -.TP -.B \-afm <1\-12> -Force usage of a specific audio format. For example: - - \-afm 1 use libmp3 (mp2/mp3, but not mp1) - \-afm 2 suppose raw PCM audio - \-afm 3 use libac3 - \-afm 4 use a matching Win32 codec - \-afm 5 use aLaw/uLaw driver - \-afm 10 use libvorbis - \-afm 11 use ffmpeg's MP3 decoder (even mp1) - -See \-ac help for FULL list! -.TP -.B \-dapsync -Use alternative A/V sync method. -.TP -.B \-vfm <1\-12> +.B \-vfm <1\-12> (OBSOLETE) Force usage of a specific codec FAMILY, and FALLBACK to default if failed. For example: @@ -774,15 +386,703 @@ If libdivxdecore support was compiled in, then type 3 and 7 now contains just the same DivX4 codec, but different APIs to reach it. For difference between them and when to use which, check the DivX4 section in the documentation. +.TP +.B \-vop <plugin3, plugin2, plugin1, ...> +Activate coma separated list of video filters (see documentation!). +Available plugins are: + + crop[=w:h:x:y] simple cropping plugin + expand[=w:h:x:y:o] expanding and (optional) OSD rendering plugin + flip flips image upside-down + mirror horizontal mirroring + rotate[=x] rotate image +/\- 90 degrees + scale[=w:h] software scaling (zoom) and yuv<\->rgb colorspace conversion + yuy2 forced software YV12/I420 \-> YUY2 conversion + rgb2bgr[=swap] RGB 24/32 <\-> BGR 24/32 colorspace conversion (default) + optional with R<\->B swapping + palette RGB/BGR 8 \-> RGB/BGR 15/16/24/32 colorspace conversion using palette + format[=fourcc] restrict the list of supported colorspaces to a single fourcc + (default 'yuy2', may be rgb12, bgr24, yv12 etc...) + pp[=flags] postprocessing filter (see \-pp option) + lavc fast software YV12\->MPEG1 conversion using libavcodec + fame fast software YV12\->MPEG1 conversion using libfame +.TP +.B \-x <x> (MPLAYER only) +Scale image to x width (if sw/hw scaling available). Disables aspect calcs. +.TP +.B \-xy <x> (MPLAYER only) + x<=8 Scale image by factor <x> + x>8 Set width to <x> and calculate height to keep correct aspect ratio +.TP +.B \-y <y> +Scale image to y height (if sw/hw scaling available). Disables aspect calcs. +.TP +.B \-zoom +Allow software scaling, where available. Could be used to force scaling with -vop scale +(-vop scale will IGNORE options -x/-y/-xy/-fs/-aspect without -zoom) + + +.SH "OSD/SUB OPTIONS" +.I NOTE: +See -vop expand too. +.TP +.B \-dumpmpsub (MPLAYER only) +Convert the given subtitle (specified with the \-sub switch) to MPlayer's +subtitle format, MPsub. Creates a dump.mpsub file in current directory. +.TP +.B \-ifo <vobsub\ ifo\ file> +Indicate the file that will be used to load palette and frame size for VOBSUB +subtitles. +.TP +.B \-ffactor <number> +Resample alphamap of the font. Can be: + + 0 plain white fonts + 0.75 very narrow black outline [default] + 1 narrow black outline + 10 bold black outline +.TP +.B \-font <path\ to\ font.desc\ file> +Search for the OSD/SUB fonts in an alternative directory (default: +~/.mplayer/font/font.desc). For example: + + \-font ~/.mplayer/arial\-14/font.desc +.TP +.B \-noautosub +Turns off automatic subtitles +.TP +.B \-osdlevel <0\-2> (MPLAYER only) +Specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer) +(default = 2) +.TP +.B \-sid <id> +Turns on DVD subtitle displaying. Also, you MUST specify a number which +corresponds to a DVD subtitle language (0\-31). For the list of available +subtitles, use with the \-v switch and look at the output. +.br +.I NOTE: +Use \-slang to define the subtitle language by name. +.TP +.B \-slang <subtitle\ language> +See the \-sid option, but this one needs a two\-letter parameter, a country code. +Like: \-slang hu,en will always select hungarian or if it's non existant then +english subtitles, if there are any. For the list of available subtitles, use +with the \-v switch and look at the output. +.TP +.B \-sub <subtitle\ file> +Use/display this subtitle file +.TP +.B \-subcp\ codepage +If your system supports iconv(3), you can use this option to +specify codepage of the subtitle. Examples: + + \-subcp latin2 + \-subcp cp1250 +.TP +.B \-sub\-demuxer <number> (BETA CODE) +Force subtitle demuxer type for \-subfile. +.TP +.B \-subdelay <sec> +Delays subtitles by <sec> seconds. Can be negative. +.TP +.B \-subfps <rate> +Specify frame/sec rate of subtitle file (float number) +(ONLY for frame\-based SUB files, i.e. NOT MicroDVD format!) +(default: the same fps as the movie) +.TP +.B \-subfile <filename> (BETA CODE) +Currently useless. Same as \-audiofile, but for subtitle streams. (OggDS?) +.TP +.B \-subpos <0 \- 100> (usefull with -vop expand) +Specify the position of subtitles on screen +.TP +.B \-unicode +Tells MPlayer to handle the subtitle file as UNICODE. +.TP +.B \-utf8 +Tells MPlayer to handle the subtitle file as UTF8. +.TP +.B \-vobsub <vobsub\ file\ without\ extention> +Specify the VobSub files that are to be used for subtitle. This is +the full pathname without extensions, i.e. without the ".idx", ".ifo" +or ".sub". +.TP +.B \-vobsubid <vobsub\ subtitle\ id> +Specify the VobSub subtitle id. Valid values range from 0 to 31. + + +.SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)" +.TP +.B \-abs <value> [OBSOLETE] +Override audio driver/card buffer size detection, -ao oss only +.TP +.B \-ao <driver>[:<device>] +Select audio output driver and optinaly device. "device" is valid with +SDL too, it means sub\-driver then (for example: \-vo sdl:esd). +If using OSS, you can specify which sound device to use like this: + + \-ao oss:/dev/dsp1 (replaces the old \-dsp option) + +You can get the list of available drivers executing +.I mplayer \-ao help +.TP +.B \-aofile <filename> +Filename for \-ao pcm. +.TP +.B \-aop <plugin1:plugin2:...> +Specify audio plugin(s) and their options (see documentation!!). +Available sub\-options are: + + list=[plugins] comma separated list of plugins + (resample, format, surround, format, volume, extrastereo, volnorm) + delay=<sec> example plugin, don't use! + format=<format> output format (format plugin only) + fout=<Hz> output frequency (resample plugin only) + volume=<0-255> volume (volume plugin only) + mul=<value> stereo coefficient, defaults to 1 (extrastereo plugin only) + softclip compressor/"soft\-clipping" capabilities (volume plugin only) +.TP +.B \-channels <n> +Select number of audio output channels to be used + + Stereo 2 + Surround 4 + Full 5.1 6 + +Currently this option is only honoured for AC3 audio, and/or the surround plugin. +.TP +.B \-delay <secs> +Audio delay in seconds (may be +/\- float value) +.TP +.B \-mixer <device> +This option will tell MPlayer to use a different device for mixing than +/dev/mixer. +.TP +.B \-nowaveheader (-ao pcm only) +Don't include wave header. Used for RAW PCM. + + +.SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)" +.TP +.B \-aa* +Used for \-vo aa. You can get a list and an explanation of available options executing +.I mplayer \-aahelp +.TP +.B \-blue_intensity <\-1000\ \-\ 1000> +Adjust intensity of blue component of video signal (default 0). +.TP +.B \-bpp <depth> +Use different color depth than autodetect. Not all \-vo drivers support +it (fbdev, dga2, svga, vesa). +.TP +.B \-brightness <\-1000\ \-\ 1000> +Adjust brightness of video output (default 0). It changes intensity of +RGB components of video signal from black to white screen. +.TP +.B \-contrast <\-1000\ \-\ 1000> +Adjust contrast of video output (default 0). Works in similar manner as brightness. +.TP +.B \-display <name> +Specify the hostname and display number of the X server you want +to display on. For example: \-display xtest.localdomain:0 +.TP +.B \-double +Enables doublebuffering. Fixes flicker by storing two frames in memory, and +displaying one while decoding another. Can effect OSD. Needs twice the memory +than a single buffer, so it won't work on cards with very few video memory. +.TP +.B \-dr +Turns on direct rendering (not supported by all codecs and video outputs) +(default is off). +.TP +.B \-fb <device> (FBdev or DirectFB only) +Specifies the framebuffer device to use. By default it uses /dev/fb0. +.TP +.B \-fbmode <modename> (FBdev only) +Change videomode to the one that is labelled as <modename> in /etc/fb.modes. +.br +.I NOTE: +VESA framebuffer doesn't support mode changing. +.TP +.B \-fbmodeconfig <filename> (FBdev only) +Use this config file instead of the default /etc/fb.modes. +Only valid for the fbdev driver. +.TP +.B \-forcexv (SDL only) +Force using XVideo +.TP +.B \-fs +Fullscreen playing (centers movie, and makes black +bands around it). Toggle it with the 'f' key (not all video +outputs support it). +.TP +.B \-fsmode <mode> +This option workarounds some problems when using specific windowmanagers and +fullscreen mode. If you experience fullscreen problems, try changing this +value between 0 and 7. + + \-fsmode 0 new method + \-fsmode 1 ICCCWM patch + (for KDE2/icewm) + \-fsmode 2 old method + \-fsmode 3 ICCCWM patch + plus Motif method +.TP +.B \-green_intensity <\-1000\ \-\ 1000> +Adjust intensity of green component of video signal (default 0). +.TP +.B \-hue <\-1000\ \-\ 1000> +Adjust hue of video signal (default 0). You can get colored negative +of image with this option. +.TP +.B \-jpeg <sub\-options> +Specify options for the JPEG output (-vo jpeg), separated by ":" (see documentation!). +Available sub\-options are [no]progressiv, [no]baseline, +optimize, smooth, quality and outdir. +.TP +.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (FBdev only) +Look into etc/example.conf for further information and in DOCS/video.html. +.TP +.B \-monitor_hfreq <horizontal frequency range> (FBdev only) +.TP +.B \-monitor_vfreq <vertical frequency range> (FBdev only) +.TP +.B \-monitoraspect <ratio> +Set aspect ratio of your screen. Examples: + + \-monitoraspect 4:3 or 1.3333 + \-monitoraspect 16:9 or 1.7777 +.TP +.B \-noslices +Disable drawing video by 16-pixel height slices/bands, instead draws the +while frame in a single run. May be faster or slower, depending on card/cache. +It has effect only with libmpeg2 and libavcodec codecs. +.TP +.B \-red_intensity <\-1000\ \-\ 1000> +Adjust intensity of red component of video signal (default 0). +.TP +.B \-saturation <\-1000\ \-\ 1000> +Adjust saturation of video output (default 0). You can get grayscale output +with this option. +.TP +.B \-rootwin +Play movie in the root window (desktop background) instead of opening +a new one. Works only with x11, xv, xmga, xvidix drivers. +.TP +.B \-screenw <pixels> \-screenh <pixels> +If you use an output driver which can't know the resolution of the screen +(fbdev/x11 and/or TVout) this is where you can specify the horizontal and vertical +resolution. +.TP +.B \-vm +Try to change to a better video mode. dga, x11/xv (XF86VidMode) and sdl +output drivers support it. +.TP +.B \-vo <driver>[:<device>] +Select video output driver and optinally device. "device" is valid with +SDL and GGI too, it means sub\-driver then (for example: \-vo sdl:aalib). + +You can get the list of available drivers executing +.I mplayer \-vo help +.TP +.B \-vsync +Enables VBI for vesa +.TP +.B \-wid <window\ id> +This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a +browser (with the plugger extension for instance) +.TP +.B \-xineramascreen <screen\ number> +In Xinerama configurations (i.e. a single desktop that spans across multiple +displays) this option tells MPlayer which screen to display movie on. Range 0 \- ... +.TP +.B \-z <0\-9> +Specifies compression level for PNG output (-vo png) + 0 no compression + 9 max compression +.TP +.B \-zr* +Used for \-vo zr. You can get a list and an explanation of available options executing +.I mplayer \-zrhelp + + +.SH "PLAYER OPTIONS (MPLAYER ONLY)" +.TP +.B \-autoq <quality> (use with -vop pp!) +Dynamically changes the level of postprocess, depending on spare CPU time +available. The number you specify will be the maximum level used. Usually you +can use some big number. You may not use together with \-pp but it's ok with +\-npp! +.TP +.B \-benchmark +Prints some statistics on CPU usage and dropped frames at the end. +Used in combination with \-nosound and \-vo null for benchmarking only video codec. +.TP +.B \-dapsync (OBSOLETE) +Use alternative A/V sync method. +.TP +.B \-framedrop (see \-hardframedrop option too!) +Frame dropping: decode all (except B) frames, video may skip. Usefull for playback on slow VGA card/bus. +.TP +.B \-gui (BETA CODE) +Start MPlayer in GUI mode. +.TP +.B \-h, \-\-help +Show short summary of options +.TP +.B \-hardframedrop +More intense frame dropping (breaks decoding). Leads to image disortion! +.TP +.B \-input <commands> +This option can be used to configure certain parts of the input system. +Relative path are relative to $HOME/.mplayer. + + conf=<file> read alternative input.conf. + If given without pathname, + $HOME/.mplayer is assumed. + ar\-delay delay in msec before we start + to autorepeat a key + (0 to disable) + ar\-rate how many keypress/second when + we autorepeat + keylist prints all keys that can be + bound to + cmdlist prints all commands that can + be bound + js\-dev specifies the joystick device + to use + (default is /dev/input/js0) + +.I NOTE: +Autorepeat is currently only supported by joysticks +.TP +.B \-lircconf <config\ file> +Specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc +.TP +.B \-loop <num> +Loops movie playback <num> times. 0 means forever +.TP +.B \-nojoystick +Turns off joystick support. Default is on, if compiled in +.TP +.B \-nolirc +Turns off lirc support +.TP +.B \-nortc +Turns off usage of /dev/rtc (real-time clock) +.TP +.B \-noskip +Don't skip frames +.TP +.B \-playlist <file> +Play files according to this filelist (1 file/row or Winamp or ASX format). +.TP +.B \-quiet +Display less output, status messages. +.TP +.B \-skin <skin\ directory> (BETA CODE) +Load skin from this directory (WITHOUT path name!). For example '\-skin fittyfene' tries these: + + /usr/local/share/mplayer/Skin/fittyfene + ~/.mplayer/Skin/fittyfene +.TP +.B \-slave +This option switches on slave mode. This is intended for use +of MPlayer as a backend to other programs. Instead of intercepting keyboard +events, MPlayer will read simplistic command lines from its stdin. +See section +.B SLAVE MODE PROTOCOL +For the syntax. +.TP +.B \-softsleep +Uses high quality software timers. Efficient as the RTC, doesn't need root, +but requires more CPU. +.TP +.B \-sstep <sec> +Specifies seconds between displayed frames. Usefull for slideshows. +.TP +.B \-use-stdin + + +.SH "ENCODING OPTIONS (MENCODER ONLY)" +.TP +.B \-divx4opts <options> +If encoding to DivX4, you can specify its parameters here, like: + + -divx4opts br=1800:deinterlace:key=250 + +Available options: + + help get help + br=<value> specify bitrate in + kbit <4\-16000> or + bit <16001\-24000000> + key=<value> maximum keyframe interval + (in frames) + deinterlace enable deinterlacing + (don't use, DivX4 is buggy!) + q=<1\-5> quality (1\-fastest, 5\-best) + min_quant=<0\-32> minimum quantizer + max_quant=<0\-32> maximum quantizer + rc_period=<value> rate control period + rc_reaction_period=<value> + rate control reaction period + rc_reaction_ratio=<value> + rate control reaction ratio + crispness=<0\-100> specify crispness/smoothness +.TP +.B \-endpos <time> +Stop encoding at given time. Can be specified in many was : + + -endpos 56 encode only 56 seconds + -endpos 01:10:00 encode only 1 hours + +Can be used in conjuction with -ss! +.TP +.B \-ffourcc fourcc +Can be used to override the video fourcc of the output file. For example -ffourcc +div3 will have the output file contain "div3" as video fourcc. +.TP +.B \-include <config\ file> +Specify config file to be parsed after the default +.TP +.B \-lameopts <options> +If encoding to MP3 with libmp3lame, you can specify its parameters here, like: + + -lameopts br=192:cbr + +Available options: + + help get help + vbr=<value> variable bitrate method + 0=cbr + 1=mt + 2=rh(default) + 3=abr + 4=mtrh + abr average bitrate + cbr constant bitrate + br=<value> specify bitrate in + kbit <0-1024> + (only for CBR and ABR) + q=<value> Quality + (0-highest, 9-low) + (for VBR) + aq=<value> ? + ratio=<value> compression ratio <1-100> + vol=<value> set audio input gain <0-10> + mode=<value> 0=stereo + 1=joint-stereo + 2=dualchannel + 3=mono + (default: auto) + padding=<value> 0=no + 1=all + 2=adjust +.TP +.B \-lavcopts <options> +If encoding with a codec from libavcodec, you can specify its parameters here, +like: + + -lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 + +Available options: + + help get help + + vcodec=<value> use the specified codec : + mjpeg - Motion JPEG + h263 - H263 + h263p - H263 Plus + mpeg4 - DivX 4/5 + msmpeg4 - DivX 3 + rv10 - an old RealVideo codec + mpeg1video - MPEG1 video :) + There's no default, you must + specify it. + + vbitrate=<value> specify bitrate in + kbit <4-16000> or + bit <16001-24000000> + (warning: 1kbit = 1000 bits) + default = 800k + + vratetol=<value> approximated *filesize* tolerance + in kbits. + (warning: 1kbit = 1000 bits) + default = 1024*8 kbits = 1MByte + + keyint=<value> interval between keyframes + (specify in frames, >300 are not + recommended) + default = 250 (one key frame every + ten seconds in a 25fps movie) + + vhq high quality mode, macro blocks + will be encoded multiple times and + the smallest will be used. + default = HQ disabled + + vme=<0\-5> motion estimation method : + 0 - no ME at all + 1 - ME_FULL + 2 - ME_LOG + 3 - ME_PHODS + 4 - ME_EPZS + 5 - ME_X1 + EPZS usually gives best results, + but you can try X1 too. FULL is + very slow and the others are + experimental. + default = EPZS + + vqcomp=<value> if the value is set to 1.0, the + quantizer will stay nearly + constant (high motion scenes will + look bad). If it's 0.0, the + quantizer will be changed + to make all frames approximately + equally sized (low motion scenes + will look bad). + default = 0.5 + + vqblur=<0\-1> blurs the quantizer graph over + time. + 0.0 : no blur + 1.0 : average all past + quantizers + default = 0.5 + + vqscale=<2\-31> gives each frame the same + quantizer (selects fixed quantizer + mode). + default = 0 (fixed quantizer mode + disabled) + + vrc_strategy=<0\-2> + different strategies to + decide which frames should get + which quantizer. + default = 2 + + v4mv 4 motion vectors per macroblock, + may gives you slightly better + quality, can only be used in HQ + mode and is buggy with B frames + currently. + default = disabled + + vpass=<1/2> select internal first pass + or second pass of 2-pass mode. + default = 0 (1-pass mode) + +The next 3 options apply only to I & P frames : + + vqmin=<1\-31> minimum quantizer, + default = 3 + + vqmax=<1\-31> maximum quantizer + default = 15 + + vqdiff=<1\-31> quantizer difference. + Limits the maximum quantizer + difference between frames. + default = 3 + +The following options apply only to B frames : + + vmax_b_frames=<0\-4> + maximum number of frames + between each I/P frame. + default = 0 (B-frames generation + disabled) + + vb_strategy=<value> + strategy to choose between + I/P/B frames : + 0 allways use max B + 1 avoid B frames in high + motion / scene change (can + lead to filesize miss + prediction) + default = 0 + + vb_qfactor=<value> + quantizer factor between b + and i/p frames (larger means + higher quantizer for b frames) + default = 2.0 + +In fixed quantizer mode you can use those options : + vqscale, vmax_b_frames, vhq, vme, keyint + +You can use the following options only in pass 1 of 2-pass mode or in 1-pass mode : + vqblur, vqdiff + +You can use the following options only in pass 2 of 2-pass mode : + vrc_strategy, vb_strategy + +All other options can be used in all modes. +.TP +.B \-o <filename> +Outputs to the given filename, instead of the default 'test.avi'. +.TP +.B \-oac <codec name> +Encode with the given codec (codec names are from codecs.conf, +use -ovc help to get a list of available codecs). +Examples: + + -oac copy no encoding, just streamcopy + -oac pcm encode to uncompressed PCM + -oac mp3lame encode to MP3 (using Lame) +.TP +.B \-ofps <fps> +The output file will have different frame/sec than the source. +You MUST set it for variable fps (asf, some mov) and progressive +(29.97fps telecined mpeg) files. +.TP +.B \-ovc <codec name> +Encode with the given codec (codec names are from codecs.conf, +use -ovc help to get a list of available codecs). +Examples: + + -ovc copy no encoding, just streamcopy + -ovc divx4 encode to DivX4/DivX5 or XviD + -ovc rawrgb encode to uncompressed RGB24 + -ovc lavc encode with a libavcodec codec +.TP +.B \-pass <1/2> +With this you can encode 2pass DivX4 files. First encode with -pass 1, then +with the same parameters, encode with -pass 2. +NOTE: for libavcodec 2-pass use -lavcopts vpass=1/2 instead of -pass 1/2 +.TP +.B \-passlogfile <filename> +When encoding in 2pass mode, MEncoder dumps first pass' informations +to the given file instead of the default divx2pass.log. +.TP +.B \-skiplimit <value> +Maximal skipable frames after non-skipped one +(-noskiplimit for unlimited number) +.TP +.B \-v, \-\-verbose +Enable verbose output (more \-v means more verbosity) + .SH "KEYBOARD CONTROL" .I NOTE: -Use the new input system to change the default keys (edit input.conf). -There is support for Joystick and LIRC too (see documentation). +MPlayer has a fully configurable, command driven, control layer +which allow you to control MPlayer using keyboard, mouse, joystick +or remote control (using lirc). +.B See documentation! +.br +.I NOTE: +The default config file for the input system is +$HOME/.mplayer/input.conf but it can be overrided +using the -input conf option. .br .I NOTE: These keys may/may not work, depending on your video output driver. -.TP +.TP .B general control <\- and \-> seek backward/forward 10 seconds .br @@ -790,7 +1090,12 @@ up and down seek backward/forward 1 minute .br pgup and pgdown seek backward/forward 10 minutes .br -< and > previous/next file +< and > backward/forward in playlist +.br +HOME and END go to next/previous playtree entry in + the parent list +.br +INS and DEL go to next/previous alternative source (asx playlist only) .br p / SPACE pause movie (press any key) .br @@ -820,8 +1125,10 @@ or \-vo xvidix or \-vc divxds (slow).) 5 and 6 adjust hue .br 7 and 8 adjust saturation -.TP +.TP .B GUI keyboard control +, and . previous / next file +.br gray \- and + decrease/increase volume .br ENTER start playing @@ -852,21 +1159,90 @@ M jump to main menu .br S select + .SH "SLAVE MODE PROTOCOL" If the \-slave switch is given, playback is controlled by a line\-based protocol. If the new input is enabled (default) each line must contain one command otherwise one of the following tokens: -.TP - stop pause playback +.TP +.B Commands .br -play resume playback .br -seek <num> continue at second NUM +seek <value> [type=<0/1>] + Seek to some place in the movie. + Type 0 is a relative seek of +/- + <value> seconds. Type 1 seek to + <value> % in the movie. + +audio_delay <value> + Adjust the audio delay of val seconds + +quit Quit MPlayer + +pause Pause/unpause the playback + +grap_frames Somebody know ? + +pt_step <value> [force=<value>] + Go to next/prev entry in playtree. + +pt_up_step <value> [force=<value>] + Like pt_step but it jump to next/prev + in the parent list. + +alt_src_step <value> + When more than one source is available + it select the next/previous one (only + supported by asx playlist). + +sub_delay <value> [abs=<value>] + Adjust the subtitles delay of +/- <value> + seconds or set it to <value> seconds when + abs is non zero. + +osd [level=<value>] + Toggle osd mode or set it to level when + level > 0. + +volume <dir> Increase/decrease volume + +contrast <value> [abs=<value>] .br -skip <num> skip NUM seconds (may be negative) +brightness <value> [abs=<value>] .br -quit exit MPlayer +hue <value> [abs=<value>] +.br +saturation <value> [abs=<value>] + Set/Adjust video paramters. + <value> range from -100 to 100. + +frame_drop [type=<value>] + Toggle/Set frame dropping mode. + +sub_pos <value> Adjust subtitles position. + +vo_fullscreen Switch fullscreen mode. + +tv_step_channel <dir> + Select next/previous tv channel. + +tv_step_norm Change TV norm. + +tv_step_chanlist + Change channel list. + +gui_loadfile +.br +gui_loadsubtitle +.br +gui_about +.br +gui_play +.br +gui_stop + GUI actions + .SH "FILES" .BR /etc/mplayer.conf\ \ \ \ \ @@ -876,7 +1252,7 @@ System\-wide settings User settings .br .BR ~/.mplayer/input.conf\ -Input bindings +Input bindings. See '\-input keylist' for full keylist! .br .BR ~/.mplayer/font/\ \ \ \ \ \ Font directory. There must be a font.desc file and files with .RAW extension. @@ -893,35 +1269,66 @@ Sub files are searched in this priority (for example /mnt/movie/movie.avi): .br ~/.mplayer/default.sub + .SH "EXAMPLES" +.TP .B Quickstart DVD playing mplayer \-dvd 1 -.TP +.TP .B Play only chapters 5, 6, 7 mplayer \-dvd 1 \-chapter 5\-7 -.TP +.TP .B Multiangle DVD playing mplayer \-dvd 1 \-dvdangle 2 -.TP +.TP .B Playing from a different DVD device mplayer \-dvd 1 \-dvd\-device /dev/dvd2 -.TP +.TP +.B Old style DVD (VOB) playing +mplayer \-dvdauth /dev/dvd /mnt/dvd/VIDEO_TS/VTS_02_4.VOB +.TP .B Stream from HTTP mplayer http://mplayer.hq/example.avi -.TP +.TP .B Convert subtitle to MPsub (to ./dump.mpsub) mplayer dummy.avi \-sub source.sub \-dumpmpsub .TP .B Input from standard V4L mplayer \-tv on: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 +.TP +.B Encoding DVD title #2, resizing to 640x480 +mencoder -dvd 2 -vop scale=640:480 -o title2.avi +.TP +.B Encoding DVD title #2, resizing to 512xHHH (keep aspect ratio) +mencoder -dvd 2 -vop scale -zoom -xy 512 -o title2.avi +.TP +.B The same, but with libavcodec family, MPEG4 (Divx5) compression +mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=1800 +.TP +.B Encoding all *.jpg files in the current dir +mencoder \*.jpg -mf on:fps=25 -o output.avi +.TP +.B Encoding from tuner (see documentation!) +mencoder -tv on:driver=v4l:width=640:height=480 -o tv.avi +.TP +.B Encoding from a pipe +rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- - +.TP +.B Encoding multiple *.vob files +cat *.vob | mencoder <options> - -.SH "BUGS" + +".SH "BUGS" Probably. PLEASE, double-check the documentation (especially bugreports.html), the FAQ and the mail archive before! Send your complete bugreports to the MPlayer-users mailing list at <mplayer-users@mplayerhq.hu>. We love complete bugreports :) + .SH "AUTHORS" Check documentation! @@ -931,6 +1338,11 @@ MPlayer is (C) 2000\-2002 This manpage is written and maintained by .I Gabucino <sendmail@to.mplayer\-users>. +(Patches done by +.I Jonas Jermann <sendmail@to.mplayer\-users> +) + + .SH "STANDARD DISCLAIMER" Use only at your own risk! There may be errors and inaccuracies that could be damaging to your system or your eye. Proceed with caution, and although