From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTPS id 0E1714012D for ; Wed, 22 Jan 2025 19:34:00 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 95D4D68B98A; Wed, 22 Jan 2025 21:33:22 +0200 (EET) Received: from mail-ed1-f42.google.com (mail-ed1-f42.google.com [209.85.208.42]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 058B468B958 for ; Wed, 22 Jan 2025 21:33:15 +0200 (EET) Received: by mail-ed1-f42.google.com with SMTP id 4fb4d7f45d1cf-5da12190e75so294420a12.1 for ; Wed, 22 Jan 2025 11:33:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1737574394; x=1738179194; darn=ffmpeg.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=9wa0prIJEUwsyX5U8+01juLBmXAEh7gXTR7HfTYBz2Q=; b=YaD5VOf6Z5ghD82nVxO+xW6En+/ddJaJBoOn/LLKekcHjlRU4bS3aqtC6xjgl+iMsC hILjGmiUf1M1+queMwBeFuyEp8spLJt7Yd0JeOYJeaPy19M1iTbpLAqAIUkI/6qQ/7TP WGDn30iKybEnX2zLSdXtySb+PIzTI+VjlUT+01WDXHEpdcKosvEfBubC2735ECPYidc3 uI5ElVKGVIyHQsycxtvhxBGzreCbyUhqKvJSJwXnOweJzIgm3pol5KlT+c4FHPtHk6dg bMxd1o5ZiqEcom8/5f+2jO2NHHcoqJtKielE0uvaHxfCmPrBnB4BBJQh6rVHf2As2Jqv uZSw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1737574394; x=1738179194; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=9wa0prIJEUwsyX5U8+01juLBmXAEh7gXTR7HfTYBz2Q=; b=Jdz/XYocxkQu/I6L2HZBogMKLxs91EP172QZn3o4XkkDUY+i3FK+MkT6ar5cO9fXEM qcWnTzlCl0SP+KXDUXyGkbCI4O05A4rzKVn2Ma7nlCFiEa3kz7aE1T4dRFoDTdza5h/U WIPFB9lvV2ztA3ghdywmhUaFbrassVGlfPMScueKu6t27ic4zk8CRuvkNveAPN4wOyeS KgiLZgK59kDtLiWkEOQNRMZhLNbl6BFLDcn/y2frA94Hxfwp5J7Jcn2emumHzHXwz2kT SCU8Ll54bWv26pxxjlL5cIb1yGaJs7OL2JPu1TVSl427g97AWeT+k+0YtgpTFTPhr/Jm bxxA== X-Gm-Message-State: AOJu0YzOvw/tfjHRVnc05Vf0cO7Y4F0Ex+Pe6ooJDUkJkZW8tn5sLXhI jSA0uyiDuUWz2Kww49/IG+Ei8+H9PpDrPUdYw8QLWKQuUsACPyKwrYkMe51W X-Gm-Gg: ASbGncsEOwLn/cIWiP66PJG0W+iXO5f4Z5SbYNRqFohl4RN8swnguThtEtuB+XXyWjN l5gnm7rOradpfZnsSvhSre8onJrFPgFN8866bG62RLivXUkK5m/McBqxy5UB98bym1b/n5byGCq EYwSMC1V0sdtDXBpnFLSJw1oEy43qIl5/OpT2hC6Pa6yhEKU7KZDwlPi+sNmm3tWBqnWE07ckLM snhU340kqOQ3vOWmlH0dVGnGfXHt7gpzDQhkm8uwjWZTawW2yy5Iv50IARzFy5WKUCKWHCMH2ai NsG9NnV39S7YaP5dRox2uvXy X-Google-Smtp-Source: AGHT+IEF1mUdEZZDbYVwRl+gcHRC5OVsoilMfUMwYiivqqNOLDWyny8hHrxQmHA++Dc7VarVCNtwlg== X-Received: by 2002:a17:906:4fc7:b0:aa6:6c08:dc79 with SMTP id a640c23a62f3a-ab38b42d8f9mr2235659566b.35.1737574393528; Wed, 22 Jan 2025 11:33:13 -0800 (PST) Received: from dovchinn.amd.com ([87.116.182.236]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-ab384f223e7sm950721066b.111.2025.01.22.11.33.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 22 Jan 2025 11:33:12 -0800 (PST) From: Dmitrii Ovchinnikov To: ffmpeg-devel@ffmpeg.org Date: Wed, 22 Jan 2025 20:32:54 +0100 Message-Id: <20250122193255.1493-4-ovchinnikov.dmitrii@gmail.com> X-Mailer: git-send-email 2.38.1.windows.1 In-Reply-To: <20250122193255.1493-1-ovchinnikov.dmitrii@gmail.com> References: <20250122193255.1493-1-ovchinnikov.dmitrii@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v6 4/5] doc/filters: Add documentation for AMF filters X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Evgeny Pavlov Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: From: Evgeny Pavlov Signed-off-by: Evgeny Pavlov --- doc/filters.texi | 236 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 236 insertions(+) diff --git a/doc/filters.texi b/doc/filters.texi index b926b865ae..39f54f5e0c 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -22919,6 +22919,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. +@anchor{sr_amf} +@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: +@table @option +@item w +@item h +Set the output video dimension expression. Default value is the input dimension. + +Allows for the same expressions as the @ref{scale} filter. + +@item algorithm +Sets the algorithm used for scaling: + +@table @var +@item bilinear +Bilinear + +@item bicubic +Bicubic + +@item sr1-0 +Video SR1.0 +This is a default value + +@item point +Point + +@item sr1-1 +Video SR1.1 + +@end table + +@item sharpness +Control hq scaler sharpening. The value is a float in the range of [0.0, 2.0] + +@item format +Controls the output pixel format. By default, or if none is specified, the input +pixel format is used. + +@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. + +@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. + +@end table + +@subsection Examples + +@itemize +@item +Scale input to 720p, keeping aspect ratio and ensuring the output is yuv420p. +@example +sr_amf=-2:720:format=yuv420p +@end example + +@item +Upscale to 4K with algorithm video SR1.1. +@example +sr_amf=4096:2160:algorithm=sr1-1 +@end example +@end itemize + @section ssim Obtain the SSIM (Structural SImilarity Metric) between two input videos. @@ -25657,6 +25727,172 @@ Example: ffmpeg -i ref.mpg -vf vmafmotion -f null - @end example +@anchor{vpp_amf} +@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: +@table @option +@item w +@item h +Set the output video dimension expression. Default value is the input dimension. + +Allows for the same expressions as the @ref{scale} filter. + +@item scale_type +Sets the algorithm used for scaling: + +@table @var +@item bilinear +Bilinear + +This is the default. + +@item bicubic +Bicubic + +@end table + +@item format +Controls the output pixel format. By default, or if none is specified, the input +pixel format is used. + + +@item force_original_aspect_ratio +@item force_divisible_by +Work the same as the identical @ref{scale} filter options. + +@anchor{color_profile} +@item color_profile +Specify all color properties at once. + +The accepted values are: +@table @samp +@item bt601 +BT.601 + +@item bt709 +BT.709 + +@item bt2020 +BT.2020 + +@end table + +@item trc +Specify output transfer characteristics. + +The accepted values are: +@table @samp +@item bt709 +BT.709 + +@item gamma22 +Constant gamma of 2.2 + +@item gamma28 +Constant gamma of 2.8 + +@item smpte170m +SMPTE-170M + +@item smpte240m +SMPTE-240M + +@item linear +Linear + +@item log +LOG + +@item log-sqrt +LOG_SQRT + +@item iec61966-2-4 +iec61966-2-4 + +@item bt1361-ecg +BT1361_ECG + +@item iec61966-2-1 +iec61966-2-1 + +@item bt2020-10 +BT.2020 for 10-bits content + +@item bt2020-12 +BT.2020 for 12-bits content + +@item smpte2084 +SMPTE2084 + +@item smpte428 +SMPTE428 + +@item arib-std-b67 +ARIB_STD_B67 + +@end table + +@item primaries +Specify output color primaries. + +The accepted values are: +@table @samp +@item bt709 +BT.709 + +@item bt470m +BT.470M + +@item bt470bg +BT.470BG or BT.601-6 625 + +@item smpte170m +SMPTE-170M or BT.601-6 525 + +@item smpte240m +SMPTE-240M + +@item film +film + +@item bt2020 +BT.2020 + +@item smpte428 +SMPTE-428 + +@item smpte431 +SMPTE-431 + +@item smpte432 +SMPTE-432 + +@item jedec-p22 +JEDEC P22 phosphors + +@end table +@end table + +@subsection Examples + +@itemize +@item +Scale input to 720p, keeping aspect ratio and ensuring the output is yuv420p. +@example +vpp_amf=-2:720:format=yuv420p +@end example + +@item +Upscale to 4K and change color profile to bt2020. +@example +vpp_amf=4096:2160:color_profile=bt2020 +@end example +@end itemize + @anchor{vstack} @section vstack Stack input videos vertically. -- 2.47.1.windows.1 _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org https://ffmpeg.org/mailman/listinfo/ffmpeg-devel To unsubscribe, visit link above, or email ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".