summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorOneric <oneric@oneric.stub>2024-04-03 18:24:48 +0200
committerOneric <oneric@oneric.stub>2024-04-03 18:24:49 +0200
commitdb4b720172a426aef183c6912e5847d60250b947 (patch)
treec9b6b85e1a58d41b650f71c88dc33762a161669f
parente51781341493e0312f0c7fee66372f0365f7b962 (diff)
downloadlibass-db4b720172a426aef183c6912e5847d60250b947.tar.bz2
libass-db4b720172a426aef183c6912e5847d60250b947.tar.xz
Update documentation re subs on HDR
mpv (temporarily) enabling colourspace-matching for HDR videos, showed by now a noteable amount of subs exist expecting to remain SDR when placed on HDR video. After further discussion in #297 we thus decided to revise the default for subs on HDR to forego exact colour-matches, see: https://github.com/libass/libass/issues/297#issuecomment-1991497184
-rw-r--r--libass/ass_types.h11
1 files changed, 8 insertions, 3 deletions
diff --git a/libass/ass_types.h b/libass/ass_types.h
index 48ee09e..f14a5ff 100644
--- a/libass/ass_types.h
+++ b/libass/ass_types.h
@@ -232,9 +232,14 @@ typedef struct ass_event {
*
* Further note all of the above only concerns the RGB values.
* Color primaries and transfer charateristics of ASS subtitles
- * must always match their associated video.
- * (This indeed has some undesirable effects on HDR videos,
- * but no mechanism avoiding this is yet standardized.)
+ * must always match their associated video when placed on top of SDR video.
+ *
+ * Subs on HDR video need additional consideration to yield satisfactory results,
+ * but unfortunately no mechanisms for this are standardized yet.
+ * Until such mechanisms are introduced and sub files start to enable them,
+ * all subtitles are to be considered SDR. When placed on top of HDR video
+ * exact color matching is not relevant and the choice of SDR colorspace
+ * to render subs in is left to the presenter.
*/
typedef enum ASS_YCbCrMatrix {
YCBCR_DEFAULT = 0, // Header missing