colour.io.read_LUT_SonySPI3D

colour.io.read_LUT_SonySPI3D(path: str | PathLike) → LUT3D

Read the specified Sony .spi3d LUT file.

Parameters:

path (str | PathLike) – LUT file path.

Returns:

LUT3D class instance.

Return type:

colour.LUT3D

Examples

Reading an ordered and an unordered 3D Sony .spi3d LUT:

>>> import os
>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "sony_spi3d",
...     "Colour_Correct.spi3d",
... )
>>> print(read_LUT_SonySPI3D(path))
LUT3D - Colour Correct
----------------------

Dimensions : 3
Domain     : [[0. 0. 0.]
              [1. 1. 1.]]
Size       : (4, 4, 4, 3)
Comment 01 : Adapted from a LUT generated by Foundry::LUT.
>>> path = os.path.join(
...     os.path.dirname(__file__),
...     "tests",
...     "resources",
...     "sony_spi3d",
...     "Colour_Correct_Unordered.spi3d",
... )
>>> print(read_LUT_SonySPI3D(path))
LUT3D - Colour Correct Unordered
--------------------------------

Dimensions : 3
Domain     : [[0. 0. 0.]
              [1. 1. 1.]]
Size       : (4, 4, 4, 3)
Comment 01 : Adapted from a LUT generated by Foundry::LUT.