Mercurial > mplayer.hg
annotate DOCS/tech/vop.txt @ 9302:e23939b2ac30
sync
author | gabucino |
---|---|
date | Thu, 06 Feb 2003 21:25:48 +0000 |
parents | efa14c62e5e6 |
children | 0fe056bdb135 |
rev | line source |
---|---|
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. | |
6004 | 36 w,h (expanded width,height) defaults (-1) to original width,height |
37 x,y (position of original image on the expanded image) defaults (-1) to center | |
38 o (0=disable/1=enable SUB/OSD rendering) defaults (0) to disabled | |
5693 | 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 | |
6821 | 54 -vop rectangle[=w:h:x:y] |
55 Draw a rectangle. Useful for testing crop plugin parameters. | |
56 w,h (rectangle's width and height) defaults (-1) to maximum | |
57 possible width while keeping the boundaries visible. | |
58 x,y (rectangle's top left corner position) defauts (-1) to upper | |
59 left most position. | |
6889 | 60 The plugin responds to the input.conf directive "change_control" |
61 that takes two parameters. The first parameter can be 0 for w, 1 | |
62 for h, 2 for x or 3 for y. The second parameter is the amount to | |
63 change the designated rectangle boundary. | |
64 MPI: TEMP, accepts stride | |
6821 | 65 |
5905 | 66 -vop rotate[=x] |
5697 | 67 Rotate image +/- 90 degrees |
5905 | 68 Optional 'x' parameter (0..3) controls horizontal and vertical mirroring |
5697 | 69 MPI: TEMP |
70 | |
6638 | 71 -vop scale[=w:h[:c[:p]]] |
5693 | 72 Software scaling (zoom) _and_ yuv<->rgb colorspace conversion |
73 w,h (new width/height after scaling) defaults to original width,height | |
74 note: if -zoom is used, and underlaying filters (including libvo) | |
75 uncapable of scaling, then it defaults to d_width/d_height ! | |
6004 | 76 note 2: w/h values -1 means original width/height, 0 means scaled |
6127 | 77 d_width/d_height. -2/-3 means calculating w or h using the other |
78 dimension and the original (-3) or prescaled (-2) aspect ratio. | |
6638 | 79 c chroma skipping |
80 0 -> use all available input lines for chroma | |
81 1 -> use only every 2. input line for chroma | |
82 2 -> use only every 4. input line for chroma | |
83 3 -> use only every 8. input line for chroma | |
84 p scaling parameter (depends upon the used scaling method) | |
85 for -sws 2 (bicubic) its sharpness (0 (soft) - 100 (sharp)) | |
86 for -sws 7 (gaussian) its sharpness (0 (soft) - 100 (sharp)) | |
87 for -sws 9 (lanczos) its filter length (1 - 10) | |
5693 | 88 MPI: TEMP, accepts stride |
89 Special: dec_video and mpcodecs core autoloads it for colorspace conv. | |
90 | |
91 -vop yuy2 | |
92 Forced software YV12/I420 -> YUY2 conversion | |
93 (usefull for video cards/drivers with slow YV12 but fast YUY2 support) | |
94 MPI: TEMP, accepts stride | |
95 | |
96 -vop rgb2bgr[=swap] | |
97 RGB 24/32 <-> BGR 24/32 colorspace conversion (default) or | |
98 RGB 24/32 <-> RGB 24/32 conversion with R<->B swapping ('swap' option) | |
99 MPI: TEMP, accepts stride | |
5905 | 100 |
101 -vop palette | |
102 RGB/BGR 8 -> RGB/BGR 15/16/24/32 colorspace conversion using palette | |
103 MPI: TEMP, accepts stride | |
5693 | 104 |
105 -vop format[=fourcc] | |
106 _restrict_ the list of supported colorspaces (query-format()) to a single, | |
107 given fourcc. The 'fourcc' option defaults to 'yuy2', but may be any | |
108 format name, like rgb15, bgr24, yv12 etc... | |
109 note again, it does NOT do any conversion, it just limits the _next_ | |
110 plugins format list. | |
6004 | 111 MPI: passthru |
5693 | 112 |
8076 | 113 -vop pp=[<filterName>[:<option>[:<option>...]][/[-]<filterName>[:<option>...]]...] |
5693 | 114 Postprocessing filter. (usefull for codecs without built-in |
115 postprocessing, like libmpeg12 or libavcodec) | |
8076 | 116 see `mplayer -vop pp=help` |
5693 | 117 MPI: DR (if possible) or TEMP |
118 Special: dec_video autoloads it if -pp option used but codec can't do pp. | |
119 | |
6020 | 120 -vop lavc[=quality:fps] |
5905 | 121 Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers |
122 It uses libavcodec. Currently faster and better quality than -vop fame! | |
6020 | 123 Param quality: fixed qscale (1<=quality<32) or bitrate (32<=quality KBits) |
124 Param fps: force output fps (float value). If not give, or 0, it's | |
125 autodetected based on height (240,480->29.97fps, others -> 25fps) | |
5905 | 126 MPI: EXPORT special |
127 | |
5693 | 128 -vop fame |
129 Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers | |
5905 | 130 It uses libfame. |
5693 | 131 MPI: EXPORT special |
132 | |
6004 | 133 -vop dvbscale[=aspect] |
134 Setup scaling to the optimal values for the DVB card. | |
135 (use HW for X-scaling, calc sw Y scaling to keep aspect) | |
136 The 'aspect' parameter controls aspect ratio, it should be calculated | |
137 as aspect=DVB_HEIGHT*ASPECTRATIO, default is 576*(4/3)=768 | |
138 (for 16:9 TV set it to 576*(16/9)=1024) | |
6062 | 139 It's only usefull together with expand+scale: |
6004 | 140 -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale |
141 MPI: passthru | |
142 | |
6808 | 143 -vop cropdetect[=limit] |
6062 | 144 It's a special filter, it doesn't alter the image itself, but detects |
145 (using some kind of heuristics) the black borders/bands of the image, | |
146 and prints the optimal -vop crop= parameters to the stdout/console. | |
6808 | 147 It calculates the average value of pixel luminances for a line, and |
148 depending on the result it's either black band (result<=limit) or | |
149 picture (result>limit). Optional parameter 'limit' defaults to 24. | |
6062 | 150 MPI: EXPORT |
6449 | 151 |
6426 | 152 -vop test[=first frame number] |
153 generate various test patterns | |
154 MPI: TEMP, accepts stride | |
155 | |
6963
76fee64d884a
film/average noise patch by (Jindrich Makovicka <makovick at KMLinux dot fjfi dot cvut dot cz>)
michael
parents:
6889
diff
changeset
|
156 -vop noise[=lumaNoise[u][t|a][h]:chromaNoise[u][t|a][h] |
6426 | 157 add noise |
158 0<= lumaNoise, chromaNoise <=100 | |
159 u uniform noise (gaussian otherwise) | |
160 t temporal noise (noise pattern changes between frames) | |
6963
76fee64d884a
film/average noise patch by (Jindrich Makovicka <makovick at KMLinux dot fjfi dot cvut dot cz>)
michael
parents:
6889
diff
changeset
|
161 a averaged temporal (smoother, but a lot slower) |
6449 | 162 h high quality (slightly better looking, slightly slower) |
6990
857bae3001e8
semi regular noise pattern patch by (Jindrich Makovicka <makovick at kmlinux dot fjfi dot cvut dot cz>)
michael
parents:
6963
diff
changeset
|
163 p mix random noise with a (semi)regular pattern |
6449 | 164 MPI: DR (if possible) or TEMP, accepts stride |
6426 | 165 |
7064 | 166 -vop eq[=brightness:contrast] |
167 software equalizer, for use with cards that don't support | |
168 brightness and contrast controls in hardware. It might also be | |
169 useful with mencoder, either for fixing poorly captured movies, or | |
170 for slightly reducing contrast to mask artifacts and get by with | |
171 lower bitrates. Initial values in the range -100..100 may be | |
172 given on the command line, and the eq filter is controllable | |
173 interactively just like with normal hardware equalizer controls. | |
174 | |
9214 | 175 -vop eq2[=gamma:contrast:brightness:saturation:r_gamma:g_gamma:b_gamma] |
176 advanced software equalizer, for use with cards that don't support | |
177 brightness/contrast/saturation and channel gamma controls in hardware. | |
178 Initial values in the range -2.0 .. 2.0 may be given on the command line, | |
179 and the eq2 filter is controllable interactively just like with normal | |
180 hardware equalizer controls or -vop eq. Defaults: 1:1:0:1:1:1:1 | |
181 This filter uses MMX only if available and all gamma == 1.0, otherwise | |
182 LUT (look-up table) is being used. | |
183 | |
7976 | 184 -vop unsharp=l|cWxH:amount[:l|cWxH:amount] |
185 unsharp mask / gaussian blur. | |
186 l apply effect on luma component | |
187 c apply effect on chroma components | |
188 WxH width and height of the matrix, odd sized in both directions | |
189 min = 3x3, max = 13x11 or 11x13 | |
190 usually you will use somthing between 3x3 and 7x7 | |
191 amount relative amount of sharpness / blur to add to the image | |
192 amount < 0 = blur, amount > 0 = sharpen | |
193 usually you will use something between -1.5 and 1.5 | |
194 MPI: DR (if possible) or TEMP, accepts stride | |
8005 | 195 |
196 -vop swapuv | |
197 swap U & V plane | |
198 MPI: EXPORT | |
199 | |
8006 | 200 -vop il=[d|i][s][:[d|i][s]] |
8005 | 201 (de)interleaves lines |
202 d deinterleave | |
203 i interleave | |
204 s swap fields (exchange even & odd lines) | |
8697 | 205 The goal of this filter to add ability of processing interlaced images |
206 pre-field without deinterlacing it. You can filter your interlaced dvd | |
207 and playback on TV without breaking the interlacing. | |
208 While deinterlacing (with the post processing filter) removes permamently | |
209 the interlacing (by smoothing averaging etc) deinterleaving splits the | |
210 frame into 2 fields (so called half pictures), so you can process (filter) | |
211 them independently and then re-interleave them. | |
8005 | 212 MPI: TEMP, accepts stride |
8010 | 213 |
214 -vop boxblur=radius:power[:radius:power] | |
215 radius size of the filter | |
216 power how often the filter should be applied | |
217 MPI: TEMP, accepts stride | |
8100 | 218 |
219 -vop sab=radius:prefilter:colorDiff[:radius:prefilter:colorDiff] | |
220 radius blur filter strength (~0.1-4.0) (slower if larger) | |
221 prefilter prefilter strength (~0.1-2.0) | |
222 colorDiff how different the pixels are allowed to be to be considered (~0.1-100.0) | |
8106 | 223 |
224 -vop smartblur=radius:stregth:threshold[:radius:stregth:threshold] | |
225 radius blur filter strength (~0.1-5.0) (slower if larger) | |
226 strength (0.0-1.0) -> blur, (-1.0-0.0) -> sharpen | |
227 threshold 0 -> filter all, (0-30) -> filter flat areas, (-30-0) -> filter edges | |
8112 | 228 |
229 -vop perspective=x0:y0:x1:y1:x2:y2:x3:y3:t | |
230 x0,y0,... coordinates of the topleft, topright, bottomleft, bottomright corners | |
231 t 0-> linear, 1->cubic resampling | |
9179
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
232 |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
233 -vop denoise3d=[luma:chroma:time] |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
234 luma spatial luma strength (default = 4) |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
235 chroma spatial chroma strength (default = 3) |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
236 time temporal strength (default = 6) |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
237 This filter aims to reduce image noise producing smooth images and |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
238 making stills realy still. (it should enhance compressibility) |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
239 Can be given from 0 to 3 parameters. Parameters not given will be |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
240 infered from the given ones. (ie: providing only one of them acts as an |
e93a0dd3ed56
new video filter: denoise3d - temporal&spatial noise reduction
arpi
parents:
8697
diff
changeset
|
241 "scale factor") |