Commit 634e00732a for ffmpeg
commit 634e00732ada6717191aca88cfb0b47bf89a73c9
Author: Michael Niedermayer <michael@niedermayer.cc>
Date: Sun Sep 6 22:21:43 2026 +0000
doc/filters: document YCgCo to RGB conversion with zscale
Add a full-range, 8-bit YCgCo to PNG example and explain why planar RGB output is requested from zscale. This provides an explicit conversion path for inputs such as the DXV HQ sample in issue #23017.
Assisted-by: Fairy
diff --git a/doc/filters.texi b/doc/filters.texi
index eb6a97ef96..fb866d24d1 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -27891,6 +27891,17 @@ horizontal and vertical output chroma subsample values. For example for the
pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1.
@end table
+@subsection Examples
+
+Convert a full-range, 8-bit YCgCo input to RGB and extract its first frame as
+a PNG:
+@example
+ffmpeg -i input.mov -vf "zscale=matrixin=ycgco:rangein=full:matrix=gbr:range=full,format=gbrp" -frames:v 1 output.png
+@end example
+The planar RGB format @code{gbrp} makes @ref{zscale} perform the color
+conversion before the automatic conversion to a pixel format supported by
+the PNG encoder. Set @option{rangein} to match the input's actual range.
+
@subsection Commands
This filter supports the following commands: