[Mplayer-cvslog] CVS: 0_90/DOCS/tech vop.txt,1.28,1.29
Diego Biurrun CVS
diego at mplayerhq.hu
Mon Mar 24 18:38:21 CET 2003
Update of /cvsroot/mplayer/0_90/DOCS/tech
In directory mail:/var/tmp.root/cvs-serv28417/DOCS/tech
Modified Files:
vop.txt
Log Message:
Spellchecked, slightly reworded, parts corrected.
Index: vop.txt
===================================================================
RCS file: /cvsroot/mplayer/0_90/DOCS/tech/vop.txt,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- vop.txt 2 Feb 2003 02:14:42 -0000 1.28
+++ vop.txt 24 Mar 2003 17:38:19 -0000 1.29
@@ -1,26 +1,26 @@
VideoOutPlugins - 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
-vop 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 @@
-vop 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.
-vop 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
-vop 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
-vop 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 -vop 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.
-vop 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 -vop 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
-vop 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:
-vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale
MPI: passthru
@@ -166,7 +166,7 @@
-vop 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 @@
-vop 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 @@
-vop 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)
-vop 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
-vop 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
-vop 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")
More information about the MPlayer-cvslog
mailing list