summaryrefslogtreecommitdiffstats
path: root/DOCS/tech
diff options
context:
space:
mode:
authorjonas <jonas@b3059339-0415-0410-9bf9-f77b7e298cf2>2003-03-22 12:02:27 +0000
committerjonas <jonas@b3059339-0415-0410-9bf9-f77b7e298cf2>2003-03-22 12:02:27 +0000
commit169af37678fc9a229fb1a7eace20ed381fadd66c (patch)
treeeda8c795685fd13e667204b9b31084506e9e4317 /DOCS/tech
parentbb34e79aa6e60ae8493b712d407ff979559c8643 (diff)
downloadmpv-169af37678fc9a229fb1a7eace20ed381fadd66c.tar.bz2
mpv-169af37678fc9a229fb1a7eace20ed381fadd66c.tar.xz
vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@9645 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS/tech')
-rw-r--r--DOCS/tech/TODO4
-rw-r--r--DOCS/tech/encoding-tips.txt6
-rw-r--r--DOCS/tech/general.txt2
-rw-r--r--DOCS/tech/libmpcodecs.txt2
-rw-r--r--DOCS/tech/swscaler_filters.txt4
-rw-r--r--DOCS/tech/vop.txt70
-rw-r--r--DOCS/tech/wishlist4
7 files changed, 46 insertions, 46 deletions
diff --git a/DOCS/tech/TODO b/DOCS/tech/TODO
index b2da491ab4..b0ec7e4fb4 100644
--- a/DOCS/tech/TODO
+++ b/DOCS/tech/TODO
@@ -37,7 +37,7 @@ Post-0.90 / CVS CLEANUP work:
FOR THE NEXT RELEASE:
~~~~~~~~~~~~~~~~~~~~~~
-- fix vo_svga vs. -vop scale
+- fix vo_svga vs. -vf scale
- Re: [Mplayer-cvslog] CVS: main/libvo vo_vesa.c,1.82,1.83
This patch makes mplayer unusable in console mode, always leaves the
console in graphic mode.
@@ -48,7 +48,7 @@ FOR THE NEXT RELEASE:
- fix partial -dr + ffmpeg + B frames (different stride per frame)
- implementing 8bpp support in vo_x11.c
- remove SVQ1 from libmpcodecs
-- remove -vop yuy2, yvu9
+- remove -vf yuy2, yvu9
- cleanup qtaudio/qtvideo (move globals to context)
- cleanup DMO interfaces
- re-design makefile dependency system
diff --git a/DOCS/tech/encoding-tips.txt b/DOCS/tech/encoding-tips.txt
index fc1836f961..0f485fb977 100644
--- a/DOCS/tech/encoding-tips.txt
+++ b/DOCS/tech/encoding-tips.txt
@@ -55,7 +55,7 @@ typical mencoder line:
mencoder -dvd 1 -o /dev/null -oac copy -ovc lavc \
-lavcopts vcodec=mpeg4:vbitrate=1000:vhq:vqmin=2:\
vlelim=-4:vcelim=9:lumi_mask=0.05:dark_mask=0.01:vpass=1 \
- -vop scale=640:480,crop=716:572:2:2
+ -vf crop=716:572:2:2,scale=640:480
Phew, all those parameters! Which ones should I change? NEVER leave
out 'vhq'. Never ever. 'vqmin=2' is always good if you aim for sane
@@ -77,7 +77,7 @@ $bpp = -----------------------
I've attached a small Perl script that calculates the $bpp for
a movie. You'll have to give it four parameters:
-a) the cropped but unscaled resolution (use '-vop cropdetect'),
+a) the cropped but unscaled resolution (use '-vf cropdetect'),
b) the encoded aspect ratio. All DVDs come at 720x576 but contain
a flag that tells the player wether it should display the DVD at
an aspect ratio of 4/3 (1.333) or at 16/9 (1.777). Have a look
@@ -415,7 +415,7 @@ typically very "noisy", which doesn't help at all. Anyway :
> First pass:
> mencoder TITLE01-ANGLE1.VOB -oac copy -ovc lavc -lavcopts
> vcodec=mpeg4:vhq:vpass=1:vbitrate=800:keyint=48 -ofps 23.976 -npp lb
-> -ss 2:00 -endpos 0:30 -vop scale -zoom -xy 640 -o movie.avi
+> -ss 2:00 -endpos 0:30 -vf scale -zoom -xy 640 -o movie.avi
1) keyint=48 is way too low. The default value is 250, this is in *frames*
not seconds. Key frames are significantly larger than P or B frames, so the
diff --git a/DOCS/tech/general.txt b/DOCS/tech/general.txt
index 83c8879477..b1af99ecea 100644
--- a/DOCS/tech/general.txt
+++ b/DOCS/tech/general.txt
@@ -209,7 +209,7 @@ Now, go on:
ad_*.c - audio decoder (called through dec_audio.c)
vd_*.c - video decoder (called through dec_video.c)
ve_*.c - video encoder (used by mencoder)
- vf_*.c - video filter (see option -vop)
+ vf_*.c - video filter (see option -vf)
On this topic, see also:
libmpcodecs.txt - The structure of the codec-filter path, with explanation
diff --git a/DOCS/tech/libmpcodecs.txt b/DOCS/tech/libmpcodecs.txt
index 7eee092c93..c25ed5439c 100644
--- a/DOCS/tech/libmpcodecs.txt
+++ b/DOCS/tech/libmpcodecs.txt
@@ -214,7 +214,7 @@ Its parameters are already well-known from libvo:
d_width/d_height (display size) to preserve the correct aspect ratio!
Filters should not rely on d_width, d_height as input parameters,
the only exception is when a filter replaces some libvo functionality
- (like -vop scale with -zoom, or OSD rendering wiht -vop expand).
+ (like -vf scale with -zoom, or OSD rendering wiht -vf expand).
flags: the "good" old flags set of libvo:
0x01 - force fullscreen (-fs)
0x02 - allow mode switching (-vm)
diff --git a/DOCS/tech/swscaler_filters.txt b/DOCS/tech/swscaler_filters.txt
index 5b10f97350..6576372f0d 100644
--- a/DOCS/tech/swscaler_filters.txt
+++ b/DOCS/tech/swscaler_filters.txt
@@ -14,6 +14,6 @@ software scaler filter docs
-ssf ls=<float> -> luminance sharpen
simple sharpening filter
-note: these will only work if the swscaler is used at all (use -vop scale)
+note: these will only work if the swscaler is used at all (use -vf scale)
-example: mplayer foobar.avi -vop scale -ssf lgb=3.0
+example: mplayer foobar.avi -vf scale -ssf lgb=3.0
diff --git a/DOCS/tech/vop.txt b/DOCS/tech/vop.txt
index 270d56d492..24ec06e707 100644
--- a/DOCS/tech/vop.txt
+++ b/DOCS/tech/vop.txt
@@ -1,5 +1,5 @@
-VideoOutPlugins - Video Filters
-===============
+Video Filters
+=============
video filters are plugin-like code modules implementing the interface
defined in vf.h
@@ -25,13 +25,13 @@ API details:
Current plugins:
================
--vop crop[=w:h:x:y]
+-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
--vop expand[=w:h:x:y:o]
+-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
@@ -40,18 +40,18 @@ Current plugins:
Special: mpcodecs core uses it to solve stride restrictions between filters
mencoder uses (autoload) it to render SUB/OSD
--vop flip
+-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
--vop mirror
+-vf mirror
Horizontal mirroring
No parameters.
MPI: TEMP
--vop rectangle[=w:h:x:y]
+-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.
@@ -63,12 +63,12 @@ Current plugins:
change the designated rectangle boundary.
MPI: TEMP, accepts stride
--vop rotate[=x]
+-vf rotate[=x]
Rotate image +/- 90 degrees
Optional 'x' parameter (0..3) controls horizontal and vertical mirroring
MPI: TEMP
--vop scale[=w:h[:c[:p]]]
+-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)
@@ -88,21 +88,21 @@ Current plugins:
MPI: TEMP, accepts stride
Special: dec_video and mpcodecs core autoloads it for colorspace conv.
--vop yuy2
+-vf yuy2
Forced software YV12/I420 -> YUY2 conversion
(usefull for video cards/drivers with slow YV12 but fast YUY2 support)
MPI: TEMP, accepts stride
--vop rgb2bgr[=swap]
+-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
--vop palette
+-vf palette
RGB/BGR 8 -> RGB/BGR 15/16/24/32 colorspace conversion using palette
MPI: TEMP, accepts stride
--vop format[=fourcc]
+-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...
@@ -110,50 +110,50 @@ Current plugins:
plugins format list.
MPI: passthru
--vop pp=[<filterName>[:<option>[:<option>...]][/[-]<filterName>[:<option>...]]...]
+-vf pp=[<filterName>[:<option>[:<option>...]][/[-]<filterName>[:<option>...]]...]
Postprocessing filter. (usefull for codecs without built-in
postprocessing, like libmpeg12 or libavcodec)
- see `mplayer -vop pp=help`
+ 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.
--vop lavc[=quality:fps]
+-vf lavc[=quality:fps]
Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers
- It uses libavcodec. Currently faster and better quality than -vop fame!
+ 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
--vop fame
+-vf fame
Fast software YV12->MPEG1 conversion, usefull for dxr3/dvb drivers
It uses libfame.
MPI: EXPORT special
--vop dvbscale[=aspect]
+-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 usefull together with expand+scale:
- -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale
+ -vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc
MPI: passthru
--vop cropdetect[=limit]
+-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 -vop crop= parameters to the stdout/console.
+ 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
--vop test[=first frame number]
+-vf test[=first frame number]
generate various test patterns
MPI: TEMP, accepts stride
--vop noise[=lumaNoise[u][t|a][h]:chromaNoise[u][t|a][h]
+-vf noise[=lumaNoise[u][t|a][h]:chromaNoise[u][t|a][h]
add noise
0<= lumaNoise, chromaNoise <=100
u uniform noise (gaussian otherwise)
@@ -163,7 +163,7 @@ Current plugins:
p mix random noise with a (semi)regular pattern
MPI: DR (if possible) or TEMP, accepts stride
--vop eq[=brightness:contrast]
+-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
@@ -172,16 +172,16 @@ Current plugins:
given on the command line, and the eq filter is controllable
interactively just like with normal hardware equalizer controls.
--vop eq2[=gamma:contrast:brightness:saturation:r_gamma:g_gamma:b_gamma]
+-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 -vop eq. Defaults: 1:1:0:1:1:1:1
+ 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.
--vop unsharp=l|cWxH:amount[:l|cWxH:amount]
+-vf unsharp=l|cWxH:amount[:l|cWxH:amount]
unsharp mask / gaussian blur.
l apply effect on luma component
c apply effect on chroma components
@@ -193,11 +193,11 @@ Current plugins:
usually you will use something between -1.5 and 1.5
MPI: DR (if possible) or TEMP, accepts stride
--vop swapuv
+-vf swapuv
swap U & V plane
MPI: EXPORT
--vop il=[d|i][s][:[d|i][s]]
+-vf il=[d|i][s][:[d|i][s]]
(de)interleaves lines
d deinterleave
i interleave
@@ -211,26 +211,26 @@ Current plugins:
them independently and then re-interleave them.
MPI: TEMP, accepts stride
--vop boxblur=radius:power[:radius:power]
+-vf boxblur=radius:power[:radius:power]
radius size of the filter
power how often the filter should be applied
MPI: TEMP, accepts stride
--vop sab=radius:prefilter:colorDiff[:radius:prefilter:colorDiff]
+-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)
--vop smartblur=radius:stregth:threshold[:radius:stregth:threshold]
+-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
--vop perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
+-vf perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
x0,y0,... coordinates of the topleft, topright, bottomleft, bottomright corners
t 0-> linear, 1->cubic resampling
--vop denoise3d=[luma:chroma:time]
+-vf denoise3d=[luma:chroma:time]
luma spatial luma strength (default = 4)
chroma spatial chroma strength (default = 3)
time temporal strength (default = 6)
diff --git a/DOCS/tech/wishlist b/DOCS/tech/wishlist
index 2bfb0850c0..7e9c04ffad 100644
--- a/DOCS/tech/wishlist
+++ b/DOCS/tech/wishlist
@@ -35,7 +35,7 @@ Small improvements:
* accept -dvd 9-12 command line
* specify suboptions in a config file without breaking playback (use
- channel 21 if using -tv, same idea for -vop, -aop, etc...)
+ channel 21 if using -tv, same idea for -vf, -af, etc...)
Cleanup:
@@ -77,7 +77,7 @@ Enhancements:
* SSA style & colors handling
- * plugin structure for vop/aop
+ * plugin structure for vf/af
* support for VirtualDub and Winamp plugins