PR: Varnish "Recommendation ITU-T H.273" Implementation

BIBLIOGRAPHY.bib

@@ -1052,11 +1052,36 @@ @misc{Erdogana
     adhere to the official terms assigned to the CIE system to avoid
     any ambiguity.},
 }
+@misc{EuropeanBroadcastingUnion1975,
+  title        = {{{EBU Tech}} 3213 - {{EBU Standard}} for
+    {{Chromaticity Tolerances}} for {{Studio Monitors}}},
+  author       = {{European Broadcasting Union}},
+  year         = 1975,
+  month        = aug,
+}
 @misc{EuropeanColorInitiative2002a,
   title        = {{{ECI RGB}} V2},
   author       = {{European Color Initiative}},
   year         = 2002,
 }
+@misc{FFmpegDevelopers2022,
+  title        = {{{FFmpeg}}::{{AVColorPrimaries}}},
+  author       = {{FFmpeg Developers}},
+  year         = 2022,
+  month        = aug,
+}
+@misc{FFmpegDevelopers2022a,
+  title        = {{{FFmpeg}}::{{AVColorTransferCharacteristic}}},
+  author       = {{FFmpeg Developers}},
+  year         = 2022,
+  month        = aug,
+}
+@misc{FFmpegDevelopers2022b,
+  title        = {{{FFmpeg}}::{{AVColorSpace}}},
+  author       = {{FFmpeg Developers}},
+  year         = 2022,
+  month        = aug,
+}
 @article{Fairchild1991a,
   title        = {Formulation and Testing of an
     Incomplete-Chromatic-Adaptation Model},
@@ -1719,6 +1744,35 @@ @misc{InternationalOrganizationforStandardization2012
   author       = {{International Organization for Standardization}},
   year         = 2012,
 }
+@misc{InternationalOrganizationforStandardization2013,
+  title        = {{{INTERNATIONAL STANDARD ISO}}/{{IEC}} 23001-8 -
+    {{Information}} Technology - {{MPEG}} Systems Technologies -
+    {{Part}} 8: {{Coding-independent}} Code Points},
+  author       = {{International Organization for Standardization}},
+  year         = 2013,
+}
+@misc{InternationalOrganizationforStandardization2020,
+  title        = {{{INTERNATIONAL STANDARD ISO}}/{{IEC}} 14496-10 -
+    {{Information}} Technology - {{Coding}} of Audio-Visual Objects -
+    {{Part}} 10: {{Advanced}} Video Coding},
+  author       = {{International Organization for Standardization}},
+  year         = 2020,
+}
+@misc{InternationalOrganizationforStandardization2021,
+  title        = {{{INTERNATIONAL STANDARD ISO}}/{{IEC}} 23091-2 -
+    {{Information}} Technology - {{Coding-}} Independent Code Points -
+    {{Part}} 2: {{Video}}},
+  author       = {{International Organization for Standardization}},
+  year         = 2021,
+}
+@misc{InternationalTelecommunicationUnion1998,
+  title        = {Recommendation {{ITU-R BT}}.1361 - {{Worldwide}}
+    Unified Colorimetry and Related Characteristics of Future
+    Television and Imaging Systems},
+  author       = {{International Telecommunication Union}},
+  year         = 1998,
+  pages        = {1--32},
+}
 @misc{InternationalTelecommunicationUnion1998a,
   title        = {Recommendation {{ITU-R BT}}.470-6 - {{CONVENTIONAL
     TELEVISION SYSTEMS}}},
@@ -1803,6 +1857,13 @@ @misc{InternationalTelecommunicationUnion2019
   year         = 2019,
   pages        = {1--36},
 }
+@misc{InternationalTelecommunicationUnion2021,
+  title        = {Recommendation {{ITU-T H}}.273 -
+    {{Coding-independent}} Code Points for Video Signal Type
+    Identification},
+  author       = {{International Telecommunication Union}},
+  year         = 2021,
+}
 @article{Jakob2019,
   ids          = {Jakob},
   title        = {A {{Low}}-{{Dimensional Function Space}} for
@@ -3054,6 +3115,13 @@ @misc{SocietyofMotionPictureandTelevisionEngineers2014a
     non-broadcast content. This standard also specifies an
     Inverse-EOTF derived from the EOTF.},
 }
+@misc{SocietyofMotionPictureandTelevisionEngineers2019,
+  title        = {{{ST}} 428-1:2019 - {{D-Cinema Distribution Master}}
+    \textemdash{} {{Image Characteristic}}},
+  author       = {{Society of Motion Picture and Television Engineers}},
+  year         = 2019,
+  doi          = {10.5594/SMPTE.ST428-1.2019},
+}
 @misc{SonyCorporation,
   title        = {S-{{Log Whitepaper}}},
   author       = {{Sony Corporation}},

README.rst

@@ -911,15 +911,16 @@ RGB Colourspaces
      'CIE RGB',
      'Cinema Gamut',
      'ColorMatch RGB',
-     'DaVinci Wide Gamut',
      'DCDM XYZ',
      'DCI-P3',
-     'DCI-P3+',
+     'DCI-P3-P',
      'DJI D-Gamut',
      'DRAGONcolor',
      'DRAGONcolor2',
+     'DaVinci Wide Gamut',
      'Display P3',
      'Don RGB 4',
+     'EBU Tech. 3213-E',
      'ECI RGB v2',
      'ERIMM RGB',
      'Ekta Space PS 5',
@@ -929,7 +930,10 @@ RGB Colourspaces
      'ITU-R BT.470 - 525',
      'ITU-R BT.470 - 625',
      'ITU-R BT.709',
+     'ITU-T H.273 - 22 Unspecified',
+     'ITU-T H.273 - Generic Film',
      'Max RGB',
+     'N-Gamut',
      'NTSC (1953)',
      'NTSC (1987)',
      'P3-D65',
@@ -957,6 +961,8 @@ RGB Colourspaces
      'aces',
      'adobe1998',
      'prophoto',
+     'sRGB']
+
 
 OETFs
 *****
@@ -972,8 +978,12 @@ OETFs
      'ITU-R BT.2100 PQ',
      'ITU-R BT.601',
      'ITU-R BT.709',
+     'ITU-T H.273 IEC 61966-2',
+     'ITU-T H.273 Log',
+     'ITU-T H.273 Log Sqrt',
      'SMPTE 240M']
 
+
 EOTFs
 *****
 
@@ -985,6 +995,7 @@ EOTFs
      'ITU-R BT.1886',
      'ITU-R BT.2100 HLG',
      'ITU-R BT.2100 PQ',
+     'ITU-T H.273 ST.428-1',
      'SMPTE 240M',
      'ST 2084',
      'sRGB']
@@ -1083,6 +1094,59 @@ CCTFs Encoding / Decoding
      'ViperLog',
      'sRGB']
 
