vf_tile & _framestep added

patch by danny <guru@digitalfantasy.it>


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@10749 b3059339-0415-0410-9bf9-f77b7e298cf2

1 files changed, 46 insertions, 0 deletions

diff --git a/DOCS/en/mplayer.1 b/DOCS/en/mplayer.1
index f8898849b3..c384177be4 100644
--- a/DOCS/en/mplayer.1
+++ b/DOCS/en/mplayer.1
@@ -2977,6 +2977,52 @@ send 1,8MB of RGBA32 data everytime a small part of the screen is updated.
 .REss
 .RE
 .PD 1
+.TP
+.B "framestep=I|[i]step"
+Filters only the Intra (Key) frame or one every step frmae.
+If you call the filter with I (uppercase) as the parameter then ONLY 
+the keyframes are outputted.
+For DVD it means, generally, one every 15/ 12  frames (IBBPBBPBBPBBPBB), 
+for avi it means every scene change or every keyint value (see -lavcopts 
+keyint= value if you use mencoder to encode the videos).
+
+When a key frame is found a I! followed by a cr is printed, leaving 
+the current line of mplayer/mencoder, where you got the time (in seconds) 
+and frame of the key (use this information to split the AVI).
+
+If you call the filter with a numeric parameter n then only one frame 
+every n is outputted.
+
+If you put a 'i' (lowercase) before the number then a I! is printed 
+(like the I parameter).
+
+If you put only the i then nothing is done on the frames, only the I! is 
+printed.
+.TP
+.B "tile=xtile:ytile:output:start:delta"
+Tile a serie of image in a single, bigger, image.
+
+The parameters are:
+.PD 0
+.RSs
+.IPs xtile
+number of tiles on the x axis (5)
+.IPs ytile
+number of tiles on the y axis (5)
+.IPs xytile
+when write the image, it can be different then xtile * ytile
+(for example you can write 8 * 7 tile, writing the file every
+50 frame, to have one image every 2 seconds @ 25 fps ).
+.IPs start  
+pixel at the start (x/y), default 2
+.IPs delta
+pixel between 2 tile, (x/y), default 4
+.RE
+.PD 1
+If you omit a parameter or put a value less then 0, the default is used.
+You can also stop when you're ok (... -vf tile=10:5 ...)
+
+Probably is good to put the scale filter before the tile :-)
 
 
 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"