diff --git a/DOCS/documentation.html b/DOCS/documentation.html index c3c2aaa85f..fcefbf224a 100644 --- a/DOCS/documentation.html +++ b/DOCS/documentation.html @@ -184,6 +184,22 @@
2.6. Video filters
+ + +2.6.1. Overview
+ +Both MPlayer and MEncoder supports using a universal + video filter layer, which comprises of numerous plugins - listed and + explained below. These plugins can perform various actions on the image, + such as rescale, crop black borders (useful not only for encoding but for + playing too, since black borders increase bus usage, and cropping these + can boost playing speed on slow boards), expand image (for SVCDs).
+ +With this filter layer it's possible to perform fast image format conversion
+ between the various RGB and YUV when neccessary. This enables for example
+ playing RGB data on xv
and xmga
outputs, amongst
+ others. (see the Scale filter)
The layer also does Direct Rendering between the plugins, to + maximize the speed. + +
Note that the postprocessing code is now also a part of the layer. It + will be explained below.
+ +2.6.2. Usage
+ + mplayer/mencoder -vop filter1,filter2,filter3,...
+
This sets up a filter pipeline (you can use any number of filters). Their + parameters are optional and if omitted, some of them are set to default + values, like x and y are both set to 0, and w and y will be + set to the movie's width and height.
+ +Filters are queued starting from libvo, so filter1
will be the
+ last called filter (after that libvo comes, or when using MEncoder,
+ encoding).
2.6.3. Crop
+ +Description:
+ +Crops the given part of the image, and discards the rest. Useful for + removing black bands of widescreen movies.
+ +Usage:
+ + -vop crop[=width:height:x:y]
2.6.4. Expand
+ +Description:
+ +Expands (NOT scales) movie resolution to the given value, and places the + unscaled original to x y. Can be used to add black bands, + this helps in creating SVCDs, or for using with the + SDL video output, which can place + subtitles in these bands.
+ +Usage:
+ + -vop expand[=width:height:x:y]
2.6.5. Fame
+ +Hmm, segfaulted. :)
+ + +2.6.6. Flip
+ +Description:
+ +Simply flips image. Useful for some old codecs which can output only + flipped image (these are autodetected).
+ +Usage:
+ + -vop flip
2.6.7. Format
+ +Description:
+ +This filter is NOT image format converter. It just forces the next filter + (or libvo) which image format to use. Useful for cards with slow YV12, like + tdfx and Savage4. For real conversion, use the Scale filter.
+ +Usage:
+ + -vop format[=format]
(where
+ format
can be for example: rgb32, yuy2, etc...)
2.6.8. Postprocess
+ +Description:
+ +This is our good old postprocess, juts converted to the filter layer.
+ Performs image quality enhancement, deinterlacing, etc, see
+ -npp help
for available options.
+
+
Usage:
+ + -vop pp[=postprocess options/keywords]
2.6.9. RGB2BGR
+ +Anything..
+ + +2.6.10. Rotate
+ +What are the parameters?
+ + +2.6.11. Scale
+ +Description:
+ +Scales the image with the software scaler (slow). You can adjust the
+ quality of the scaler with the -sws
option, see the manpage.
+ Nice quality implies speed loss.
NOTE: calling this filter with no options means colorspace + conversion! This is useful for codecs which can't output in the needed + format for the specified video output device. These are hopefully + autodetected and scale filter is called to convert. In other cases, you + can use it manually.
+ +Usage:
+ + -vop scale[=width:height]
2.6.12. VO
+ +WTF
+ +2.6.13. YUY2
+ +Biztos
+ + @@ -912,7 +1075,7 @@ Input from standard V4Lmplayer -vfm 5
), and options
written after filenames, that apply only to the given filename/URL/whatever
(for example mplayer -vfm 5 movie1.avi movie2.avi -vfm 4
).mplayer { 1.avi -loop 2 2.avi } -loop 3
will play files in this order: 1 1 2 1 1 2 1 1 2