From b3a2573e777b66b93b089b6a35062273e18f6175 Mon Sep 17 00:00:00 2001 From: diego Date: Sun, 26 Sep 2004 14:58:57 +0000 Subject: man page review part X git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@13480 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/man/en/mplayer.1 | 117 +++++++++++++++++++++++++------------------------- 1 file changed, 59 insertions(+), 58 deletions(-) (limited to 'DOCS') diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1 index 42a385eda8..12d48838b4 100644 --- a/DOCS/man/en/mplayer.1 +++ b/DOCS/man/en/mplayer.1 @@ -3215,8 +3215,11 @@ grayscale only decoding (a bit faster than with color) .IPs "idct=<0\-99> (see \-lavcopts)" For best decoding quality use the same idct algorithm for decoding and encoding. This may come at a price in accuracy, though. -.IPs lowres= -Low resolution decode +.IPs lowres= +Decode at lower resolutions. +Low resolution decoding is not supported by all codecs, and it will +often result in ugly artifacts, this is not a bug, but a side effect +of not decoding at the full resolution. .RSss .br 0: disabled @@ -3227,9 +3230,6 @@ Low resolution decode .br 3: 1/8 resolution .REss -Low resolution decode isnt supported by all codecs, and it will often result in -ugly artefacts, this is not a bug but a sideeffect of not decoding at the full -resolution. .IPs "sb= (MPEG2 only)" Skip the given number of macroblock rows at the bottom. .IPs "st= (MPEG2 only)" @@ -4413,15 +4413,15 @@ Available modes are: .PD 0 .RSs .IPs 0 -odd frames into upper field, even to lower, generating a full-height -frame at half the framerate +Move odd frames into the upper field, even into the lower field, generating +a full-height frame at half framerate. .IPs 1 -only output odd frames, even frames are dropped, height unchanged +Only output odd frames, even frames are dropped; height unchanged. .IPs 2 -only output even frames, odd frames are dropped, height unchanged +Only output even frames, odd frames are dropped; height unchanged. .IPs 3 -expand each frame to full height, but pad alternate lines with black, -framerate unchanged +Expand each frame to full height, but pad alternate lines with black; +framerate unchanged. .RE .PD 1 . @@ -4436,13 +4436,13 @@ Available modes are: .PD 0 .RSs .IPs 0 -leave fields unchanged (this will jump/\:flicker) +Leave fields unchanged. (This will jump/\:flicker.) .IPs 1 -interpolate missing lines (the algorithm used might not be so good) +Interpolate missing lines. (The algorithm used might not be so good.) .IPs 2 -translate fields by 1/\:4 pixel with linear interp (no jump) +Translate fields by 1/4 pixel with linear interpolation (no jump). .IPs 4 -translate fields by 1/\:4 pixel with 4tap filter (higher quality) +Translate fields by 1/4 pixel with 4tap filter (higher quality). .RE .PD 1 . @@ -4463,33 +4463,32 @@ How often the filter should be applied. shape adaptive blur .PD 0 .RSs -.IPs rad\ \ \ +.IPs blur filter strength (~0.1\-4.0) (slower if larger) -.IPs pf\ \ \ +.IPs \ prefilter strength (~0.1\-2.0) -.IPs colorDiff -How different the pixels are allowed to be considered. -(~0.1\-100.0) +.IPs +maximum difference between pixels to still be considered (~0.1\-100.0) .RE .PD 1 . .TP -.B smartblur=rad:strength:thresh[:rad:strength:thresh] +.B smartblur=radius:strength:threshold[:radius:strength:threshold] smart blur .PD 0 .RSs -.IPs rad\ \ +.IPs blur filter strength (~0.1\-5.0) (slower if larger) -.IPs strength +.IPs blur (0.0\-1.0) or sharpen (-1.0\-0.0) -.IPs thresh +.IPs filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) .RE .PD 1 . .TP .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t -perspective correction +Correct the perspective of movies not filmed perpendicular to the screen. .PD 0 .RSs .IPs x0,y0,... @@ -4501,7 +4500,7 @@ linear (0) or cubic resampling (1) . .TP .B 2xsai\ \ -Use the 2x scale and interpolate algorithm for scaling and smoothing images. +Scale and smooth the image with the 2x scale and interpolate algorithm. . .TP .B 1bpp\ \ \ @@ -4520,15 +4519,17 @@ number of lines to select from the middle of the image (default: 12) .PD 1 . .TP -.B bmovl=hidden:opaque: -Read bitmaps from a FIFO and display them in a window. +.B bmovl=hidden:opaque:fifo +Reads bitmaps from a FIFO and displays them on top of the movie, +allowing some transformations on the image. +Also see TOOLS/bmovl-test.c for a small bmovl test program. .PD 0 .RSs -.IPs hidden -sets the default value of the 'hidden' flag (boolean) -.IPs opaque -flag switching between alphablended (transparent) and opaque (fast) mode -.IPs fifo\ +.IPs +Set the default value of the 'hidden' flag (0=visible, 1=hidden). +.IPs +Set the default value of the 'opaque' flag (0=transparent, 1=opaque). +.IPs path/\:filename for the FIFO (named pipe connecting mplayer \-vf bmovl to the controlling application) .RE @@ -4544,20 +4545,20 @@ followed by width*height*4 Bytes of raw RGBA32 data. .IPs "ABGR32 width height xpos ypos alpha clear" followed by width*height*4 Bytes of raw ABGR32 data. .IPs "RGB24 width height xpos ypos alpha clear" -followed by width*height*3 Bytes of raw RGB32 data. +followed by width*height*3 Bytes of raw RGB24 data. .IPs "BGR24 width height xpos ypos alpha clear" -followed by width*height*3 Bytes of raw BGR32 data. +followed by width*height*3 Bytes of raw BGR24 data. .IPs "ALPHA width height xpos ypos alpha" -change alpha for area +Change alpha transparency of the specified area. .IPs "CLEAR width height xpos ypos" -clear area +Clear area. .IPs OPAQUE -disable all alpha transparency. +Disable all alpha transparency. Send "ALPHA 0 0 0 0 0" to enable it again. .IPs HIDE\ -hide bitmap +Hide bitmap. .IPs SHOW\ -show bitmap +Show bitmap. .RE .PD 1 .sp 1 @@ -4567,9 +4568,9 @@ Arguments are: .PD 0 .RSs .IPs "width, height" -size of image/\:area +image/area size .IPs "xpos, ypos" -start blitting at X/\:Y position +Start blitting at position x/y. .IPs alpha Set alpha difference. If you set this to -255 you can then send a sequence of ALPHA-commands to set @@ -4577,15 +4578,15 @@ the area to -225, -200, -175 etc for a nice fade-in-effect! ;) .RSss 0: same as original .br -255: makes everything opaque +255: Make everything opaque. .br --255: makes everything transparent +-255: Make everything transparent. .REss .IPs clear -clear the framebuffer before blitting. +Clear the framebuffer before blitting. .RSss -0: The image will just be blitted on top of the old one, so you don't need to -send 1,8MB of RGBA32 data everytime a small part of the screen is updated. +0: The image will just be blitted on top of the old one, so you do not need to +send 1.8MB of RGBA32 data every time a small part of the screen is updated. .br 1: clear .REss @@ -4617,31 +4618,31 @@ If you give only the i then nothing is done to the frames, only I! is printed. . .TP -.B tile=xtile:ytile:output:start:delta +.B tile=xtiles:ytiles:output:start:delta Tile a series of images into a single, bigger image. If you omit a parameter or use a value less than 0, then the default value is used. -You can also stop when you're OK (... \-vf tile=10:5 ...). +You can also stop when you are satisfied (... \-vf tile=10:5 ...). It is probably a good idea to put the scale filter before the tile :-) .sp 1 The parameters are: .sp 1 .PD 0 .RSs -.IPs xtile +.IPs number of tiles on the x axis (default: 5) -.IPs ytile +.IPs number of tiles on the y axis (default: 5) -.IPs output +.IPs Render the tile when 'output' number of frames are reached, where 'output' should be a number less than xtile * ytile. Missing tiles are left blank. You could, for example, write an 8 * 7 tile every 50 frames to have one image every 2 seconds @ 25 fps. -.IPs start -pixel at the start (x/\:y) (default: 2) -.IPs delta -pixel between 2 tiles, (x/\:y) (default: 4) +.IPs +outer border thickness in pixels (default: 2) +.IPs +inner border thickness in pixels (default: 4) .RE .PD 1 . @@ -4654,9 +4655,9 @@ sometimes something even uglier appear \- your mileage may vary). .PD 0 .RSs .IPs x,y -Position of the top left corner of the logo. +logo top left corner position .IPs w,h -Width and height of the cleared rectangle. +cleared rectangle width and height .IPs t Thickness of the fuzzy edge of the rectangle (added to w and h). When set to -1, a green rectangle is drawn on the screen to -- cgit v1.2.3