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 <[email protected]> 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 -- [email protected] To unsubscribe send an email to [email protected]
