Man / DECODING／FILTERING OPTIONS

DECODING／FILTERING OPTIONS †

−ac <[-|+]codec1,[-|+]codec2,...[,]> †

Specify a priority list of audio codecs to be used, according to their codec name in codecs.conf. Use a ’-’ before the codec name to omit it. Use a ’+’ before the codec name to force it, this will likely crash! If the list has a trailing ’,’ MPlayer will fall back on codecs not contained in the list. NOTE: See −ac help for a full list of available codecs.

EXAMPLE:

−ac mp3acm

Force the l3codeca.acm MP3 codec.

−ac mad,

Try libmad first, then fall back on others.

−ac hwac3,a52,

Try hardware AC3 passthrough, software AC3, then others.

−ac hwdts,

Try hardware DTS passthrough, then fall back on others.

−ac -ffmp3,

Skip FFmpeg’s MP3 decoder.

−af-adv <force=(0−7):list=(filters)> (also see −af) †

Specify advanced audio filter options:

force=<0−7>

Forces the insertion of audio filters to one of the following:

0: Use completely automatic filter insertion.
1: Optimize for accuracy (default).
2: Optimize for speed. Warning: Some features in the audio filters may silently fail, and the sound quality may drop.
3: Use no automatic insertion of filters and no optimization. Warning: It may be possible to crash MPlayer using this setting.
4: Use automatic insertion of filters according to 0 above, but use floating point processing when possible.
5: Use automatic insertion of filters according to 1 above, but use floating point processing when possible.
6: Use automatic insertion of filters according to 2 above, but use floating point processing when possible.
7: Use no automatic insertion of filters according to 3 above, and use floating point processing when possible.

list=<filters>

Same as −af.

−afm <driver1,driver2,...> †

Specify a priority list of audio codec families to be used, according to their codec name in codecs.conf. Falls back on the default codecs if none of the given codec families work.
NOTE: See −afm help for a full list of available codec families.

EXAMPLE:

−afm ffmpeg

Try FFmpeg’s libavcodec codecs first.

−afm acm,dshow

Try Win32 codecs first.

−aspect <ratio> (also see −zoom) †

Override movie aspect ratio, in case aspect information is incorrect or missing in the file being played.

EXAMPLE:

−aspect 4:3 or −aspect 1.3333

−aspect 16:9 or −aspect 1.7777

−noaspect †

Disable automatic movie aspect ratio compensation.

-field-dominance <-1-1> †

Set first field for interlaced content. Useful for deinterlacers that double the framerate: -vf tfields=1, -vf yadif=1 and -vo xvmc:bobdeint.

-1 auto (default): If the decoder does not export the appropriate information, it falls back to 0 (top field first).

0 top field first

1 bottom field first

−flip †

Flip image upside-down.

−lavdopts <option1:option2:...> (DEBUG CODE) †

Specify libavcodec decoding parameters. Separate multiple options with a colon.

EXAMPLE:

−lavdopts gray:skiploopfilter=all:skipframe=nonref

Available options are:

bitexact

Only use bit-exact algorithms in all decoding steps (for codec testing).

bug=<value>

Manually work around encoder bugs.

0: nothing
1: autodetect bugs (default)
2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX)
8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
16 (mpeg4): padding bug (autodetected)
32 (mpeg4): illegal vlc bug (autodetected per fourcc)
64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/version)
128 (mpeg4): old standard qpel (autodetected per fourcc/version)
256 (mpeg4): another qpel bug (autodetected per fourcc/version)
512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/version)
1024 (mpeg4): edge padding bug (autodetected per fourcc/version)

debug=<value>

Display debugging information.

0: disabled
1: picture info
2: rate control
4: bitstream
8: macroblock (MB) type
16: per-block quantization parameter (QP)
32: motion vector
0x0040: motion vector visualization (use −noslices)
0x0080: macroblock (MB) skip
0x0100: startcode
0x0200: PTS
0x0400: error resilience
0x0800: memory management control operations (H.264)
0x1000: bugs
0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
0x4000: Visualize block types.

