Mercurial > mplayer.hg
changeset 9679:beebca423182
Spellchecked, slightly reworded, parts corrected.
| author | diego |
|---|---|
| date | Mon, 24 Mar 2003 17:40:44 +0000 |
| parents | 0f3fb772d8e3 |
| children | b5a95a489990 |
| files | DOCS/tech/vop.txt |
| diffstat | 1 files changed, 40 insertions(+), 40 deletions(-) [+] |
line wrap: on
line diff
--- a/DOCS/tech/vop.txt Mon Mar 24 17:35:48 2003 +0000 +++ b/DOCS/tech/vop.txt Mon Mar 24 17:40:44 2003 +0000 @@ -1,26 +1,26 @@ Video Filters ============= -video filters are plugin-like code modules implementing the interface -defined in vf.h +Video filters are plugin-like code modules implementing the interface +defined in vf.h. -basically it means video output manipulation, ie. these plugins can +Basically it means video output manipulation, i.e. these plugins can modify the image and the image properties (size, colorspace etc) between -the video decoders (vd.h) and output layer (libvo or video encoders) +the video decoders (vd.h) and the output layer (libvo or video encoders). -the actual API is a mixture of the video decoder (vd.h) and libvo +The actual API is a mixture of the video decoder (vd.h) and libvo (video_out.h) APIs. -the main differences: +main differences: - vf plugins may be "loaded" multiple times, with different parameters - and context - it's new in mplayer, old APIs weren't reentrant -- vf plugins don't have to implement all functions - all funcs has - 'fallback' version, so the plugins only override these if want -- each vf plugin has its own get_image context, and they can interchange + and context - it's new in MPlayer, old APIs weren't reentrant. +- vf plugins don't have to implement all functions - all functions have a + 'fallback' version, so the plugins only override these if wanted. +- Each vf plugin has its own get_image context, and they can interchange images/buffers using these get_image/put_image calls. API details: --- TO DO -- (see vf.h fpr API and vf_*.c for examples) +-- TO DO -- (see vf.h for API and vf_*.c for examples) Current plugins: ================ @@ -38,7 +38,7 @@ o (0=disable/1=enable SUB/OSD rendering) defaults (0) to disabled MPI: DR (if possible) or copy Special: mpcodecs core uses it to solve stride restrictions between filters - mencoder uses (autoload) it to render SUB/OSD + MEncoder uses (autoload) it to render SUB/OSD -vf flip Flips image upside-down (vertical mirroring) @@ -55,9 +55,9 @@ Draw a rectangle. Useful for testing crop plugin parameters. w,h (rectangle's width and height) defaults (-1) to maximum possible width while keeping the boundaries visible. - x,y (rectangle's top left corner position) defauts (-1) to upper + x,y (rectangle's top left corner position) defaults (-1) to upper left most position. - The plugin responds to the input.conf directive "change_control" + The plugin responds to the input.conf directive "change_rectangle" that takes two parameters. The first parameter can be 0 for w, 1 for h, 2 for x or 3 for y. The second parameter is the amount to change the designated rectangle boundary. @@ -71,8 +71,8 @@ -vf scale[=w:h[:c[:p]]] Software scaling (zoom) _and_ yuv<->rgb colorspace conversion w,h (new width/height after scaling) defaults to original width,height - note: if -zoom is used, and underlaying filters (including libvo) - uncapable of scaling, then it defaults to d_width/d_height ! + Note: If -zoom is used, and underlying filters (including libvo) are + incapable of scaling, then it defaults to d_width/d_height! note 2: w/h values -1 means original width/height, 0 means scaled d_width/d_height. -2/-3 means calculating w or h using the other dimension and the original (-3) or prescaled (-2) aspect ratio. @@ -81,16 +81,16 @@ 1 -> use only every 2. input line for chroma 2 -> use only every 4. input line for chroma 3 -> use only every 8. input line for chroma - p scaling parameter (depends upon the used scaling method) - for -sws 2 (bicubic) its sharpness (0 (soft) - 100 (sharp)) - for -sws 7 (gaussian) its sharpness (0 (soft) - 100 (sharp)) - for -sws 9 (lanczos) its filter length (1 - 10) + p scaling parameter (depends upon the scaling method used) + for -sws 2 (bicubic) it is sharpness (0 (soft) - 100 (sharp)) + for -sws 7 (gaussian) it is sharpness (0 (soft) - 100 (sharp)) + for -sws 9 (lanczos) it is filter length (1 - 10) MPI: TEMP, accepts stride Special: dec_video and mpcodecs core autoloads it for colorspace conv. -vf yuy2 Forced software YV12/I420 -> YUY2 conversion - (usefull for video cards/drivers with slow YV12 but fast YUY2 support) + (useful for video cards/drivers with slow YV12 but fast YUY2 support) MPI: TEMP, accepts stride -vf rgb2bgr[=swap] @@ -106,19 +106,19 @@ _restrict_ the list of supported colorspaces (query-format()) to a single, given fourcc. The 'fourcc' option defaults to 'yuy2', but may be any format name, like rgb15, bgr24, yv12 etc... - note again, it does NOT do any conversion, it just limits the _next_ - plugins format list. + Note again that it does NOT do any conversion, it just limits the format + list for the _next_ plugin. MPI: passthru -vf pp=[<filterName>[:<option>[:<option>...]][/[-]<filterName>[:<option>...]]...] - Postprocessing filter. (usefull for codecs without built-in + postprocessing filter. (useful for codecs without built-in postprocessing, like libmpeg12 or libavcodec) see `mplayer -vf pp=help` MPI: DR (if possible) or TEMP - Special: dec_video autoloads it if -pp option used but codec can't do pp. + Special: dec_video autoloads it if -pp option is used but codec can't do pp. -vf lavc[=quality:fps] - Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers + Fast software YV12->MPEG1 conversion, useful for DXR3/DVB drivers It uses libavcodec. Currently faster and better quality than -vf fame! Param quality: fixed qscale (1<=quality<32) or bitrate (32<=quality KBits) Param fps: force output fps (float value). If not give, or 0, it's @@ -126,7 +126,7 @@ MPI: EXPORT special -vf fame - Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers + Fast software YV12->MPEG1 conversion, useful for DXR3/DVB drivers It uses libfame. MPI: EXPORT special @@ -136,7 +136,7 @@ The 'aspect' parameter controls aspect ratio, it should be calculated as aspect=DVB_HEIGHT*ASPECTRATIO, default is 576*(4/3)=768 (for 16:9 TV set it to 576*(16/9)=1024) - It's only usefull together with expand+scale: + It's only useful together with expand+scale: -vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc MPI: passthru @@ -166,7 +166,7 @@ -vf eq[=brightness:contrast] software equalizer, for use with cards that don't support brightness and contrast controls in hardware. It might also be - useful with mencoder, either for fixing poorly captured movies, or + useful with MEncoder, either for fixing poorly captured movies, or for slightly reducing contrast to mask artifacts and get by with lower bitrates. Initial values in the range -100..100 may be given on the command line, and the eq filter is controllable @@ -183,11 +183,11 @@ -vf unsharp=l|cWxH:amount[:l|cWxH:amount] unsharp mask / gaussian blur. - l apply effect on luma component + l apply effect on luma components c apply effect on chroma components WxH width and height of the matrix, odd sized in both directions min = 3x3, max = 13x11 or 11x13 - usually you will use somthing between 3x3 and 7x7 + usually you will use something between 3x3 and 7x7 amount relative amount of sharpness / blur to add to the image amount < 0 = blur, amount > 0 = sharpen usually you will use something between -1.5 and 1.5 @@ -202,11 +202,11 @@ d deinterleave i interleave s swap fields (exchange even & odd lines) - The goal of this filter to add ability of processing interlaced images - pre-field without deinterlacing it. You can filter your interlaced dvd - and playback on TV without breaking the interlacing. - While deinterlacing (with the post processing filter) removes permamently - the interlacing (by smoothing averaging etc) deinterleaving splits the + 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. MPI: TEMP, accepts stride @@ -219,7 +219,7 @@ -vf sab=radius:prefilter:colorDiff[:radius:prefilter:colorDiff] radius blur filter strength (~0.1-4.0) (slower if larger) prefilter prefilter strength (~0.1-2.0) - colorDiff how different the pixels are allowed to be to be considered (~0.1-100.0) + colorDiff how different the pixels are allowed to be considered (~0.1-100.0) -vf smartblur=radius:stregth:threshold[:radius:stregth:threshold] radius blur filter strength (~0.1-5.0) (slower if larger) @@ -227,7 +227,7 @@ threshold 0 -> filter all, (0-30) -> filter flat areas, (-30-0) -> filter edges -vf perspective=x0:y0:x1:y1:x2:y2:x3:y3:t - x0,y0,... coordinates of the topleft, topright, bottomleft, bottomright corners + x0,y0,... coordinates of the top left, top right, bottom left, bottom right corners t 0-> linear, 1->cubic resampling -vf denoise3d=[luma:chroma:time] @@ -235,7 +235,7 @@ chroma spatial chroma strength (default = 3) time temporal strength (default = 6) This filter aims to reduce image noise producing smooth images and - making stills realy still. (it should enhance compressibility) + making still images really still. (it should enhance compressibility) Can be given from 0 to 3 parameters. Parameters not given will be - infered from the given ones. (ie: providing only one of them acts as an + inferred from the given ones. (i.e. providing only one of them acts as a "scale factor")