Mercurial > mplayer.hg
changeset 6601:e9fe6ba4e7ec
english language file removed
polish one coming right up
| author | gabucino |
|---|---|
| date | Sat, 29 Jun 2002 12:34:06 +0000 |
| parents | 1f0acc9106a8 |
| children | 6f69e03c3fb7 |
| files | DOCS/Polish/mplayer.1 |
| diffstat | 1 files changed, 0 insertions(+), 1380 deletions(-) [+] |
line wrap: on
line diff
--- a/DOCS/Polish/mplayer.1 Sat Jun 29 11:40:28 2002 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1380 +0,0 @@ -.\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users> -.\" 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-05" - -.SH "NAME" -mplayer \- Movie Player for Linux -.br -mencoder \- Movie Encoder for Linux - -.SH "SYNOPSIS" -.B mplayer -.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ] -.br -.B mplayer -.RB [global\ options]\ \fIfile1\fP\ [specific\ options]\ [file2]\ [specific\ options] -.br -.B mplayer -.RB [global\ options]\ {\fIgroup\ of\ files\ and\ options\fP}\ [group\ specific\ options] -.br -.B mplayer -.RB [dvd|vcd|tv]://[title]\ [options] -.br -.B mplayer -.RB [mms|http|http_proxy|rtp]://URL[:port]\ [options] -.br -.B mencoder -.RB [options]\ [\fIfile\fP\ |\ \fIURL\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 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!). - -Another big feature of mplayer is the wide range of supported output drivers. -It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use -GGI and SDL (and this way all their drivers) and some lowlevel card-specific drivers -(for Matrox G-series, 3Dfx Banshee/Voodoo3 and ATI cards) too! -.br -Most of them supports software or hardware scaling, so you can enjoy movies in fullscreen. -MPlayer supports displaying through some hardware MPEG decoder boards, such as the Siemens DVB and -DXR3/Hollywood+! - -Nice big antialiased shaded subtitles with european/ISO 8859-1,2 (hungarian, english, czech, -etc), cyrillic, korean fonts are supported (10 supported subtitle formats: MicroDVD, SubRip, -SubViewer, SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, VobSub, and our -own: MPsub). - -.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: -Use \-alang to define the language by name. -.TP -.B \-alang <audio\ stream\ language> -Usable 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 \-audio\-demuxer <number> -Force audio demuxer type for \-audiofile. -Give the demuxer ID as defined in demuxers.h. -You can use \-audio\-demuxer 17 to force .mp3 detection! -.TP -.B \-audiofile <filename> -Play audio from an external file (WAV, MP3 or OggVorbis) -.TP -.B \-cdrom\-device <path\ to\ device> -Override default CDROM drive name /dev/cdrom -.TP -.B \-cache <kbytes> -This option specifies how much memory (in kbytes) 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 -.B \-csslib <filename> -(old-style DVD option) This option is used to override the default location of libcss.so -.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 which file MPlayer should dump to. Should be used together -with \-dumpaudio/\-dumpvideo/\-dumpstream. -.TP -.B \-dumpstream (MPLAYER only) -Dumps the raw stream 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. 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> -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 -.B \-dvdauth <DVD\ device> -(old-style DVD option) Turns on DVD authentication using the given device. -.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 (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). -.TP -.B \-fps <value> -Override video frame rate (if value is wrong/missing in the header) (float number) -.TP -.B \-frames <number> -Play/convert only first <number> frames, then quit. -.TP -.B \-hr\-mp3\-seek (.MP3 only) -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 (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 \-ni (.AVI only) -Force usage of non\-interleaved AVI parser (fixes playing -of some bad AVI files). -.TP -.B \-nobps (.AVI only) -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 \-tv <option1:option2:...> -This option enables the TV grabbing feature of MPlayer (see documentation). -Available options are: - - on use TV input - noaudio no sound - driver=<value> available: dummy, v4l - device=<value> specify other device than the default /dev/video0 - input=<value> available: television, s-video, composite, etc - freq=<value> specify the frequency to set the tuner (e.g. 511.250) - outfmt=<value> output format of the tuner (rgb32, rgb24, yv12, uyvy, i420) - width=<value> the width of the output window - height=<value> the height of the output window - 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 \-vcd <track> -Play video cd track from device instead of plain file -.TP -.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 \-ac <codec name> -Force usage of a specific audio codec, according to its name in codecs.conf, -for example: - - \-ac mp3 use libmp3 MP3 codec - \-ac mp3acm use l3codeca.acm MP3 codec - \-ac ac3 use AC3 codec - \-ac hwac3 enable Hardware AC3 passthrough (see documentation) - \-ac vorbis use libvorbis - \-ac ffmp3 use ffmpeg's MP3 decoder (SLOW) - -See '\-ac help' for FULL list! -.TP -.B \-afm <1\-12> (OBSOLETE) -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 \-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 \-flip -Flip image upside-down -.TP -.B \-nosound -Don't play/encode sound -.TP -.B \-npp <option1,option2,...> -This option allows to give more litterate options for postprocessing, -and is another way of calling it (not with \-pp). -.br -NOTE: -npp only controls the external postprocess filter, and you HAVE TO -load it manually by '-vop pp', it is not auto-loaded! -.br -So, the usage: -vop pp -npp <options> - -.I EXAMPLE: - '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' - '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' - -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. - -.I EXAMPLE: - '\-npp de,\-al' means 'default filters without brightness/contrast correction' - -A ':' followed by a letter may be appended to the option to indicate its -scope: - a : automatically switches the filter off if the cpu is too slow - c : do chrominance filtering too - y : do not do chrominance filtering (that is only luminance filtering) - -Each filter defaults to 'c' (chrominance). - -.I EXAMPLE: - '\-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser' - '\-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!) -Apply postprocess filter on decoded image - -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 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! - -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 -above has the same effects but with letters. To have several filters at the -same time, simply add the hexadecimal values. - -.I EXAMPLE: -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 (deblocking filter - for DivX) -.TP -.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 \-stereo <mode> -Select type of MP2/MP3 stereo output. - - Stereo 0 - Left channel 1 - Right channel 2 -.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 \-vc <codec name> -Force usage of a specific video codec, according to its name in codecs.conf, -for example: - - \-vc divx use VFW DivX codec - \-vc divxds use DirectShow DivX codec - \-vc ffdivx use libavcodec's DivX codec - \-vc ffmpeg12 use libavcodec's MPEG1/2 codec - \-vc divx4 use ProjectMayo's DivX codec - -See '\-vc help' for FULL list! -.TP -.B \-vfm <1\-12> (OBSOLETE) -Force usage of a specific codec FAMILY, and FALLBACK to default if failed. -For example: - - \-vfm 2 use VFW (Win32) codecs - \-vfm 3 use OpenDivX/DivX4 codec (YV12) - (same as \-vc odivx but fallback) - \-vfm 4 use DirectShow (Win32) codecs - \-vfm 5 use libavcodec codecs - \-vfm 7 use DivX4 codec (YUY2) - (same as \-vc divx4 but fallback) - \-vfm 10 use XAnim codecs - -See \-vc help for FULL list! - -.I NOTE: -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[=options], plugin2, plugin1, ...> -Activate coma separated list of video filters (see documentation!). -Available plugins are: - - crop[=w:h:x:y] cropping - expand[=w:h:x:y:o] expanding and OSD - flip flips upside-down - mirror horizontal mirroring - rotate[=direction] rotate image - scale[=w:h] software scaling - yuy2 YV12/I420 \-> YUY2 - rgb2bgr[=swap] RGB 24/32 <\-> BGR 24/32 - palette RGB/BGR 8 \-> 15/16/24/32 bpp - format[=fourcc] restrict colorspace - pp[=flags] postprocessing (see \-pp) - lavc[=quality:fps] YV12\->MPEG1 (libavcodec) - fame YV12\->MPEG1 (libfame) - -.I parameters: -.br - w,h destination width/height - value : w/h = value - \-1 : w/h = original (default) - 0 : w/h = scaled (aspect) w/h - \-value : w/h = original+value - x,y x/y position of the sub-image - value : x/y = value - \-1 : x/y = center image (default) - o en/disable OSD/SUB rendering - 0 : disabled (default) - 1 : enabled - -.TP -.B \-x <x> (MPLAYER only) -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> (MPLAYER only) -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 optionaly 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 \-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=<1\-31> minimum quantizer - max_quant=<1\-31> 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|byte\ position> -Stop encoding at given time or byte position. Can be specified in many ways : - - -endpos 56 encode only 56 seconds - -endpos 01:10:00 encode only 1 hours - -endpos 100mb encode only 100 mbytes - -Can be used in conjuction with -ss or -sb! -.br -.I NOTE: -Byte position won't be accurate, as it can only stop at -a frame boundary. -.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 - - 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 \-noskip -Don't skip frames -.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: -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 -.B general control -<\- and \-> seek backward/forward 10 seconds -.br -up and down seek backward/forward 1 minute -.br -pgup and pgdown seek backward/forward 10 minutes -.br -< 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 -q / ESC stop playing and quit program -.br -+ and \- adjust audio delay by +/\- 0.1 second -.br -/ and * decrease/increase volume -.br -f toggle fullscreen -.br -o toggle OSD: none / seek / seek+timer -.br -d toggle frame dropping -.br -z and x adjust subtitle delay by +/\- 0.1 second -.br -r and t adjust subtitle position - -(The following keys are valid only when using \-vo xv or \-vo [vesa|fbdev]:vidix -or \-vo xvidix or \-vc divxds (slow).) - -1 and 2 adjust contrast -.br -3 and 4 adjust brightness -.br -5 and 6 adjust hue -.br -7 and 8 adjust saturation -.TP -.B GUI keyboard control -, and . previous / next file -.br -gray \- and + decrease/increase volume -.br -ENTER start playing -.br -s stop playing -.br -a about -.br -l load file -.br -b skin browser -.br -e toggle equalizer -.br -p toggle playlist -.TP -.B TV input control -h and l select previous/next channel -.br -n change norm -.br -b change channel list -.TP -.B DVDNAV input control -K,J,H,L browse up/down/left/right -.br -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 -.B Commands -.br -.br -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 -brightness <value> [abs=<value>] -.br -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\ \ \ \ \ -System\-wide settings -.br -.BR ~/.mplayer/config\ \ \ \ \ -User settings -.br -.BR ~/.mplayer/input.conf\ -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. -.br - -.I Subtitles -(utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA) -.br -Sub files are searched in this priority (for example /mnt/movie/movie.avi): -.br - /mnt/cdrom/movie.sub -.br - ~/.mplayer/sub/movie.sub -.br - ~/.mplayer/default.sub - - -.SH "EXAMPLES" -.TP -.B Quickstart DVD playing -mplayer \-dvd 1 -.TP -.B Play only chapters 5, 6, 7 -mplayer \-dvd 1 \-chapter 5\-7 -.TP -.B Multiangle DVD playing -mplayer \-dvd 1 \-dvdangle 2 -.TP -.B Playing from a different DVD device -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 -.TP -.B Stream from HTTP -mplayer http://mplayer.hq/example.avi -.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" -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>. - -(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 -this is highly unlikely, the author doesn't take any responsibility for that! -.\" end of file