From 52783a46c0f56ccfb66795667f069a1d2993cfcf Mon Sep 17 00:00:00 2001 From: Oneric Date: Wed, 2 Nov 2022 17:16:15 +0100 Subject: doc: document xy* not mangling colours on RGB video This was confirmed on Cyberbeing/xy-VSFilter, xy-VSFilter from CCCP and pinterf/XySubFilter + madVR. --- libass/ass_types.h | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/libass/ass_types.h b/libass/ass_types.h index 15d6d8a..53ecfeb 100644 --- a/libass/ass_types.h +++ b/libass/ass_types.h @@ -180,7 +180,7 @@ typedef struct ass_event { * know the real colorspace of the video they're rendering to, so the * header wasn't created as a simple "Use ColourMangling: yes/no", but instead * specifies exactly which colorspace to use for the initial conversion - * from the subtitle's RGB values. So we now got + * from the subtitle's RGB values to the video's YCbCr. So we now got * * screen_rgb = video_csp_to_rgb(rgb_to_ycbcr_header_csp(ass_rgb)) * @@ -191,6 +191,10 @@ typedef struct ass_event { * renderers like libass an additional special value "None" was also added. * "None" tells the renderer to directly use untouched RGB values without * any conversion. + * + * If the video itself is already in RGB natively, then no color mangling + * happens regardless of the presence or value of a "YCbCr Matrix" header. + * * The above mangling process with special value "None" to opt out * of any colour mangling is the recommended default behaviour. * -- cgit v1.2.3