summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/vf.rst
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS/man/en/vf.rst')
-rw-r--r--DOCS/man/en/vf.rst652
1 files changed, 3 insertions, 649 deletions
diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst
index 434c2faec3..d46bd5bc06 100644
--- a/DOCS/man/en/vf.rst
+++ b/DOCS/man/en/vf.rst
@@ -217,17 +217,6 @@ dsize[=aspect|w:h:aspect-method:r]
<r>
Rounds up to make both width and height divisible by <r> (default: 1).
-yvu9
- Forces software YVU9 to YV12 colorspace conversion. Deprecated in favor of
- the software scaler.
-
-yuvcsp
- Clamps YUV color values to the CCIR 601 range without doing real
- conversion.
-
-palette
- RGB/BGR 8 -> 15/16/24/32bpp colorspace conversion using palette.
-
format[=fourcc[:outfourcc]]
Restricts the colorspace for the next filter without doing any conversion.
Use together with the scale filter for a real conversion.
@@ -391,132 +380,6 @@ pp[=filter1[:option1[:option2...]]/[-]filter2...]
Horizontal deblocking on luminance only, and switch vertical
deblocking on or off automatically depending on available CPU time.
-spp[=quality[:qp[:mode]]]
- Simple postprocessing filter that compresses and decompresses the image at
- several (or - in the case of quality level 6 - all) shifts and averages
- the results.
-
- <quality>
- 0-6 (default: 3)
-
- <qp>
- Force quantization parameter (default: 0, use QP from video).
-
- <mode>
-
- :0: hard thresholding (default)
- :1: soft thresholding (better deringing, but blurrier)
- :4: like 0, but also use B-frames' QP (may cause flicker)
- :5: like 1, but also use B-frames' QP (may cause flicker)
-
-uspp[=quality[:qp]]
- Ultra simple & slow postprocessing filter that compresses and decompresses
- the image at several (or - in the case of quality level 8 - all) shifts
- and averages the results.
-
- The way this differs from the behavior of spp is that uspp actually
- encodes & decodes each case with libavcodec Snow, whereas spp uses a
- simplified intra only 8x8 DCT similar to MJPEG.
-
- <quality>
- 0-8 (default: 3)
-
- <qp>
- Force quantization parameter (default: 0, use QP from video).
-
-fspp[=quality[:qp[:strength[:bframes]]]]
- faster version of the simple postprocessing filter
-
- <quality>
- 4-5 (equivalent to spp; default: 4)
-
- <qp>
- Force quantization parameter (default: 0, use QP from video).
-
- <-15-32>
- Filter strength, lower values mean more details but also more
- artifacts, while higher values make the image smoother but also
- blurrier (default: 0 - PSNR optimal).
-
- <bframes>
- 0: do not use QP from B-frames (default)
- 1: use QP from B-frames too (may cause flicker)
-
-pp7[=qp[:mode]]
- Variant of the spp filter, similar to spp=6 with 7 point DCT where only
- the center sample is used after IDCT.
-
- <qp>
- Force quantization parameter (default: 0, use QP from video).
-
- <mode>
- :0: hard thresholding
- :1: soft thresholding (better deringing, but blurrier)
- :2: medium thresholding (default, good results)
-
-qp=equation
- quantization parameter (QP) change filter
-
- <equation>
- some equation like ``2+2*sin(PI*qp)``
-
-geq=equation
- generic equation change filter
-
- <equation>
- Some equation, e.g. ``p(W-X\,Y)`` to flip the image horizontally. You
- can use whitespace to make the equation more readable. There are a
- couple of constants that can be used in the equation:
-
- :PI: the number pi
- :E: the number e
- :X / Y: the coordinates of the current sample
- :W / H: width and height of the image
- :SW / SH: width/height scale depending on the currently filtered plane,
- e.g. 1,1 and 0.5,0.5 for YUV 4:2:0.
- :p(x,y): returns the value of the pixel at location x/y of the current
- plane.
-
-test
- Generate various test patterns.
-
-rgbtest[=width:height]
- Generate an RGB test pattern useful for detecting RGB vs BGR issues. You
- should see a red, green and blue stripe from top to bottom.
-
- <width>
- Desired width of generated image (default: 0). 0 means width of input
- image.
-
- <height>
- Desired height of generated image (default: 0). 0 means height of
- input image.
-
-lavc[=quality:fps]
- Fast software YV12 to MPEG-1 conversion with libavcodec for use with
- DVB/DXR3/IVTV/V4L2.
-
- <quality>
- :1-31: fixed qscale
- :32-: fixed bitrate in kbits
-
- <fps>
- force output fps (float value) (default: 0, autodetect based on height)
-
-dvbscale[=aspect]
- Set up optimal scaling for DVB cards, scaling the x axis in hardware and
- calculating the y axis scaling in software to keep aspect. Only useful
- together with expand and scale.
-
- <aspect>
- Control aspect ratio, calculate as ``DVB_HEIGHT*ASPECTRATIO`` (default:
- ``576*4/3=768``), set it to ``576*(16/9)=1024`` for a 16:9 TV.
-
- *EXAMPLE*:
-
- ``--vf=dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc``
- FIXME: Explain what this does.
-
noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
Adds noise.
@@ -528,7 +391,7 @@ noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
:h: high quality (slightly better looking, slightly slower)
:p: mix random noise with a (semi)regular pattern
-denoise3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
+hqdn3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
This filter aims to reduce image noise producing smooth images and making
still images really still (This should enhance compressibility.).
@@ -542,36 +405,10 @@ denoise3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
chroma temporal strength (default:
``luma_tmp*chroma_spatial/luma_spatial``)
-hqdn3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
- High precision/quality version of the denoise3d filter. Parameters and
- usage are the same.
-
-ow[=depth[:luma_strength[:chroma_strength]]]
- Overcomplete Wavelet denoiser.
-
- <depth>
- Larger depth values will denoise lower frequency components more, but
- slow down filtering (default: 8).
- <luma_strength>
- luma strength (default: 1.0)
- <chroma_strength>
- chroma strength (default: 1.0)
-
-eq[=brightness:contrast] (OBSOLETE)
- Software equalizer with interactive controls just like the hardware
- equalizer, for cards/drivers that do not support brightness and contrast
- controls in hardware.
-
- <-100-100>
- initial brightness
- <-100-100>
- initial contrast
-
eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
- Alternative software equalizer that uses lookup tables (very slow),
+ Software equalizer that uses lookup tables (slow),
allowing gamma correction in addition to simple brightness and contrast
- adjustment. Note that it uses the same MMX optimized code as ``--vf=eq``
- if all gamma values are 1.0. The parameters are given as floating point
+ adjustment. The parameters are given as floating point
values.
<0.1-10>
@@ -595,31 +432,6 @@ eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
and just plain white. A value of 0.0 turns the gamma correction all
the way down while 1.0 leaves it at its full strength (default: 1.0).
-hue[=hue:saturation]
- Software equalizer with interactive controls just like the hardware
- equalizer, for cards/drivers that do not support hue and saturation
- controls in hardware.
-
- <-180-180>
- initial hue (default: 0.0)
- <-100-100>
- initial saturation, where negative values result in a negative chroma
- (default: 1.0)
-
-halfpack[=f]
- Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma
- but keeping all chroma samples. Useful for output to low-resolution
- display devices when hardware downscaling is poor quality or is not
- available. Can also be used as a primitive luma-only deinterlacer with
- very low CPU usage.
-
- <f>
- By default, halfpack averages pairs of lines when downsampling. Any
- value different from 0 or 1 gives the default (averaging) behavior.
-
- :0: Only use even lines when downsampling.
- :1: Only use odd lines when downsampling.
-
ilpack[=mode]
When interlaced video is stored in YUV 4:2:0 formats, chroma interlacing
does not line up properly due to vertical downsampling of the chroma
@@ -633,60 +445,6 @@ ilpack[=mode]
:0: nearest-neighbor sampling, fast but incorrect
:1: linear interpolation (default)
-decimate[=max:hi:lo:frac]
- Drops frames that do not differ greatly from the previous frame in order
- to reduce framerate. The main use of this filter is for very-low- bitrate
- encoding (e.g. streaming over dialup modem), but it could in theory be
- used for fixing movies that were inverse-telecined incorrectly.
-
- <max>
- Sets the maximum number of consecutive frames which can be dropped (if
- positive), or the minimum interval between dropped frames (if
- negative).
- <hi>,<lo>,<frac>
- A frame is a candidate for dropping if no 8x8 region differs by more
- than a threshold of <hi>, and if not more than <frac> portion (1
- meaning the whole image) differs by more than a threshold of <lo>.
- Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual
- pixel value differences, so a threshold of 64 corresponds to 1 unit of
- difference for each pixel, or the same spread out differently over the
- block.
-
-dint[=sense:level]
- The drop-deinterlace (dint) filter detects and drops the first from a set
- of interlaced video frames.
-
- <0.0-1.0>
- relative difference between neighboring pixels (default: 0.1)
- <0.0-1.0>
- What part of the image has to be detected as interlaced to drop the
- frame (default: 0.15).
-
-lavcdeint (OBSOLETE)
- FFmpeg deinterlacing filter, same as ``--vf=pp=fd``
-
-kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
- Donald Graft's adaptive kernel deinterlacer. Deinterlaces parts of a video
- if a configurable threshold is exceeded.
-
- <0-255>
- threshold (default: 10)
- <map>
- :0: Ignore pixels exceeding the threshold (default).
- :1: Paint pixels exceeding the threshold white.
-
- <order>
- :0: Leave fields alone (default).
- :1: Swap fields.
-
- <sharp>
- :0: Disable additional sharpening (default).
- :1: Enable additional sharpening.
-
- <twoway>
- :0: Disable twoway sharpening (default).
- :1: Enable twoway sharpening.
-
unsharp[=l|cWxH:amount[:l|cWxH:amount]]
unsharp mask / gaussian blur
@@ -710,81 +468,6 @@ unsharp[=l|cWxH:amount[:l|cWxH:amount]]
swapuv
Swap U & V plane.
-il[=d|i][s][:[d|i][s]]
- (De)interleaves lines. The goal of this filter is to add the ability to
- process interlaced images pre-field without deinterlacing them. You can
- filter your interlaced DVD and play it on a TV without breaking the
- interlacing. While deinterlacing (with the postprocessing filter) removes
- interlacing permanently (by smoothing, averaging, etc) deinterleaving
- splits the frame into 2 fields (so called half pictures), so you can
- process (filter) them independently and then re-interleave them.
-
- :d: deinterleave (placing one above the other)
- :i: interleave
- :s: swap fields (exchange even & odd lines)
-
-fil[=i|d]
- (De)interleaves lines. This filter is very similar to the il filter but
- much faster, the main disadvantage is that it does not always work.
- Especially if combined with other filters it may produce randomly messed
- up images, so be happy if it works but do not complain if it does not for
- your combination of filters.
-
- :d: Deinterleave fields, placing them side by side.
- :i: Interleave fields again (reversing the effect of fil=d).
-
-field[=n]
- Extracts a single field from an interlaced image using stride arithmetic
- to avoid wasting CPU time. The optional argument n specifies whether to
- extract the even or the odd field (depending on whether n is even or odd).
-
-detc[=var1=value1:var2=value2:...]
- Attempts to reverse the 'telecine' process to recover a clean,
- non-interlaced stream at film framerate. This was the first and most
- primitive inverse telecine filter to be added to MPlayer. It works by
- latching onto the telecine 3:2 pattern and following it as long as
- possible. This makes it suitable for perfectly-telecined material, even in
- the presence of a fair degree of noise, but it will fail in the presence
- of complex post-telecine edits. Development on this filter is no longer
- taking place, as ivtc, pullup, and filmdint are better for most
- applications. The following arguments (see syntax above) may be used to
- control detc's behavior:
-
- <dr>
- Set the frame dropping mode.
-
- :0: Do not drop frames to maintain fixed output framerate (default).
- :1: Always drop a frame when there have been no drops or telecine
- merges in the past 5 frames.
- :2: Always maintain exact 5:4 input to output frame ratio.
-
- <am>
- Analysis mode.
-
- :0: Fixed pattern with initial frame number specified by <fr>.
- :1: aggressive search for telecine pattern (default)
-
- <fr>
- Set initial frame number in sequence. 0-2 are the three clean
- progressive frames; 3 and 4 are the two interlaced frames. The
- default, -1, means 'not in telecine sequence'. The number specified
- here is the type for the imaginary previous frame before the movie
- starts.
-
- <t0>, <t1>, <t2>, <t3>
- Threshold values to be used in certain modes.
-
-ivtc[=1]
- Experimental 'stateless' inverse telecine filter. Rather than trying to
- lock on to a pattern like the detc filter does, ivtc makes its decisions
- independently for each frame. This will give much better results for
- material that has undergone heavy editing after telecine was applied, but
- as a result it is not as forgiving of noisy input, for example TV capture.
- The optional parameter (ivtc=1) corresponds to the dr=1 option for the
- detc filter, and should not be used with MPlayer. Further development on
- ivtc has stopped, as the pullup and filmdint filters appear to be much
- more accurate.
-
pullup[=jl:jr:jt:jb:sb:mp]
Third-generation pulldown reversal (inverse telecine) filter, capable of
handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001
@@ -818,75 +501,6 @@ pullup[=jl:jr:jt:jb:sb:mp]
video. The main purpose of setting mp to a chroma plane is to reduce
CPU load and make pullup usable in realtime on slow machines.
-filmdint[=options]
- Inverse telecine filter, similar to the pullup filter above. It is
- designed to handle any pulldown pattern, including mixed soft and hard
- telecine and limited support for movies that are slowed down or sped up
- from their original framerate for TV. Only the luma plane is used to find
- the frame breaks. If a field has no match, it is deinterlaced with simple
- linear approximation. If the source is MPEG-2, this must be the first
- filter to allow access to the field-flags set by the MPEG-2 decoder.
- Depending on the source MPEG, you may be fine ignoring this advice, as
- long as you do not see lots of "Bottom-first field" warnings. With no
- options it does normal inverse telecine. When this filter is used with
- MPlayer, it will result in an uneven framerate during playback, but it is
- still generally better than using pp=lb or no deinterlacing at all.
- Multiple options can be specified separated by /.
-
- crop=<w>:<h>:<x>:<y>
- Just like the crop filter, but faster, and works on mixed hard and
- soft telecined content as well as when y is not a multiple of 4. If x
- or y would require cropping fractional pixels from the chroma planes,
- the crop area is extended. This usually means that x and y must be
- even.
-
- io=<ifps>:<ofps>
- For each ifps input frames the filter will output ofps frames. This
- could be used to filter movies that are broadcast on TV at a frame
- rate different from their original framerate.
-
- luma_only=<n>
- If n is nonzero, the chroma plane is copied unchanged. This is useful
- for YV12 sampled TV, which discards one of the chroma fields.
-
- mmx2=<n>
- On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
- optimized functions, otherwise, use plain C. If this option is not
- specified, MMX2 and 3DNow! are auto-detected, use this option to
- override auto-detection.
-
- fast=<n>
- The larger n will speed up the filter at the expense of accuracy. The
- default value is n=3. If n is odd, a frame immediately following a
- frame marked with the REPEAT_FIRST_FIELD MPEG flag is assumed to be
- progressive, thus filter will not spend any time on soft-telecined
- MPEG-2 content. This is the only effect of this flag if MMX2 or 3DNow!
- is available. Without MMX2 and 3DNow, if n=0 or 1, the same
- calculations will be used as with n=2 or 3. If n=2 or 3, the number of
- luma levels used to find the frame breaks is reduced from 256 to 128,
- which results in a faster filter without losing much accuracy. If n=4
- or 5, a faster, but much less accurate metric will be used to find the
- frame breaks, which is more likely to misdetect high vertical detail
- as interlaced content.
-
- verbose=<n>
- If n is nonzero, print the detailed metrics for each frame. Useful for
- debugging.
-
- dint_thres=<n>
- Deinterlace threshold. Used during de-interlacing of unmatched frames.
- Larger value means less deinterlacing, use n=256 to completely turn
- off deinterlacing. Default is n=8.
-
- comb_thres=<n>
- Threshold for comparing a top and bottom fields. Defaults to 128.
-
- diff_thres=<n>
- Threshold to detect temporal change of a field. Default is 128.
-
- sad_thres=<n>
- Sum of Absolute Difference threshold, default is 64.
-
divtc[=options]
Inverse telecine for deinterlaced video. If 3:2-pulldown telecined video
has lost one of the fields or is deinterlaced using a method that keeps
@@ -1002,49 +616,6 @@ phase[=t|b|p|a|u|T|B|A|U][:v]
average squared difference between fields for t, b, and p
alternatives.
-telecine[=start]
- Apply 3:2 'telecine' process to increase framerate by 20%. This most
- likely will not work correctly with MPlayer. The optional start parameter
- tells the filter where in the telecine pattern to start (0-3).
-
-tinterlace[=mode]
- Temporal field interlacing - merge pairs of frames into an interlaced
- frame, halving the framerate. Even frames are moved into the upper field,
- odd frames to the lower field. This can be used to fully reverse the
- effect of the tfields filter (in mode 0). Available modes are:
-
- :0: Move odd frames into the upper field, even into the lower field,
- generating a full-height frame at half framerate.
- :1: Only output odd frames, even frames are dropped; height unchanged.
- :2: Only output even frames, odd frames are dropped; height unchanged.
- :3: Expand each frame to full height, but pad alternate lines with black;
- framerate unchanged.
- :4: Interleave even lines from even frames with odd lines from odd frames.
- Height unchanged at half framerate.
-
-tfields[=mode[:field_dominance]]
- Temporal field separation - split fields into frames, doubling the output
- framerate.
-
- <mode>
- :0: Leave fields unchanged (will jump/flicker).
- :1: Interpolate missing lines. (The algorithm used might not be so
- good.)
- :2: Translate fields by 1/4 pixel with linear interpolation (no jump).
- :4: Translate fields by 1/4 pixel with 4tap filter (higher quality)
- (default).
-
- <field_dominance> (DEPRECATED)
- :-1: auto (default) Only works if the decoder exports the appropriate
- information and no other filters which discard that information
- come before tfields in the filter chain, otherwise it falls back
- to 0 (top field first).
- :0: top field first
- :1: bottom field first
-
- *NOTE*: This option will possibly be removed in a future version. Use
- ``--field-dominance`` instead.
-
yadif=[mode[:field_dominance]]
Yet another deinterlacing filter
@@ -1060,66 +631,6 @@ yadif=[mode[:field_dominance]]
*NOTE*: This option will possibly be removed in a future version. Use
``--field-dominance`` instead.
-mcdeint=[mode[:parity[:qp]]]
- Motion compensating deinterlacer. It needs one field per frame as input
- and must thus be used together with tfields=1 or yadif=1/3 or equivalent.
-
- <mode>
- :0: fast
- :1: medium
- :2: slow, iterative motion estimation
- :3: extra slow, like 2 plus multiple reference frames
-
- <parity>
- 0 or 1 selects which field to use (note: no autodetection yet!).
-
- <qp>
- Higher values should result in a smoother motion vector field but less
- optimal individual vectors.
-
-boxblur=radius:power[:radius:power]
- box blur
-
- <radius>
- blur filter strength
- <power>
- number of filter applications
-
-sab=radius:pf:colorDiff[:radius:pf:colorDiff]
- shape adaptive blur
-
- <radius>
- blur filter strength (~0.1-4.0) (slower if larger)
- <pf>
- prefilter strength (~0.1-2.0)
- <colorDiff>
- maximum difference between pixels to still be considered (~0.1-100.0)
-
-smartblur=radius:strength:threshold[:radius:strength:threshold]
- smart blur
-
- <radius>
- blur filter strength (~0.1-5.0) (slower if larger)
- <strength>
- blur (0.0-1.0) or sharpen (-1.0-0.0)
- <threshold>
- filter all (0), filter flat areas (0-30) or filter edges (-30-0)
-
-perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
- Correct the perspective of movies not filmed perpendicular to the screen.
-
- <x0>,<y0>,...
- coordinates of the top left, top right, bottom left, bottom right
- corners
- <t>
- linear (0) or cubic resampling (1)
-
-2xsai
- Scale and smooth the image with the 2x scale and interpolate algorithm.
-
-1bpp
- 1bpp bitmap to YUV/BGR 8/15/16/32 conversion
-
down3dright[=lines]
Reposition and resize stereoscopic images. Extracts both stereo fields and
places them side by side, resizing them to maintain the original movie
@@ -1128,108 +639,6 @@ down3dright[=lines]
<lines>
number of lines to select from the middle of the image (default: 12)
-bmovl=hidden:opaque:fifo
- The bitmap overlay filter reads bitmaps from a FIFO and displays them on
- top of the movie, allowing some transformations on the image. See also
- ``TOOLS/bmovl-test.c`` for a small bmovl test program.
-
- <hidden>
- Set the default value of the 'hidden' flag (0=visible, 1=hidden).
- <opaque>
- Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
- <fifo>
- path/filename for the FIFO (named pipe connecting ``mplayer
- --vf=bmovl`` to the controlling application)
-
- FIFO commands are:
-
- RGBA32 width height xpos ypos alpha clear
- followed by width*height*4 Bytes of raw RGBA32 data.
- ABGR32 width height xpos ypos alpha clear
- followed by width*height*4 Bytes of raw ABGR32 data.
- RGB24 width height xpos ypos alpha clear
- followed by width*height*3 Bytes of raw RGB24 data.
- BGR24 width height xpos ypos alpha clear
- followed by width*height*3 Bytes of raw BGR24 data.
- ALPHA width height xpos ypos alpha
- Change alpha transparency of the specified area.
- CLEAR width height xpos ypos
- Clear area.
- OPAQUE
- Disable all alpha transparency. Send "ALPHA 0 0 0 0 0" to enable it
- again.
- HIDE
- Hide bitmap.
- SHOW
- Show bitmap.
-
- Arguments are:
-
- <width>, <height>
- image/area size
- <xpos>, <ypos>
- Start blitting at position x/y.
- <alpha>
- Set alpha difference. If you set this to -255 you can then send a
- sequence of ALPHA-commands to set the area to -225, -200, -175 etc for
- a nice fade-in-effect! ;)
-
- :0: same as original
- :255: Make everything opaque.
- :-255: Make everything transparent.
-
- <clear>
- Clear the framebuffer before blitting.
-
- :0: The image will just be blitted on top of the old one, so you do
- not need to send 1.8MB of RGBA32 data every time a small part of
- the screen is updated.
- :1: clear
-
-framestep=I|[i]step
- Renders only every nth frame or every intra frame (keyframe).
-
- If you call the filter with I (uppercase) as the parameter, then *only*
- keyframes are rendered. For DVDs it generally means one in every 15/12
- frames (IBBPBBPBBPBBPBB), for AVI it means every scene change or every
- keyint value.
-
- When a keyframe is found, an 'I!' string followed by a newline character
- is printed, leaving the current line of MPlayer output on the screen,
- because it contains the time (in seconds) and frame number of the keyframe
- (You can use this information to split the AVI.).
-
- If you call the filter with a numeric parameter 'step' then only one in
- every 'step' frames is rendered.
-
- If you put an 'i' (lowercase) before the number then an 'I!' is printed
- (like the I parameter).
-
- If you give only the i then nothing is done to the frames, only I! is
- printed.
-
-tile=xtiles:ytiles:output:start:delta
- Tile a series of images into a single, bigger image. If you omit a
- parameter or use a value less than 0, then the default value is used. You
- can also stop when you are satisfied (``... --vf=tile=10:5 ...``). It is
- probably a good idea to put the scale filter before the tile :-)
-
- The parameters are:
-
- <xtiles>
- number of tiles on the x axis (default: 5)
- <ytiles>
- number of tiles on the y axis (default: 5)
- <output>
- Render the tile when 'output' number of frames are reached, where
- 'output' should be a number less than xtile * ytile. Missing tiles are
- left blank. You could, for example, write an 8 * 7 tile every 50
- frames to have one image every 2 seconds @ 25 fps.
- <start>
- outer border thickness in pixels (default: 2)
- <delta>
- inner border thickness in pixels (default: 4)
-
delogo[=x:y:w:h:t]
Suppresses a TV station logo by a simple interpolation of the surrounding
pixels. Just set a rectangle covering the logo and watch it disappear (and
@@ -1248,15 +657,6 @@ delogo[=x:y:w:h:t]
must have a timestamp (in seconds, and in ascending order) and the
"x:y:w:h:t" coordinates (*t* can be omitted).
-remove-logo=/path/to/logo_bitmap_file_name.pgm
- Suppresses a TV station logo, using a PGM or PPM image file to determine
- which pixels comprise the logo. The width and height of the image file
- must match those of the video stream being processed. Uses the filter
- image and a circular blur algorithm to remove the logo.
-
- ``/path/to/logo_bitmap_file_name.pgm``
- [path] + filename of the filter image.
-
screenshot
Optional filter for screenshot support. This is only needed if the video
output doesn't provide working direct screenshot support. Note that it is
@@ -1275,19 +675,6 @@ ass
subtitle colors and video under the influence of the video equalizer
settings.
-blackframe[=amount:threshold]
- Detect frames that are (almost) completely black. Can be useful to detect
- chapter transitions or commercials. Output lines consist of the frame
- number of the detected frame, the percentage of blackness, the frame type
- and the frame number of the last encountered keyframe.
-
- <amount>
- Percentage of the pixels that have to be below the threshold (default:
- 98).
-
- <threshold>
- Threshold below which a pixel value is considered black (default: 32).
-
stereo3d[=in:out]
Stereo3d converts between different stereoscopic image formats.
@@ -1373,39 +760,6 @@ gradfun[=strength[:radius]]
gradients, but also prevents the filter from modifying pixels near
detailed regions (default: 16).
-fixpts[=options]
- Fixes the presentation timestamps (PTS) of the frames. By default, the PTS
- passed to the next filter is dropped, but the following options can change
- that:
-
- print
- Print the incoming PTS.
-
- fps=<fps>
- Specify a frame per second value.
-
- start=<pts>
- Specify an initial value for the PTS.
-
- autostart=<n>
- Uses the *n*\th incoming PTS as the initial PTS. All previous PTS are
- kept, so setting a huge value or -1 keeps the PTS intact.
-
- autofps=<n>
- Uses the *n*\th incoming PTS after the end of autostart to determine
- the framerate.
-
- *EXAMPLE*:
-
- ``--vf=fixpts=fps=24000/1001,ass,fixpts``
- Generates a new sequence of PTS, uses it for ASS subtitles, then drops
- it. Generating a new sequence is useful when the timestamps are reset
- during the program; this is frequent on DVDs. Dropping it may be
- necessary to avoid confusing encoders.
-
- *NOTE*: Using this filter together with any sort of seeking (including
- ``--ss``) may make demons fly out of your nose.
-
dlopen=dll[:a0[:a1[:a2[:a3]]]]
Loads an external library to filter the image. The library interface
is the vf_dlopen interface specified using libmpcodecs/vf_dlopen.h.