From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.ffmpeg.org (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTPS id 9C97B4D2A8 for ; Sat, 15 Nov 2025 16:35:54 +0000 (UTC) Authentication-Results: ffbox; dkim=fail (body hash mismatch (got b'U6CHaJKbUZ0KW+tLIM8JdAP85XZbu0zEF8amb3lezR4=', expected b'rgMwBdNC8C521OjHEn7xV3xQ/vbqjrK/sCJMlhyjzME=')) header.d=ffmpeg.org header.i=@ffmpeg.org header.a=rsa-sha256 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ffmpeg.org; i=@ffmpeg.org; q=dns/txt; s=mail; t=1763224533; h=mime-version : to : date : message-id : reply-to : subject : list-id : list-archive : list-archive : list-help : list-owner : list-post : list-subscribe : list-unsubscribe : from : cc : content-type : content-transfer-encoding : from; bh=U6CHaJKbUZ0KW+tLIM8JdAP85XZbu0zEF8amb3lezR4=; b=0EBugChwNHxvDEaocs2mCil7GmBpJQjvusjVeOuiW1h7HIyb+djMCA/+qzt9dHPUcRbxa uN3boOnRdNP9OKSScFoZMmJHYIp9GdFVKNstD4xzaZPC3+9W7Wpwc3KVzWFlhmgWDHfnHm+ 5bNU3Tl0s6z/cSGBsNrh9IdKd4H03il/dlRKBmpHSw2I5aeG0GSR7inKXU6m7IE3pW/NXVT oooNLO9NUuNR7XufP/Nl8DDNI1XnRuUkd8DS9C9/hZDlPbKwIXxtqNmMFETltLWLhEhrHa9 wkfOI1h5svPLAyHYRixZrAVupmE7riRBhWNAhocbjomq8aC9En063pJhkvHQ== Received: from [172.19.0.2] (unknown [172.19.0.2]) by ffbox0-bg.ffmpeg.org (Postfix) with ESMTP id 2114168FE27; Sat, 15 Nov 2025 18:35:33 +0200 (EET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=ffmpeg.org; s=arc; t=1763224505; b=fzI59IyKig526CWZoi+Doyhey3xrCc795Dt88yzCn7RglsVBWco0y24khfnL0mfvynVkD nNj5bQevDwIY1oTOK+zeJ8k+jtnhWJq33ZU4QAWIDWljpudy8RbobLgoOVpPNx8R4kqxIzD IxPpGanja9O8Q22DNlwwYMBHh4iHA2AJZljBYGLbHGZ3/I55u4qz4259agFQcpiol/HC9Ch JlLAwOSpbzhnqVm7v7n2KLuOa8EzRgaqMSccYlst7uKGZ7zhlKr3A2DZ4UK6VIFJra423v5 GRmoRffrz3WmM0owbgXGcvFpVUlI3irPZkyIQi7JSA7Td1CktQcxI9uMvWAw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=ffmpeg.org; s=arc; t=1763224505; h=from : sender : reply-to : subject : date : message-id : to : cc : mime-version : content-type : content-transfer-encoding : content-id : content-description : resent-date : resent-from : resent-sender : resent-to : resent-cc : resent-message-id : in-reply-to : references : list-id : list-help : list-unsubscribe : list-subscribe : list-post : list-owner : list-archive; bh=6eTzsSK1UAhqwF1SoMSONv+IPY4nyLDmPXajUqg8kAg=; b=gywvJbfbvftqZmiWWfpY2MMuPi2i6mmiw40nBTvxIHEMS5bDIzRyOqwmXsO8CZVTOMB1J xbTf5tWN0wfzVpEoHMpM+mI4RR09l2sgvkZ0v1GnNBntD401nISYtBLG8R4/XdmogYbz0hM p97pBFcBAQO/2uVL8BWaBnDkIfc4JrF8wklAn78iObsT+s69uk/DV/jh3D6myTfAP6qwo7f RSP+0pgWkyGMiaHFPH6JPTHsSwNj5E24y9dj7eV1ndHrqu1S1zZzFLJ3os4kp+xaVyeA9Mx 3bOMIlkYFhCVTLfPCpdJdvGKJ2sk4SRaF+nc0fceuNwoxKgcXutQHp9fOuEA== ARC-Authentication-Results: i=1; ffmpeg.org; dkim=pass header.d=ffmpeg.org header.i=@ffmpeg.org; arc=none; dmarc=pass header.from=ffmpeg.org policy.dmarc=quarantine Authentication-Results: ffmpeg.org; dkim=pass header.d=ffmpeg.org header.i=@ffmpeg.org; arc=none (Message is not ARC signed); dmarc=pass (Used From Domain Record) header.from=ffmpeg.org policy.dmarc=quarantine DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ffmpeg.org; i=@ffmpeg.org; q=dns/txt; s=mail; t=1763224498; h=content-type : mime-version : content-transfer-encoding : from : to : reply-to : subject : date : from; bh=rgMwBdNC8C521OjHEn7xV3xQ/vbqjrK/sCJMlhyjzME=; b=gcHcmOrNatq7E7EefZS/etmMJbfE46KTZ17a9MgldCaAnrOGkiarShgRKMluXxtiZbg/o KC9tHC5jkOZimAKzrwIajkoJCk/3FZWrxr6ivIVUUGa2Lw3mY9PqOYZ732jRcevtSqLk/Zm 1lqpyluw0ewai7rIGVjn8kD/+m67U9rM+ZEbZZCWgTKEeMXsf/kauk1DxRaMPcK0jxQC4Al lmQdVUp4HOZQdcH+kl0cXclX7XSGDlC6MmqZIRwoEiZEhGqWl2lqfmbGLXpVVgxiZ8/pjPp UVj3+rfxi0WywS/ANlI0jTCwLuGL1utoaoNzUKqy01VMMPMadUya3J9KoGEw== Received: from 188d6d40ca7a (code.ffmpeg.org [188.245.149.3]) by ffbox0-bg.ffmpeg.org (Postfix) with ESMTPS id A63AC68FD85 for ; Sat, 15 Nov 2025 18:34:58 +0200 (EET) MIME-Version: 1.0 To: ffmpeg-devel@ffmpeg.org Date: Sat, 15 Nov 2025 16:34:58 -0000 Message-ID: <176322449882.25.17258405975584295805@2cb04c0e5124> Message-ID-Hash: YJZEBBZZ52X7TUIKEU6JEHY2GH5OC46W X-Message-ID-Hash: YJZEBBZZ52X7TUIKEU6JEHY2GH5OC46W X-MailFrom: code@ffmpeg.org X-Mailman-Rule-Hits: nonmember-moderation X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-ffmpeg-devel.ffmpeg.org-0; header-match-ffmpeg-devel.ffmpeg.org-1; header-match-ffmpeg-devel.ffmpeg.org-2; header-match-ffmpeg-devel.ffmpeg.org-3; emergency; member-moderation X-Mailman-Version: 3.3.10 Precedence: list Reply-To: FFmpeg development discussions and patches Subject: [FFmpeg-devel] [PATCH] doc/filters: add section for VideoToolbox filter (PR #20926) List-Id: FFmpeg development discussions and patches Archived-At: Archived-At: List-Archive: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Zhao Zhili via ffmpeg-devel Cc: Zhao Zhili Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Archived-At: List-Archive: List-Post: PR #20926 opened by Zhao Zhili (quink) URL: https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/20926 Patch URL: https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/20926.patch Move scale_vt and transpose_vt to this section. >>From d0460c7238c10d636465c37f05a048eeb46a852c Mon Sep 17 00:00:00 2001 From: Zhao Zhili Date: Sat, 15 Nov 2025 23:58:14 +0800 Subject: [PATCH] doc/filters: add section for VideoToolbox filter Move scale_vt and transpose_vt to this section. --- doc/filters.texi | 168 ++++++++++++++++++++++++++++------------------- 1 file changed, 99 insertions(+), 69 deletions(-) diff --git a/doc/filters.texi b/doc/filters.texi index 8edb4fad33..785ba615f3 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -21471,27 +21471,6 @@ If the specified expression is not valid, it is kept at its current value. @end table -@section scale_vt - -Scale and convert the color parameters using VTPixelTransferSession. - -The filter accepts the following options: -@table @option -@item w -@item h -Set the output video dimension expression. Default value is the input dimension. - -@item color_matrix -Set the output colorspace matrix. - -@item color_primaries -Set the output color primaries. - -@item color_transfer -Set the output transfer characteristics. - -@end table - @section scharr Apply scharr operator to input video stream. @@ -28920,6 +28899,105 @@ drawbox=x=-t:y=0.5*(ih-iw/2.4)-t:w=iw+t*2:h=iw/2.4+t*2:t=2:c=red @c man end VAAPI VIDEO FILTERS +@chapter VideoToolbox Video Filters +@c man begin VIDEOTOOLBOX VIDEO FILTERS + +Below is a description of the currently available VideoToolbox video filters. + +VideoToolbox filter depends on VideoToolbox framework, and is auto detected +when build ffmpeg for Apple's platform such as macOS. + +@section scale_vt + +Scale and convert the color parameters using VTPixelTransferSession. + +The filter accepts the following options: +@table @option +@item w +@item h +Set the output video dimension expression. Default value is the input dimension. + +@item color_matrix +Set the output colorspace matrix. + +@item color_primaries +Set the output color primaries. + +@item color_transfer +Set the output transfer characteristics. + +@end table + +@subsection Examples + +@itemize +@item +Perform HDR to SDR conversion, and scale to half size of input +@example +ffmpeg -hwaccel videotoolbox \ + -hwaccel_output_format videotoolbox_vld \ + -i hdr.mov \ + -c:v hevc_videotoolbox \ + -profile:v main \ + -b:v 3M \ + -vf scale_vt=w=iw/2:h=ih/2:color_matrix=bt709:color_primaries=bt709:color_transfer=bt709 \ + -c:a copy \ + -tag:v hvc1 \ + sdr.mp4 +@end example + +@end itemize + +@section transpose_vt + +Transpose rows with columns in the input video and optionally flip it. +For more in depth examples see the @ref{transpose} video filter, which shares mostly the same options. + +It accepts the following parameters: + +@table @option + +@item dir +Specify the transposition direction. + +Can assume the following values: +@table @samp +@item cclock_flip +Rotate by 90 degrees counterclockwise and vertically flip. (default) + +@item clock +Rotate by 90 degrees clockwise. + +@item cclock +Rotate by 90 degrees counterclockwise. + +@item clock_flip +Rotate by 90 degrees clockwise and vertically flip. + +@item hflip +Flip the input video horizontally. + +@item vflip +Flip the input video vertically. + +@end table + +@item passthrough +Do not apply the transposition if the input geometry matches the one +specified by the specified value. It accepts the following values: +@table @samp +@item none +Always apply transposition. (default) +@item portrait +Preserve portrait geometry (when @var{height} >= @var{width}). +@item landscape +Preserve landscape geometry (when @var{width} >= @var{height}). +@end table + +@end table + +@c man end VIDEOTOOLBOX VIDEO FILTERS + @chapter Vulkan Video Filters @c man begin VULKAN VIDEO FILTERS @@ -29224,54 +29302,6 @@ Default value is @code{0}. @end table -@section transpose_vt - -Transpose rows with columns in the input video and optionally flip it. -For more in depth examples see the @ref{transpose} video filter, which shares mostly the same options. - -It accepts the following parameters: - -@table @option - -@item dir -Specify the transposition direction. - -Can assume the following values: -@table @samp -@item cclock_flip -Rotate by 90 degrees counterclockwise and vertically flip. (default) - -@item clock -Rotate by 90 degrees clockwise. - -@item cclock -Rotate by 90 degrees counterclockwise. - -@item clock_flip -Rotate by 90 degrees clockwise and vertically flip. - -@item hflip -Flip the input video horizontally. - -@item vflip -Flip the input video vertically. - -@end table - -@item passthrough -Do not apply the transposition if the input geometry matches the one -specified by the specified value. It accepts the following values: -@table @samp -@item none -Always apply transposition. (default) -@item portrait -Preserve portrait geometry (when @var{height} >= @var{width}). -@item landscape -Preserve landscape geometry (when @var{width} >= @var{height}). -@end table - -@end table - @section transpose_vulkan Transpose rows with columns in the input video and optionally flip it. -- 2.49.1 _______________________________________________ ffmpeg-devel mailing list -- ffmpeg-devel@ffmpeg.org To unsubscribe send an email to ffmpeg-devel-leave@ffmpeg.org