colour.io.read_LUT_IridasCube#

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

Read given Iridas .cube LUT file.

Parameters:

path (str | Path) – LUT path.

Returns:

LUT3x1D or LUT3D class instance.

Return type:

LUT3x1D or LUT3D.

References

[AdobeSystems13c]

Examples

Reading a 3x1D Iridas .cube LUT:

>>> import os
>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "iridas_cube",
...     "ACES_Proxy_10_to_ACES.cube",
... )
>>> print(read_LUT_IridasCube(path))
LUT3x1D - ACES Proxy 10 to ACES
-------------------------------

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

Reading a 3D Iridas .cube LUT:

>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "iridas_cube",
...     "Colour_Correct.cube",
... )
>>> print(read_LUT_IridasCube(path))
LUT3D - Generated by Foundry::LUT
---------------------------------

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

Reading a 3D Iridas .cube LUT with comments:

>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "iridas_cube",
...     "Demo.cube",
... )
>>> print(read_LUT_IridasCube(path))
LUT3x1D - Demo
--------------

Dimensions : 2
Domain     : [[ 0.  0.  0.]
              [ 1.  2.  3.]]
Size       : (3, 3)
Comment 01 : Comments can go anywhere