# HG changeset patch
# User diego
# Date 1048640182 0
# Node ID e60c24aa2b43dc04ac6c913b5e6a6cb79cdd74a5
# Parent  2e1bd9192ce21b4b603ab1a67a24ee745ab884d8
Merged into the man page and libmpcodecs.txt.

diff -r 2e1bd9192ce2 -r e60c24aa2b43 DOCS/tech/vop.txt
--- a/DOCS/tech/vop.txt	Wed Mar 26 00:53:15 2003 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,241 +0,0 @@
-Video Filters
-=============
-
-Video filters are plugin-like code modules implementing the interface
-defined in vf.h.
-
-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 the output layer (libvo or video encoders).
-
-The actual API is a mixture of the video decoder (vd.h) and libvo
-(video_out.h) APIs.
-
-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 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 for API and vf_*.c for examples)
-
-Current plugins:
-================
-
--vf crop[=w:h:x:y]
-    Simple cropping plugin.
-    w,h (cropped width,height) defaults to original width,height
-    x,y (position of cropped subimage on the original image) defaults to center
-    MPI: EXPORT only, using stride manipulation
-
--vf expand[=w:h:x:y:o]
-    Expanding _and_ (optional) OSD rendering plugin.
-    w,h (expanded width,height) defaults (-1) to original width,height
-    x,y (position of original image on the expanded image) defaults (-1) to center
-    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
-
--vf flip
-    Flips image upside-down (vertical mirroring)
-    No parameters.
-    MPI: DR (if possible) or EXPORT, using stride manipulation
-    Special: dec_video autoloads it when flipping is required and libvo can't do
-
--vf mirror
-    Horizontal mirroring
-    No parameters.
-    MPI: TEMP
-
--vf rectangle[=w:h:x:y]
-    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) defaults (-1) to upper
-        left most position.
-    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.
-    MPI: TEMP, accepts stride
-
--vf rotate[=x]
-    Rotate image +/- 90 degrees
-    Optional 'x' parameter (0..3) controls horizontal and vertical mirroring
-    MPI: TEMP
-
--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 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.
-    c   chroma skipping
-	0 -> use all available input lines for chroma
-	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 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
-    (useful for video cards/drivers with slow YV12 but fast YUY2 support)
-    MPI: TEMP, accepts stride
-
--vf rgb2bgr[=swap]
-    RGB 24/32 <-> BGR 24/32 colorspace conversion (default) or
-    RGB 24/32 <-> RGB 24/32 conversion with R<->B swapping ('swap' option)
-    MPI: TEMP, accepts stride
-
--vf palette
-    RGB/BGR 8 -> RGB/BGR 15/16/24/32 colorspace conversion using palette
-    MPI: TEMP, accepts stride
-    
--vf format[=fourcc]
-    _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 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.  (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 is used but codec can't do pp.
-
--vf lavc[=quality:fps]
-    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
-    autodetected based on height (240,480->29.97fps, others -> 25fps)
-    MPI: EXPORT special
-
--vf fame
-    Fast software YV12->MPEG1 conversion, useful for DXR3/DVB drivers
-    It uses libfame.
-    MPI: EXPORT special
-
--vf dvbscale[=aspect]
-    Setup scaling to the optimal values for the DVB card.
-    (use HW for X-scaling, calc sw Y scaling to keep aspect)
-    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 useful together with expand+scale:
-	-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc
-    MPI: passthru
-
--vf cropdetect[=limit]
-    It's a special filter, it doesn't alter the image itself, but detects
-    (using some kind of heuristics) the black borders/bands of the image,
-    and prints the optimal -vf crop= parameters to the stdout/console.
-    It calculates the average value of pixel luminances for a line, and
-    depending on the result it's either black band (result<=limit) or
-    picture (result>limit). Optional parameter 'limit' defaults to 24.
-    MPI: EXPORT
-
--vf test[=first frame number]
-    generate various test patterns
-    MPI: TEMP, accepts stride
-
--vf noise[=lumaNoise[u][t|a][h]:chromaNoise[u][t|a][h]
-    add noise
-    0<= lumaNoise, chromaNoise <=100
-    u uniform noise (gaussian otherwise)
-    t temporal noise (noise pattern changes between frames)
-    a averaged temporal (smoother, but a lot slower)
-    h high quality (slightly better looking, slightly slower)
-    p mix random noise with a (semi)regular pattern
-    MPI: DR (if possible) or TEMP, accepts stride
-
--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
-    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
-    interactively just like with normal hardware equalizer controls.
-
--vf eq2[=gamma:contrast:brightness:saturation:r_gamma:g_gamma:b_gamma]
-    advanced software equalizer, for use with cards that don't support
-    brightness/contrast/saturation and channel gamma controls in hardware.
-    Initial values in the range -2.0 .. 2.0 may be given on the command line,
-    and the eq2 filter is controllable interactively just like with normal
-    hardware equalizer controls or -vf eq. Defaults: 1:1:0:1:1:1:1
-    This filter uses MMX only if available and all gamma == 1.0, otherwise
-    LUT (look-up table) is being used.
-
--vf unsharp=l|cWxH:amount[:l|cWxH:amount]
-    unsharp mask / gaussian blur.
-        l   apply effect on luma component
-        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 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
-    MPI: DR (if possible) or TEMP, accepts stride
-
--vf swapuv
-    swap U & V plane
-    MPI: EXPORT
-    
--vf il=[d|i][s][:[d|i][s]]
-    (de)interleaves lines
-    d deinterleave
-    i interleave
-    s swap fields (exchange even & odd lines)
-    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
-
--vf boxblur=radius:power[:radius:power]
-    radius size of the filter
-    power  how often the filter should be applied
-    MPI: TEMP, accepts stride
-
--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 considered (~0.1-100.0)
-
--vf smartblur=radius:stregth:threshold[:radius:stregth:threshold]
-    radius	blur filter strength (~0.1-5.0) (slower if larger)
-    strength	(0.0-1.0) -> blur, (-1.0-0.0) -> sharpen
-    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 top left, top right, bottom left, bottom right corners
-    t		0-> linear, 1->cubic resampling
-
--vf denoise3d=[luma:chroma:time]
-    luma	spatial luma strength (default = 4)
-    chroma	spatial chroma strength (default = 3)
-    time	temporal strength (default = 6)
-    This filter aims to reduce image noise producing smooth images and
-    making still images really still. (it should enhance compressibility)
-    Can be given from 0 to 3 parameters. Parameters not given will be
-    inferred from the given ones. (i.e. providing only one of them acts as a
-    "scale factor")