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 ESMTP id 1E39F49558 for ; Wed, 14 Feb 2024 01:56:54 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id AA28068D1F7; Wed, 14 Feb 2024 03:55:49 +0200 (EET) Received: from mail-ej1-f54.google.com (mail-ej1-f54.google.com [209.85.218.54]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id D4D6F68D1DF for ; Wed, 14 Feb 2024 03:55:40 +0200 (EET) Received: by mail-ej1-f54.google.com with SMTP id a640c23a62f3a-a2a17f3217aso639032966b.2 for ; Tue, 13 Feb 2024 17:55:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1707875740; x=1708480540; 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=oeufYrTfoEOZuy/qPEO5tLldeonCuvJLaU/9VhC42d4=; b=DPGzLD+yY0AISwE8gLO+SdNKhzvVZljrtkOP5qUn9ARYU2aguIeu3EGw1PNIvHlmAg z+mJoJGK+z5rkahlZMLv1I6BqQEDB2gA0qas6sJaEKX4PVCJoJThZDAXOy1dwAqOHM0Y zsVCfLQwi+ku5pbP3dZCocN3aAeLQP6E5A5/jVgVwxnekTs9nCFDArwXSxhyUK3C0gT+ q0YhCAE2xy8SJcj4U9GHZv3l+Zpb7PuM3Xc98p/4xb6irVOVrZjDJ6c9WOlBQBOqMjNy htZNQ3DEIaoR2HPwnhBLFH0fKWoAlMVEfNH8sff+KRcF9YyLnAGkLh6xajXQSq/F/VEP p6lg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1707875740; x=1708480540; 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=oeufYrTfoEOZuy/qPEO5tLldeonCuvJLaU/9VhC42d4=; b=gQ8RNCxfUN3DYZSLr7TQlT5jIegLc2UBd5hRj5yslZ6pltybo/pdJtrgekVBpX4YAG nd5TWAmLUIdSHTz6w9D4HsSbExtsYY/1Qighrn/eqCQbYUIdadTJSw4fWWTqVYqLsOTd +wqmQa1+cFVSd/BG8lEOUCZYtRc42DSHA7eQaSPUh0z/0UOWeQ2TlsuGZqFHbF4Usnlq PpGat/rv22S7owAOcp/BrZ6EZ3jHnMMl4bDTgTowKSFGhPVW79vk0wxSGP/L2idMpo2x 508RKVTBB553EEU996BiEYnNzUMzzJwG+h3ZrPPRLCo+UsMLD2INEehq3YqcAwTLKwBe 4yOQ== X-Gm-Message-State: AOJu0Ywdrzw0K7LCe76+n+AR8UizHOZ81/Ksg91qtowUl21Akmhg/I7E JE5IVSrD4xrXYRjCb1PK7sKP50x3FQVBXbWDVGTzfiXTHIrGhnJzGKFBcZaTT88= X-Google-Smtp-Source: AGHT+IH4GVTAKNdlv2pmmKaQqlBCcauWkU0WTZNpST1sTsFF3rbsbCKG79otIGoWAMdzx1SbKCtK0A== X-Received: by 2002:a17:906:378a:b0:a3b:e975:c530 with SMTP id n10-20020a170906378a00b00a3be975c530mr673391ejc.51.1707875739602; Tue, 13 Feb 2024 17:55:39 -0800 (PST) Received: from dovchinn.amd.com (cable-178-148-16-149.dynamic.sbb.rs. [178.148.16.149]) by smtp.gmail.com with ESMTPSA id vi16-20020a170907d41000b00a3ce31d3ffdsm1663230ejc.93.2024.02.13.17.55.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 13 Feb 2024 17:55:38 -0800 (PST) From: Dmitrii Ovchinnikov To: ffmpeg-devel@ffmpeg.org Date: Wed, 14 Feb 2024 02:55:15 +0100 Message-Id: <20240214015515.1027-9-ovchinnikov.dmitrii@gmail.com> X-Mailer: git-send-email 2.38.1.windows.1 In-Reply-To: <20240214015515.1027-1-ovchinnikov.dmitrii@gmail.com> References: <20240214015515.1027-1-ovchinnikov.dmitrii@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 9/9] 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 | 238 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 238 insertions(+) diff --git a/doc/filters.texi b/doc/filters.texi index e0436a5755..4c5b9c1f63 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -21330,6 +21330,244 @@ If the specified expression is not valid, it is kept at its current value. @end table +@anchor{scale_amf} +@section scale_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 + +@anchor{trc} +@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 + +@anchor{primaries} +@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 +scale_amf=-2:720:format=yuv420p +@end example + +@item +Upscale to 4K and change color profile to bt2020. +@example +scale_amf=4096:2160:color_profile=bt2020 +@end example +@end itemize + +@anchor{scale_amf_hq} +@section scale_amf_hq + +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 +scale_amf_hq=-2:720:format=yuv420p +@end example + +@item +Upscale to 4K with algorithm video SR1.1. +@example +scale_amf_hq=4096:2160:algorithm=sr1-1 +@end example +@end itemize + @anchor{scale_cuda} @section scale_cuda -- 2.38.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".