From 2f095b4652aed7fcd01134102311ad6a6def7801 Mon Sep 17 00:00:00 2001 From: diego Date: Mon, 24 Mar 2003 17:40:44 +0000 Subject: Spellchecked, slightly reworded, parts corrected. git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@9680 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/tech/vop.txt | 80 +++++++++++++++++++++++++++---------------------------- 1 file changed, 40 insertions(+), 40 deletions(-) (limited to 'DOCS') diff --git a/DOCS/tech/vop.txt b/DOCS/tech/vop.txt index 24ec06e707..b8a4894dcb 100644 --- a/DOCS/tech/vop.txt +++ b/DOCS/tech/vop.txt @@ -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 @@ Current plugins: 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 @@ Current plugins: 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 @@ Current plugins: -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 @@ Current plugins: 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 @@ Current plugins: _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=[[: