Scale (resize) the input video, using the z.lib library: https://github.com/sekrit-twc/zimg.
The zscale filter forces the output display aspect ratio to be the same as the input, by changing the output sample aspect ratio.
If the input image format is different from the format requested by the next filter, the zscale filter will convert the input to the requested format.
Options
The filter accepts the following options.
- width, w, height, h
-
Set the output video dimension expression. Default value is the input dimension.
If the width or w is 0, the input width is used for the output. If the height or h is 0, the input height is used for the output.
If one of the values is -1, the zscale filter will use a value that maintains the aspect ratio of the input image, calculated from the other specified dimension. If both of them are -1, the input size is used
If one of the values is -n with n > 1, the zscale filter will also use a value that maintains the aspect ratio of the input image, calculated from the other specified dimension. After that it will, however, make sure that the calculated dimension is divisible by n and adjust the value if necessary.
See below for the list of accepted constants for use in the dimension expression.
- size, s
-
Set the video size. For the syntax of this option, check the "Video size" section in the ffmpeg-utils manual.
- dither, d
-
Set the dither type.
Possible values are:
- none
- ordered
- random
- error_diffusion
Default is none.
- filter, f
-
Set the resize filter type.
Possible values are:
- point
- bilinear
- bicubic
- spline16
- spline36
- lanczos
Default is bilinear.
- range, r
-
Set the color range.
Possible values are:
- input
- limited
- full
Default is same as input.
- primaries, p
-
Set the color primaries.
Possible values are:
- input
- 709
- unspecified
- 170m
- 240m
- 2020
Default is same as input.
- transfer, t
-
Set the transfer characteristics.
Possible values are:
- input
- 709
- unspecified
- 601
- linear
- 2020_10
- 2020_12
Default is same as input.
- matrix, m
-
Set the colorspace matrix.
Possible value are:
- input
- 709
- unspecified
- 470bg
- 170m
- 2020_ncl
- 2020_cl
Default is same as input.
- rangein, rin
-
Set the input color range.
Possible values are:
- input
- limited
- full
Default is same as input.
- primariesin, pin
-
Set the input color primaries.
Possible values are:
- input
- 709
- unspecified
- 170m
- 240m
- 2020
Default is same as input.
- transferin, tin
-
Set the input transfer characteristics.
Possible values are:
- input
- 709
- unspecified
- 601
- linear
- 2020_10
- 2020_12
Default is same as input.
- matrixin, min
-
Set the input colorspace matrix.
Possible value are:
- input
- 709
- unspecified
- 470bg
- 170m
- 2020_ncl
- 2020_cl
The values of the w and h options are expressions containing the following constants:
- in_w, in_h
-
The input width and height
- iw, ih
-
These are the same as in_w and in_h.
- out_w, out_h
-
The output (scaled) width and height
- ow, oh
-
These are the same as out_w and out_h
- a
-
The same as iw / ih
- sar
-
input sample aspect ratio
- dar
-
The input display aspect ratio. Calculated from
(iw / ih) * sar. - hsub, vsub
-
horizontal and vertical input chroma subsample values. For example for the pixel format "yuv422p" hsub is 2 and vsub is 1.
- ohsub, ovsub
-
horizontal and vertical output chroma subsample values. For example for the pixel format "yuv422p" hsub is 2 and vsub is 1.