ec=<value>

Set error concealment strategy.

1: Use strong deblock filter for damaged MBs.
2: iterative motion vector (MV) search (slow)
3: all (default)

er=<value>

Set error resilience strategy.

0: disabled
1: careful (Should work with broken encoders.)
2: normal (default) (Works with compliant encoders.)
3: aggressive (More checks, but might cause problems even for valid bitstreams.)
4: very aggressive

fast (MPEG-2 only)

Enable optimizations which do not comply to the specification and might potentially cause problems, like simpler dequantization, assuming use of the default quantization matrix, assuming YUV 4:2:0 and skipping a few checks to detect damaged bitstreams.

gray

grayscale only decoding (a bit faster than with color)

idct=<0−99> (see −lavcopts)

For best decoding quality use the same IDCT algorithm for decoding and encoding. This may come at a price in accuracy, though.

lowres=<number>[,<w>]

Decode at lower resolutions. Low resolution decoding is not supported by all codecs, and it will often result in ugly artifacts. This is not a bug, but a side effect of not decoding at full resolution.

0: disabled
1: 1/2 resolution
2: 1/4 resolution
3: 1/8 resolution

If <w> is specified lowres decoding will be used only if the width of the video is major than or equal to <w>.

sb=<number> (MPEG-2 only)

Skip the given number of macroblock rows at the bottom.

st=<number> (MPEG-2 only)

Skip the given number of macroblock rows at the top.

skiploopfilter=<skipvalue>

Skips the loop filter (AKA deblocking) during H.264 decoding. Since the filtered frame is supposed to be used as reference for decoding dependant frames this has a worse effect on quality than not doing deblocking on e.g. MPEG-2 video. But at least for high bitrate HDTV this provides a big speedup with no visible quality loss.

<skipvalue> can be either one of the following:

none: Never skip.
default: Skip useless processing steps (e.g. 0 size packets in AVI).
nonref: Skip frames that are not referenced (i.e. not used for decoding other frames, the error cannot "build up").
bidir: Skip B-Frames.
nonkey: Skip all frames except keyframes.
all: Skip all frames.

skipidct=<skipvalue>

Skips the IDCT step. This degrades quality a lot of in almost all cases (see skiploopfilter for available skip values).

skipframe=<skipvalue>

Skips decoding of frames completely. Big speedup, but jerky motion and sometimes bad artifacts (see skiploopfilter for available skip values).

threads=<1−8>

number of threads to use for decoding (default: 1)

vismv=<value>

Visualize motion vectors.

0: disabled
1: Visualize forward predicted MVs of P-frames.
2: Visualize forward predicted MVs of B-frames.
4: Visualize backward predicted MVs of B-frames.

vstats

Prints some statistics and stores them in ./vstats_*.log.

−noslices †

Disable drawing video by 16-pixel height slices/bands, instead draws the whole frame in a single run. May be faster or slower, depending on video card and available cache. It has effect only with libmpeg2 and libavcodec codecs.

−nosound †

音声を play/encode しない。ベンチマークに有用。

−novideo †

ビデオを play/encode しない。上手く動く事は少ないので代わりに −vc null −vo null を使う事。

−oldpp <quality> (OpenDivX only) (OBSOLETE) †

Use the OpenDivX postprocessing code instead of the internal one. Superseded by −pp, the internal postprocessing offers better quality and performance. The valid range of −oldpp values varies by codec, it is mostly 0−6, where 0=disable, 6=slowest/best.

−pp <quality> (also see −vf pp) †

Set the DLL postprocess level. This option is no longer usable with −vf pp. It only works with Win32 DirectShow DLLs with internal postprocessing routines. The valid range of −pp values varies by codec, it is mostly 0−6, where 0=disable, 6=slowest/best.

−pphelp (also see −vf pp) †

Show a summary about the available postprocess filters and their usage.

−ssf <mode> †

Specifies software scaler parameters.

EXAMPLE:

