tile - FFmpeg 6.1.2 / Filters / Video

Tile several successive frames together.

The untile filter can do the reverse.

The filter accepts the following options:

layout: Set the grid size in the form COLUMNSxROWS. Range is upto UINT_MAX cells. Default is 6x5.
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. Range is 0 to 1024. Default is 0.
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. Range is 0 to 1024. Default is 0.
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. Default is 0.
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. Default is 0.

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 of 3x2 frames, with 7 pixels between them, and 2 pixels of initial margin, using mixed flat and named options:
```
tile=3x2:nb_frames=5:padding=7:margin=2
```