+Recommendation ITU-T H.273 Code points for Video Signal Type Identification
+***************************************************************************
+
+.. code-block:: python
+
+    >>> colour.COLOUR_PRIMARIES_ITUTH273.keys()
+    dict_keys([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 22, 23])
+    >>> colour.COLOUR_PRIMARIES_ITUTH273.keys()
+    >>> description = colour.models.describe_video_signal_colour_primaries(1)
+    ===============================================================================
+    *                                                                             *
+    *   Colour Primaries: 1                                                       *
+    *   -------------------                                                       *
+    *                                                                             *
+    *   Primaries        : [[ 0.64  0.33]                                         *
+    *                       [ 0.3   0.6 ]                                         *
+    *                       [ 0.15  0.06]]                                        *
+    *   Whitepoint       : [ 0.3127  0.329 ]                                      *
+    *   Whitepoint Name  : D65                                                    *
+    *   NPM              : [[ 0.4123908   0.35758434  0.18048079]                 *
+    *                       [ 0.21263901  0.71516868  0.07219232]                 *
+    *                       [ 0.01933082  0.11919478  0.95053215]]                *
+    *   NPM -1           : [[ 3.24096994 -1.53738318 -0.49861076]                 *
+    *                       [-0.96924364  1.8759675   0.04155506]                 *
+    *                       [ 0.05563008 -0.20397696  1.05697151]]                *
+    *   FFmpeg Constants : ['AVCOL_PRI_BT709', 'BT709']                           *
+    *                                                                             *
+    ===============================================================================
+    >>> colour.TRANSFER_CHARACTERISTICS_ITUTH273.keys()
+    dict_keys([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19])
+    >>> description = colour.models.describe_video_signal_transfer_characteristics(1)
+    ===============================================================================
+    *                                                                             *
+    *   Transfer Characteristics: 1                                               *
+    *   ---------------------------                                               *
+    *                                                                             *
+    *   Function         : <function oetf_BT709 at 0x165bb3550>                   *
+    *   FFmpeg Constants : ['AVCOL_TRC_BT709', 'BT709']                           *
+    *                                                                             *
+    ===============================================================================
+    >>> colour.MATRIX_COEFFICIENTS_ITUTH273.keys()
+    dict_keys([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15])
+    >>> description = colour.models.describe_video_signal_matrix_coefficients(1)
+    ===============================================================================
+    *                                                                             *
+    *   Matrix Coefficients: 1                                                    *
+    *   ----------------------                                                    *
+    *                                                                             *
+    *   Matrix Coefficients : [ 0.2126  0.0722]                                   *
+    *   FFmpeg Constants    : ['AVCOL_SPC_BT709', 'BT709']                        *
+    *                                                                             *
+    ===============================================================================
+
 Colour Notation Systems - ``colour.notation``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

