|
5693
|
1 VideoOutPlugins - Video Filters
|
|
|
2 ===============
|
|
|
3
|
|
|
4 video filters are plugin-like code modules implementing the interface
|
|
|
5 defined in vf.h
|
|
|
6
|
|
|
7 basically it means video output manipulation, ie. these plugins can
|
|
|
8 modify the image and the image properties (size, colorspace etc) between
|
|
5695
|
9 the video decoders (vd.h) and output layer (libvo or video encoders)
|
|
5693
|
10
|
|
|
11 the actual API is a mixture of the video decoder (vd.h) and libvo
|
|
|
12 (video_out.h) APIs.
|
|
|
13
|
|
|
14 the main differences:
|
|
|
15 - vf plugins may be "loaded" multiple times, with different parameters
|
|
|
16 and context - it's new in mplayer, old APIs weren't reentrant
|
|
|
17 - vf plugins don't have to implement all functions - all funcs has
|
|
5695
|
18 'fallback' version, so the plugins only override these if want
|
|
5693
|
19 - each vf plugin has its own get_image context, and they can interchange
|
|
|
20 images/buffers using these get_image/put_image calls.
|
|
|
21
|
|
|
22 API details:
|
|
|
23 -- TO DO -- (see vf.h fpr API and vf_*.c for examples)
|
|
|
24
|
|
|
25 Current plugins:
|
|
|
26 ================
|
|
|
27
|
|
|
28 -vop crop[=w:h:x:y]
|
|
|
29 Simple cropping plugin.
|
|
|
30 w,h (cropped width,height) defaults to original width,height
|
|
|
31 x,y (position of cropped subimage on the original image) defaults to center
|
|
|
32 MPI: EXPORT only, using stride manipulation
|
|
5695
|
33
|
|
5693
|
34 -vop expand[=w:h:x:y:o]
|
|
|
35 Expanding _and_ (optional) OSD rendering plugin.
|
|
|
36 w,h (expanded width,height) defaults to original width,height
|
|
|
37 x,y (position of original image on the expanded image) defaults to center
|
|
|
38 o (0=disable/1=enable SUB/OSD rendering) defaults to 0
|
|
|
39 MPI: DR (if possible) or copy
|
|
|
40 Special: mpcodecs core uses it to solve stride restrictions between filters
|
|
|
41 mencoder uses (autoload) it to render SUB/OSD
|
|
5695
|
42
|
|
5693
|
43 -vop flip
|
|
5905
|
44 Flips image upside-down (vertical mirroring)
|
|
5693
|
45 No parameters.
|
|
|
46 MPI: DR (if possible) or EXPORT, using stride manipulation
|
|
|
47 Special: dec_video autoloads it when flipping is required and libvo can't do
|
|
|
48
|
|
5905
|
49 -vop mirror
|
|
|
50 Horizontal mirroring
|
|
|
51 No parameters.
|
|
|
52 MPI: TEMP
|
|
|
53
|
|
|
54 -vop rotate[=x]
|
|
5697
|
55 Rotate image +/- 90 degrees
|
|
5905
|
56 Optional 'x' parameter (0..3) controls horizontal and vertical mirroring
|
|
5697
|
57 MPI: TEMP
|
|
|
58
|
|
5693
|
59 -vop scale[=w:h]
|
|
|
60 Software scaling (zoom) _and_ yuv<->rgb colorspace conversion
|
|
|
61 w,h (new width/height after scaling) defaults to original width,height
|
|
|
62 note: if -zoom is used, and underlaying filters (including libvo)
|
|
|
63 uncapable of scaling, then it defaults to d_width/d_height !
|
|
|
64 MPI: TEMP, accepts stride
|
|
|
65 Special: dec_video and mpcodecs core autoloads it for colorspace conv.
|
|
|
66
|
|
|
67 -vop yuy2
|
|
|
68 Forced software YV12/I420 -> YUY2 conversion
|
|
|
69 (usefull for video cards/drivers with slow YV12 but fast YUY2 support)
|
|
|
70 MPI: TEMP, accepts stride
|
|
|
71
|
|
|
72 -vop rgb2bgr[=swap]
|
|
|
73 RGB 24/32 <-> BGR 24/32 colorspace conversion (default) or
|
|
|
74 RGB 24/32 <-> RGB 24/32 conversion with R<->B swapping ('swap' option)
|
|
|
75 MPI: TEMP, accepts stride
|
|
5905
|
76
|
|
|
77 -vop palette
|
|
|
78 RGB/BGR 8 -> RGB/BGR 15/16/24/32 colorspace conversion using palette
|
|
|
79 MPI: TEMP, accepts stride
|
|
5693
|
80
|
|
|
81 -vop format[=fourcc]
|
|
|
82 _restrict_ the list of supported colorspaces (query-format()) to a single,
|
|
|
83 given fourcc. The 'fourcc' option defaults to 'yuy2', but may be any
|
|
|
84 format name, like rgb15, bgr24, yv12 etc...
|
|
|
85 note again, it does NOT do any conversion, it just limits the _next_
|
|
|
86 plugins format list.
|
|
|
87 MPI: -
|
|
|
88
|
|
|
89 -vop pp[=flags]
|
|
|
90 Postprocessing filter. (usefull for codecs without built-in
|
|
|
91 postprocessing, like libmpeg12 or libavcodec)
|
|
|
92 Flags is a bitmask set of enabled filters (see manpage for -pp details),
|
|
|
93 defaults to the value of divx_quality (set by -pp commandline option)
|
|
|
94 MPI: DR (if possible) or TEMP
|
|
|
95 Special: dec_video autoloads it if -pp option used but codec can't do pp.
|
|
|
96
|
|
5905
|
97 -vop lavc
|
|
|
98 Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers
|
|
|
99 It uses libavcodec. Currently faster and better quality than -vop fame!
|
|
|
100 MPI: EXPORT special
|
|
|
101
|
|
5693
|
102 -vop fame
|
|
|
103 Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers
|
|
5905
|
104 It uses libfame.
|
|
5693
|
105 MPI: EXPORT special
|
|
|
106
|