−vf scale −ssf lgb=3.0

lgb=<0−100>

gaussian blur filter (luma)

cgb=<0−100>

gaussian blur filter (chroma)

ls=<-100−100>

sharpen filter (luma)

cs=<-100−100>

sharpen filter (chroma)

chs=<h>

chroma horizontal shifting

cvs=<v>

chroma vertical shifting

−stereo <mode> †

Select type of MP2/MP3 stereo output.

0 stereo
1 left channel
2 right channel

−sws <software scaler type> (also see −vf scale and −zoom) †

−zoom オプションが使うソフトスケーリング・アルゴリズムの指定。 ハードウェアアクセラレーションの無いビデオ出力ドライバに作用する。例えばx11。

指定値は以下の通り:

0 fast bilinear
1 bilinear
2 bicubic (good quality) (default)
3 experimental
4 nearest neighbor (bad quality)
5 area
6 luma bicubic / chroma bilinear
7 gauss
8 sincR
9 lanczos
10 natural bicubic spline

NOTE: −sws オプションの中にはさらに調整できるものがある。詳細は scale video filter の説明を見る事。

−vc <[-|+]codec1,[-|+]codec2,...[,]> †

Specify a priority list of video codecs to be used, according to their codec name in codecs.conf. Use a ’-’ before the codec name to omit it. Use a ’+’ before the codec name to force it, this will likely crash! If the list has a trailing ’,’ MPlayer will fall back on codecs not contained in the list. NOTE: See −vc help for a full list of available codecs.

EXAMPLE:

−vc divx

Force Win32/VfW DivX codec, no fallback.

−vc divx4,

Try divx4linux codec first, then fall back on others.

−vc -divxds,-divx,

Skip Win32 DivX codecs.

−vc ffmpeg12,mpeg12,

Try libavcodec’s MPEG-1/2 codec, then libmpeg2, then others.

−vfm <driver1,driver2,...> †

使用するビデオコデック群の優先順位指定。名称はcodecs.confに記載のものに基づく。指定されたコデックがどれも動かなかった場合はデフォルトコデックを使う。
NOTE: 利用できるコデック群の全リストは −vfm help 参照。

EXAMPLE:

−vfm ffmpeg,dshow,vfw

まず libavcodec、ダメなら Directshow それでもダメなら VfW codec、 その他、の順に試行。

−vfm xanim

最初にXAnim codecを試行。

−x <x> (also see −zoom) (MPlayer only) †

Scale image to width <x> (if software/hardware scaling is available). Disables aspect calculations.

−xvidopts <option1:option2:...> †

Specify additional parameters when decoding with XviD. NOTE: Since libavcodec is faster than XviD you might want to use the libavcodec postprocessing filter (−vf pp) and decoder (−vfm ffmpeg) instead.

XviD’s internal postprocessing filters:

deblock-chroma

chroma deblock filter

deblock-luma

luma deblock filter

dering-luma

luma deringing filter

dering-chroma

chroma deringing filter

filmeffect

Adds artificial film grain to the video. May increase perceived quality, while lowering true quality.

rendering methods:

dr2

Activate direct rendering method 2.

nodr2

Deactivate direct rendering method 2.

−xy <value> (also see −zoom) †

value<=8

Scale image by factor <value>.

value>8

Set width to value and calculate height to keep correct aspect ratio.

−y <y> (also see −zoom) (MPlayer only) †

Scale image to height <y> (if software/hardware scaling is available). Disables aspect calculations.

-zoom †

Allow software scaling, where available. This will allow scaling with output drivers (like x11, fbdev) that do not support hardware scaling where MPlayer disables scaling by default for performance reasons.

可能な場合にソフトウェア・スケーリングを許可する。
MPlayerは、例えばx11やfbdevなどのハードウェア・スケーリングをサポートしていない出力ドライバではデフォルトでスケーリングを切る。パフォーマンスを稼ぐためだ。
こうした場合にスケーリングを許可するもの。

• slice -- 2007-04-03 (火) 05:57:23