[FFmpeg-devel] [PATCH 4/5] doc/filters: Add documentation for AMF filters

[Dmitrii Ovchinnikov]

From: Evgeny Pavlov <lucenticus at gmail.com>

Signed-off-by: Evgeny Pavlov <lucenticus at gmail.com>
---
 doc/filters.texi | 238 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 238 insertions(+)

diff --git a/doc/filters.texi b/doc/filters.texi
index 428986a1e9..7d75ebfa3e 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -22827,6 +22827,76 @@ input upscaled using bicubic upscaling with proper scale factor.
 
 To get full functionality (such as async execution), please use the @ref{dnn_processing} filter.
 
+ at anchor{sr_amf}
+ at section sr_amf
+
+Upscale (size increasing) for the input video using AMD Advanced Media Framework library for hardware acceleration.
+Use advanced algorithms for upscaling with higher output quality.
+Setting the output width and height works in the same way as for the @ref{scale} filter.
+
+The filter accepts the following options:
+ at table @option
+ at item w
+ at item h
+Set the output video dimension expression. Default value is the input dimension.
+
+Allows for the same expressions as the @ref{scale} filter.
+
+ at item algorithm
+Sets the algorithm used for scaling:
+
+ at table @var
+ at item bilinear
+Bilinear
+
+ at item bicubic
+Bicubic
+
+ at item sr1-0
+Video SR1.0
+This is a default value
+
+ at item point
+Point
+
+ at item sr1-1
+Video SR1.1
+
+ at end table
+
+ at item sharpness
+Control hq scaler sharpening. The value is a float in the range of [0.0, 2.0]
+
+ at item format
+Controls the output pixel format. By default, or if none is specified, the input
+pixel format is used.
+
+ at item keep-ratio
+Force the scaler to keep the aspect ratio of the input image when the output size has a different aspect ratio.
+Default value is false.
+
+ at item fill
+Specifies whether the output image outside the region of interest,
+which does not fill the entire output surface should be filled with a solid color.
+
+ at end table
+
+ at subsection Examples
+
+ at itemize
+ at item
+Scale input to 720p, keeping aspect ratio and ensuring the output is yuv420p.
+ at example
+sr_amf=-2:720:format=yuv420p
+ at end example
+
+ at item
+Upscale to 4K with algorithm video SR1.1.
+ at example
+sr_amf=4096:2160:algorithm=sr1-1
+ at end example
+ at end itemize
+
 @section ssim
 
 Obtain the SSIM (Structural SImilarity Metric) between two input videos.
@@ -25565,6 +25635,174 @@ Example:
 ffmpeg -i ref.mpg -vf vmafmotion -f null -
 @end example
 
+ at anchor{vpp_amf}
+ at section vpp_amf
+
+Scale (resize) and convert colorspace, transfer characteristics or color primaries for the input video, using AMD Advanced Media Framework library for hardware acceleration.
+Setting the output width and height works in the same way as for the @ref{scale} filter.
+
+The filter accepts the following options:
+ at table @option
+ at item w
+ at item h
+Set the output video dimension expression. Default value is the input dimension.
+
+Allows for the same expressions as the @ref{scale} filter.
+
+ at item scale_type
+Sets the algorithm used for scaling:
+
+ at table @var
+ at item bilinear
+Bilinear
+
+This is the default.
+
+ at item bicubic
+Bicubic
+
+ at end table
+
+ at item format
+Controls the output pixel format. By default, or if none is specified, the input
+pixel format is used.
+
+
+ at item force_original_aspect_ratio
+ at item force_divisible_by
+Work the same as the identical @ref{scale} filter options.
+
+ at anchor{color_profile}
+ at item color_profile
+Specify all color properties at once.
+
+The accepted values are:
+ at table @samp
+ at item bt601
+BT.601
+
+ at item bt709
+BT.709
+
+ at item bt2020
+BT.2020
+
+ at end table
+
+ at anchor{trc}
+ at item trc
+Specify output transfer characteristics.
+
+The accepted values are:
+ at table @samp
+ at item bt709
+BT.709
+
+ at item gamma22
+Constant gamma of 2.2
+
+ at item gamma28
+Constant gamma of 2.8
+
+ at item smpte170m
+SMPTE-170M
+
+ at item smpte240m
+SMPTE-240M
+
+ at item linear
+Linear
+
+ at item log
+LOG
+
+ at item log-sqrt
+LOG_SQRT
+
+ at item iec61966-2-4
+iec61966-2-4
+
+ at item bt1361-ecg
+BT1361_ECG
+
+ at item iec61966-2-1
+iec61966-2-1
+
+ at item bt2020-10
+BT.2020 for 10-bits content
+
+ at item bt2020-12
+BT.2020 for 12-bits content
+
+ at item smpte2084
+SMPTE2084
+
+ at item smpte428
+SMPTE428
+
+ at item arib-std-b67
+ARIB_STD_B67
+
+ at end table
+
+ at anchor{primaries}
+ at item primaries
+Specify output color primaries.
+
+The accepted values are:
+ at table @samp
+ at item bt709
+BT.709
+
+ at item bt470m
+BT.470M
+
+ at item bt470bg
+BT.470BG or BT.601-6 625
+
+ at item smpte170m
+SMPTE-170M or BT.601-6 525
+
+ at item smpte240m
+SMPTE-240M
+
+ at item film
+film
+
+ at item bt2020
+BT.2020
+
+ at item smpte428
+SMPTE-428
+
+ at item smpte431
+SMPTE-431
+
+ at item smpte432
+SMPTE-432
+
+ at item jedec-p22
+JEDEC P22 phosphors
+
+ at end table
+ at end table
+
+ at subsection Examples
+
+ at itemize
+ at item
+Scale input to 720p, keeping aspect ratio and ensuring the output is yuv420p.
+ at example
+vpp_amf=-2:720:format=yuv420p
+ at end example
+
+ at item
+Upscale to 4K and change color profile to bt2020.
+ at example
+vpp_amf=4096:2160:color_profile=bt2020
+ at end example
+ at end itemize
+
 @anchor{vstack}
 @section vstack
 Stack input videos vertically.
-- 
2.38.1.windows.1