diff options
author | jonas <jonas@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2003-03-22 12:02:27 +0000 |
---|---|---|
committer | jonas <jonas@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2003-03-22 12:02:27 +0000 |
commit | 169af37678fc9a229fb1a7eace20ed381fadd66c (patch) | |
tree | eda8c795685fd13e667204b9b31084506e9e4317 /DOCS/tech | |
parent | bb34e79aa6e60ae8493b712d407ff979559c8643 (diff) | |
download | mpv-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/TODO | 4 | ||||
-rw-r--r-- | DOCS/tech/encoding-tips.txt | 6 | ||||
-rw-r--r-- | DOCS/tech/general.txt | 2 | ||||
-rw-r--r-- | DOCS/tech/libmpcodecs.txt | 2 | ||||
-rw-r--r-- | DOCS/tech/swscaler_filters.txt | 4 | ||||
-rw-r--r-- | DOCS/tech/vop.txt | 70 | ||||
-rw-r--r-- | DOCS/tech/wishlist | 4 |
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 |