"""
SMPTE 240M Colourspace
======================

Define the *SMPTE 240M* colourspace:

-   :attr:`colour.models.RGB_COLOURSPACE_SMPTE_240M`.

References
----------
-   :cite:`SocietyofMotionPictureandTelevisionEngineers1999b` : Society of
    Motion Picture and Television Engineers. (1999). ANSI/SMPTE 240M-1995 -
    Signal Parameters - 1125-Line High-Definition Production Systems (pp. 1-7).
    http://car.france3.mars.free.fr/HD/INA-%2026%20jan%2006/\
SMPTE%20normes%20et%20confs/s240m.pdf
"""

from __future__ import annotations

import typing

import numpy as np

from colour.colorimetry import CCS_ILLUMINANTS

if typing.TYPE_CHECKING:
    from colour.hints import NDArrayFloat

from colour.models.rgb import (
    RGB_Colourspace,
    eotf_SMPTE240M,
    normalised_primary_matrix,
    oetf_SMPTE240M,
)

__author__ = "Colour Developers"
__copyright__ = "Copyright 2013 Colour Developers"
__license__ = "BSD-3-Clause - https://opensource.org/licenses/BSD-3-Clause"
__maintainer__ = "Colour Developers"
__email__ = "colour-developers@colour-science.org"
__status__ = "Production"

__all__ = [
    "PRIMARIES_SMPTE_240M",
    "WHITEPOINT_NAME_SMPTE_240M",
    "CCS_WHITEPOINT_SMPTE_240M",
    "MATRIX_SMPTE_240M_TO_XYZ",
    "MATRIX_XYZ_TO_SMPTE_240M",
    "RGB_COLOURSPACE_SMPTE_240M",
]

PRIMARIES_SMPTE_240M: NDArrayFloat = np.array(
    [
        [0.6300, 0.3400],
        [0.3100, 0.5950],
        [0.1550, 0.0700],
    ]
)
"""*SMPTE 240M* colourspace primaries."""

WHITEPOINT_NAME_SMPTE_240M: str = "D65"
"""*SMPTE 240M* colourspace whitepoint name."""

CCS_WHITEPOINT_SMPTE_240M: NDArrayFloat = CCS_ILLUMINANTS[
    "CIE 1931 2 Degree Standard Observer"
][WHITEPOINT_NAME_SMPTE_240M]
"""*SMPTE 240M* colourspace whitepoint chromaticity coordinates."""

MATRIX_SMPTE_240M_TO_XYZ: NDArrayFloat = normalised_primary_matrix(
    PRIMARIES_SMPTE_240M, CCS_WHITEPOINT_SMPTE_240M
)
"""*SMPTE 240M* colourspace to *CIE XYZ* tristimulus values matrix."""

MATRIX_XYZ_TO_SMPTE_240M: NDArrayFloat = np.linalg.inv(MATRIX_SMPTE_240M_TO_XYZ)
"""*CIE XYZ* tristimulus values to *SMPTE 240M* colourspace matrix."""

RGB_COLOURSPACE_SMPTE_240M: RGB_Colourspace = RGB_Colourspace(
    "SMPTE 240M",
    PRIMARIES_SMPTE_240M,
    CCS_WHITEPOINT_SMPTE_240M,
    WHITEPOINT_NAME_SMPTE_240M,
    MATRIX_SMPTE_240M_TO_XYZ,
    MATRIX_XYZ_TO_SMPTE_240M,
    oetf_SMPTE240M,
    eotf_SMPTE240M,
)
RGB_COLOURSPACE_SMPTE_240M.__doc__ = """
*SMPTE 240M* colourspace.

References
----------
:cite:`SocietyofMotionPictureandTelevisionEngineers1999b`,
"""
