Coverage for models/rgb/datasets/display_p3.py: 0%
25 statements
« prev ^ index » next coverage.py v7.11.0, created at 2025-11-16 22:49 +1300
« prev ^ index » next coverage.py v7.11.0, created at 2025-11-16 22:49 +1300
1"""
2Display P3 Colourspace
3======================
5Define the *Display P3* colourspace:
7- :attr:`colour.models.RGB_COLOURSPACE_DISPLAY_P3`.
9References
10----------
11- :cite:`AppleInc.2019` : Apple. (2019). Apple Inc. (2019). displayP3.
12 Retrieved December 18, 2019, from https://developer.apple.com/\
13documentation/coregraphics/cgcolorspace/1408916-displayp3
14"""
16from __future__ import annotations
18import typing
20import numpy as np
22from colour.colorimetry import CCS_ILLUMINANTS
24if typing.TYPE_CHECKING:
25 from colour.hints import NDArrayFloat
27from colour.models.rgb import (
28 RGB_Colourspace,
29 eotf_inverse_sRGB,
30 eotf_sRGB,
31 normalised_primary_matrix,
32)
33from colour.models.rgb.datasets import RGB_COLOURSPACE_DCI_P3
35__author__ = "Colour Developers"
36__copyright__ = "Copyright 2013 Colour Developers"
37__license__ = "BSD-3-Clause - https://opensource.org/licenses/BSD-3-Clause"
38__maintainer__ = "Colour Developers"
39__email__ = "colour-science@googlegroups.com"
40__status__ = "Production"
42__all__ = [
43 "PRIMARIES_DISPLAY_P3",
44 "WHITEPOINT_NAME_DISPLAY_P3",
45 "CCS_WHITEPOINT_DISPLAY_P3",
46 "MATRIX_DISPLAY_P3_TO_XYZ",
47 "MATRIX_XYZ_TO_DISPLAY_P3",
48 "RGB_COLOURSPACE_DISPLAY_P3",
49]
51PRIMARIES_DISPLAY_P3: NDArrayFloat = RGB_COLOURSPACE_DCI_P3.primaries
52"""*Display P3* colourspace primaries."""
54WHITEPOINT_NAME_DISPLAY_P3: str = "D65"
55"""*Display P3* colourspace whitepoint name."""
57CCS_WHITEPOINT_DISPLAY_P3: NDArrayFloat = CCS_ILLUMINANTS[
58 "CIE 1931 2 Degree Standard Observer"
59][WHITEPOINT_NAME_DISPLAY_P3]
60"""*Display P3* colourspace whitepoint chromaticity coordinates."""
62MATRIX_DISPLAY_P3_TO_XYZ: NDArrayFloat = normalised_primary_matrix(
63 PRIMARIES_DISPLAY_P3, CCS_WHITEPOINT_DISPLAY_P3
64)
65"""*Display P3* colourspace to *CIE XYZ* tristimulus values matrix."""
67MATRIX_XYZ_TO_DISPLAY_P3: NDArrayFloat = np.linalg.inv(MATRIX_DISPLAY_P3_TO_XYZ)
68"""*CIE XYZ* tristimulus values to *Display P3* colourspace matrix."""
70RGB_COLOURSPACE_DISPLAY_P3: RGB_Colourspace = RGB_Colourspace(
71 "Display P3",
72 PRIMARIES_DISPLAY_P3,
73 CCS_WHITEPOINT_DISPLAY_P3,
74 WHITEPOINT_NAME_DISPLAY_P3,
75 MATRIX_DISPLAY_P3_TO_XYZ,
76 MATRIX_XYZ_TO_DISPLAY_P3,
77 eotf_inverse_sRGB,
78 eotf_sRGB,
79)
80RGB_COLOURSPACE_DISPLAY_P3.__doc__ = """
81*Display P3* colourspace.
83References
84----------
85:cite:`AppleInc.2019`
86"""