colour/__init__.py

@@ -238,6 +238,7 @@
     CMY_to_CMYK,
     CMY_to_RGB,
     COLOURSPACE_MODELS,
+    COLOUR_PRIMARIES_ITUTH273,
     CV_range,
     DATA_MACADAM_1942_ELLIPSES,
     DIN99_to_Lab,
@@ -277,6 +278,7 @@
     Luv_to_XYZ,
     Luv_to_uv,
     Luv_uv_to_xy,
+    MATRIX_COEFFICIENTS_ITUTH273,
     OETFS,
     OETF_INVERSES,
     OOTFS,
@@ -301,6 +303,7 @@
     RGB_to_YCbCr,
     RGB_to_YCoCg,
     RGB_to_YcCbcCrc,
+    TRANSFER_CHARACTERISTICS_ITUTH273,
     UCS_to_XYZ,
     UCS_to_uv,
     UCS_uv_to_xy,
@@ -657,6 +660,7 @@ def __getattr__(self, attribute) -> Any:
     "CMY_to_CMYK",
     "CMY_to_RGB",
     "COLOURSPACE_MODELS",
+    "COLOUR_PRIMARIES_ITUTH273",
     "CV_range",
     "DATA_MACADAM_1942_ELLIPSES",
     "DIN99_to_Lab",
@@ -696,6 +700,7 @@ def __getattr__(self, attribute) -> Any:
     "Luv_to_XYZ",
     "Luv_to_uv",
     "Luv_uv_to_xy",
+    "MATRIX_COEFFICIENTS_ITUTH273",
     "OETFS",
     "OETF_INVERSES",
     "OOTFS",
@@ -720,6 +725,7 @@ def __getattr__(self, attribute) -> Any:
     "RGB_to_YCbCr",
     "RGB_to_YCoCg",
     "RGB_to_YcCbcCrc",
+    "TRANSFER_CHARACTERISTICS_ITUTH273",
     "UCS_to_XYZ",
     "UCS_to_uv",
     "UCS_uv_to_xy",

colour/examples/models/examples_rgb.py

@@ -65,3 +65,32 @@
         colour.RGB_COLOURSPACES["ACEScg"],
     )
 )
+
+print("\n")
+
+message_box(
+    '"Recommendation ITU-T H.273" '
+    "Code points for Video Signal Type Identification"
+)
+
+message_box(
+    f"Colour Primaries: {list(colour.COLOUR_PRIMARIES_ITUTH273.keys())}"
+)
+colour.models.describe_video_signal_colour_primaries(1)
+
+print("\n")
+
+message_box(
+    f"Transfer Characteristics: "
+    f"{list(colour.TRANSFER_CHARACTERISTICS_ITUTH273.keys())}"
+)
+colour.models.describe_video_signal_transfer_characteristics(1)
+
+print("\n")
+
+message_box(
+    f"Matrix Coefficients: "
+    f"{list(colour.MATRIX_COEFFICIENTS_ITUTH273.keys())}"
+)
+
+colour.models.describe_video_signal_matrix_coefficients(1)