Tile several successive frames together.
The filter accepts the following options:
- layout
-
Set the grid size (i.e. the number of lines and columns). For the syntax of this option, check the "Video size" section in the ffmpeg-utils manual.
- nb_frames
-
Set the maximum number of frames to render in the given area. It must be less than or equal to wxh. The default value is
0
, meaning all the area will be used. - margin
-
Set the outer border margin in pixels.
- padding
-
Set the inner border thickness (i.e. the number of pixels between frames). For more advanced padding options (such as having different values for the edges), refer to the pad video filter.
- color
-
Specify the color of the unused area. For the syntax of this option, check the "Color" section in the ffmpeg-utils manual. The default value of color is "black".
- overlap
-
Set the number of frames to overlap when tiling several successive frames together. The value must be between
0
and nb_frames - 1. - init_padding
-
Set the number of frames to initially be empty before displaying first output frame. This controls how soon will one get first output frame. The value must be between
0
and nb_frames - 1.
Examples
-
Produce 8x8 PNG tiles of all keyframes (-skip_frame nokey) in a movie:
ffmpeg -skip_frame nokey -i file.avi -vf 'scale=128:72,tile=8x8' -an -vsync 0 keyframes%03d.png
The -vsync 0 is necessary to prevent ffmpeg from duplicating each output frame to accommodate the originally detected frame rate.
-
Display
5
pictures in an area of3x2
frames, with7
pixels between them, and2
pixels of initial margin, using mixed flat and named options:tile=3x2:nb_frames=5:padding=7:margin=2