colour.models.describe_video_signal_colour_primaries#

colour.models.describe_video_signal_colour_primaries(code_point: int, print_description: bool = True, **kwargs) → str[source]#

Describe given video signal colour primaries code point.

Parameters:

code_point (int) – Video signal colour primaries code point to describe from colour.COLOUR_PRIMARIES_ITUTH273 attribute.
print_description (bool) – Whether to print the description.
padding – {colour.utilities.message_box()}, Padding on each side of the message.
print_callable – {colour.utilities.message_box()}, Callable used to print the message box.
width – {colour.utilities.message_box()}, Message box width.

Returns:

Video signal colour primaries code point description.

Return type:

str

References

[FFmpegDevelopers22a], [InternationalOfStandardization13], [InternationalOfStandardization21], [InternationalOfStandardization20], [InternationalTUnion21]

Examples

>>> description = describe_video_signal_colour_primaries(1, width=75)
===========================================================================
*                                                                         *
*   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']                       *
*                                                                         *
===========================================================================
>>> description = describe_video_signal_colour_primaries(2, width=75)
===========================================================================
*                                                                         *
*   Colour Primaries: 2                                                   *
*   -------------------                                                   *
*                                                                         *
*   Primaries        : Unspecified                                        *
*   Whitepoint       : Unspecified                                        *
*   Whitepoint Name  : Unspecified                                        *
*   NPM              : Unspecified                                        *
*   NPM -1           : Unspecified                                        *
*   FFmpeg Constants : ['AVCOL_PRI_UNSPECIFIED', 'UNSPECIFIED']           *
*                                                                         *
===========================================================================
>>> description = describe_video_signal_colour_primaries(
...     FFmpegConstantsColourPrimaries_ITUTH273.JEDEC_P22, width=75
... )
===========================================================================
*                                                                         *
*   Colour Primaries: 22                                                  *
*   --------------------                                                  *
*                                                                         *
*   Primaries        : [[ 0.63   0.34 ]                                   *
*                       [ 0.295  0.605]                                   *
*                       [ 0.155  0.077]]                                  *
*   Whitepoint       : [ 0.3127  0.329 ]                                  *
*   Whitepoint Name  : D65                                                *
*   NPM              : [[ 0.42942013  0.3277917   0.1932441 ]             *
*                       [ 0.23175055  0.67225077  0.09599868]             *
*                       [ 0.02044858  0.11111583  0.95749334]]            *
*   NPM -1           : [[ 3.13288278 -1.44707454 -0.48720324]             *
*                       [-1.08850877  2.01538781  0.01762239]             *
*                       [ 0.05941301 -0.20297883  1.05275352]]            *
*   FFmpeg Constants : ['AVCOL_PRI_EBU3213', 'AVCOL_PRI_JEDEC_P22',       *
*   'EBU3213', 'JEDEC_P22']                                               *
*                                                                         *
===========================================================================