colour.io.read_LUT_Cinespace#

colour.io.read_LUT_Cinespace(path: str | Path) LUT3x1D | LUT3D | LUTSequence[source]#

Read given Cinespace .csp LUT file.

Parameters:

path (str | Path) – LUT path.

Returns:

LUT3x1D or LUT3D or LUTSequence class instance.

Return type:

colour.LUT3x1D or colour.LUT3D or colour.LUTSequence

References

[RisingSResearch]

Examples

Reading a 3x1D Cinespace .csp LUT:

>>> import os
>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "cinespace",
...     "ACES_Proxy_10_to_ACES.csp",
... )
>>> print(read_LUT_Cinespace(path))
LUT3x1D - ACES Proxy 10 to ACES
-------------------------------

Dimensions : 2
Domain     : [[ 0.  0.  0.]
              [ 1.  1.  1.]]
Size       : (32, 3)

Reading a 3D Cinespace .csp LUT:

>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "cinespace",
...     "Colour_Correct.csp",
... )
>>> print(read_LUT_Cinespace(path))
LUT3D - Generated by Foundry::LUT
---------------------------------

Dimensions : 3
Domain     : [[ 0.  0.  0.]
              [ 1.  1.  1.]]
Size       : (4, 4, 4, 3)