Add paddings to the input image, and places the original input at the given coordinates x, y.
It accepts the following parameters: width:height:x:y:color.
The parameters width, height, x, and y are expressions containing the following constants:
- in_w, in_h
-
the input video width and height
- iw, ih
-
same as in_w and in_h
- out_w, out_h
-
the output width and height, that is the size of the padded area as specified by the width and height expressions
- ow, oh
-
same as out_w and out_h
- x, y
-
x and y offsets as specified by the x and y expressions, or NAN if not yet specified
- a
-
same as iw / ih
- sar
-
input sample aspect ratio
- dar
-
input display aspect ratio, it is the same as (iw / ih) * sar
- hsub, vsub
-
horizontal and vertical chroma subsample values. For example for the pixel format "yuv422p" hsub is 2 and vsub is 1.
Follows the description of the accepted parameters.
- width, height
-
Specify the size of the output image with the paddings added. If the value for width or height is 0, the corresponding input size is used for the output.
The width expression can reference the value set by the height expression, and vice versa.
The default value of width and height is 0.
- x, y
-
Specify the offsets where to place the input image in the padded area with respect to the top/left border of the output image.
The x expression can reference the value set by the y expression, and vice versa.
The default value of x and y is 0.
- color
-
Specify the color of the padded area, it can be the name of a color (case insensitive match) or a 0xRRGGBB[AA] sequence.
The default value of color is "black".