colour.io.read_LUT_IridasCube

colour.io.read_LUT_IridasCube(path: str) Union[colour.io.luts.lut.LUT3x1D, colour.io.luts.lut.LUT3D][source]

Read given Iridas .cube LUT file.

Parameters

path (str) – 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