import PyOpenColorIO as ocio
-import aces_ocio.lut as genlut
+import aces_ocio.generate_lut as genlut
from aces_ocio.colorspaces import aces
from aces_ocio.utilities import ColorSpace, mat44_from_mat33
to_reference_values=None,
aliases=None):
"""
- Object description.
+ Creates a ColorSpace that only uses *Matrix Transforms*
Parameters
----------
- parameter : type
- Parameter description.
+ name : str, optional
+ Aliases for this colorspace
+ from_reference_values : list of matrices
+ List of matrices to convert from the reference colorspace to this space
+ to_reference_values : list of matrices
+ List of matrices to convert to the reference colorspace from this space
+ aliases : list of str, optional
+ Aliases for this colorspace
Returns
-------
- type
- Return value description.
+ ColorSpace
+ A *Matrix Transform*-based ColorSpace
"""
if from_reference_values is None:
lut_resolution_1d=1024,
aliases=None):
"""
- Object description.
+ Creates a ColorSpace that only uses transfer functions encoded as 1D LUTs
Parameters
----------
- parameter : type
- Parameter description.
+ name : str, optional
+ Aliases for this colorspace
+ transfer_function_name : str, optional
+ The name of the transfer function
+ transfer_function : function, optional
+ The transfer function to be evaluated
+ lut_directory : str or unicode
+ The directory to use when generating LUTs
+ lut_resolution_1d : int
+ The resolution of generated 1D LUTs
+ aliases : list of str
+ Aliases for this colorspace
Returns
-------
- type
- Return value description.
+ ColorSpace
+ A *LUT1D Transform*-based ColorSpace representing a transfer function
"""
if aliases is None:
to_reference_values=None,
aliases=None):
"""
- Object description.
+ Creates a ColorSpace that uses transfer functions encoded as 1D LUTs and
+ matrice
Parameters
----------
- parameter : type
- Parameter description.
+ name : str, optional
+ Aliases for this colorspace
+ transfer_function_name : str, optional
+ The name of the transfer function
+ transfer_function : function, optional
+ The transfer function to be evaluated
+ lut_directory : str or unicode
+ The directory to use when generating LUTs
+ lut_resolution_1d : int
+ The resolution of generated 1D LUTs
+ from_reference_values : list of matrices
+ List of matrices to convert from the reference colorspace to this space
+ to_reference_values : list of matrices
+ List of matrices to convert to the reference colorspace from this space
+ aliases : list of str
+ Aliases for this colorspace
Returns
-------
- type
- Return value description.
+ ColorSpace
+ A *Matrx and LUT1D Transform*-based ColorSpace representing a transfer
+ function and matrix
"""
if from_reference_values is None:
# Transfer functions for standard colorspaces.
def transfer_function_sRGB_to_linear(v):
+ """
+ The sRGB (IEC 61966-2-1) transfer function
+
+ Parameters
+ ----------
+ v : float
+ The normalized value to pass through the function
+
+ Returns
+ -------
+ float
+ A converted value
+ """
a = 1.055
b = 0.04045
d = 12.92
def transfer_function_Rec709_to_linear(v):
+ """
+ The Rec.709 transfer function
+
+ Parameters
+ ----------
+ v : float
+ The normalized value to pass through the function
+
+ Returns
+ -------
+ float
+ A converted value
+ """
a = 1.099
b = 0.018
d = 4.5
def transfer_function_Rec2020_10bit_to_linear(v):
+ """
+ The Rec.2020 10-bit transfer function
+
+ Parameters
+ ----------
+ v : float
+ The normalized value to pass through the function
+
+ Returns
+ -------
+ float
+ A converted value
+ """
a = 1.099
b = 0.018
d = 4.5
def transfer_function_Rec2020_12bit_to_linear(v):
+ """
+ The Rec.2020 12-bit transfer function
+
+ Parameters
+ ----------
+ v : float
+ The normalized value to pass through the function
+
+ Returns
+ -------
+ float
+ A converted value
+ """
a = 1.0993
b = 0.0181
d = 4.5
def transfer_function_Rec1886_to_linear(v):
+ """
+ The Rec.1886 transfer function
+
+ Parameters
+ ----------
+ v : float
+ The normalized value to pass through the function
+
+ Returns
+ -------
+ float
+ A converted value
+ """
g = 2.4
Lw = 1
Lb = 0
Parameters
----------
- parameter : type
- Parameter description.
+ lut_directory : str or unicode
+ The directory to use when generating LUTs
+ lut_resolution_1d : int
+ The resolution of generated 1D LUTs
Returns
-------
- type
- Return value description.
+ list
+ A list of colorspaces for general colorspaces and encodings
"""
colorspaces = []
# -------------------------------------------------------------------------
# XYZ
# -------------------------------------------------------------------------
- cs = create_matrix_colorspace('XYZ-D60',
+ cs = create_matrix_colorspace('XYZ - D60',
to_reference_values=[aces.ACES_XYZ_TO_AP0],
from_reference_values=[aces.ACES_AP0_TO_XYZ],
aliases=['lin_xyz_d60'])
# -------------------------------------------------------------------------
# P3-DCI
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *P3DCI* primaries
- XYZ_to_P3DCI = [2.7253940305, -1.0180030062, -0.4401631952,
- -0.7951680258, 1.6897320548, 0.0226471906,
- 0.0412418914, -0.0876390192, 1.1009293786]
+ # *ACES* to *Linear*, *P3DCI* primaries, using Bradford chromatic
+ # adaptation
+ XYZ_to_P3DCI = [2.66286135, -1.11031783, -0.42271635,
+ -0.82282376, 1.75861704, 0.02502194,
+ 0.03932561, -0.08383448, 1.0372175]
cs = create_matrix_colorspace(
'Linear - P3-DCI',
# -------------------------------------------------------------------------
# sRGB
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *Rec. 709* primaries.
# *sRGB* and *Rec 709* use the same gamut.
- XYZ_to_Rec709 = [3.2409699419, -1.5373831776, -0.4986107603,
- -0.9692436363, 1.8759675015, 0.0415550574,
- 0.0556300797, -0.2039769589, 1.0569715142]
+
+ # *ACES* to *Linear*, *Rec. 709* primaries, D65 white point, using
+ # Bradford chromatic adaptation
+ XYZ_to_Rec709 = [3.20959735, -1.55742955, -0.49580497,
+ -0.97098887, 1.88517118, 0.03948941,
+ 0.05971934, -0.21010444, 1.14312482]
cs = create_matrix_colorspace(
'Linear - sRGB',
# *ACES* to *sRGB* Primaries + Transfer Function*
cs = create_matrix_plus_transfer_colorspace(
- 'sRGB',
+ 'sRGB - Texture',
'sRGB',
transfer_function_sRGB_to_linear,
lut_directory,
lut_resolution_1d,
from_reference_values=[aces.ACES_AP0_TO_XYZ, XYZ_to_Rec709],
- aliases=['srgb'])
+ aliases=['srgb_texture'])
colorspaces.append(cs)
# -------------------------------------------------------------------------
# Rec 709
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *Rec. 709* primaries
- XYZ_to_Rec709 = [3.2409699419, -1.5373831776, -0.4986107603,
- -0.9692436363, 1.8759675015, 0.0415550574,
- 0.0556300797, -0.2039769589, 1.0569715142]
-
+ # *sRGB* and *Rec 709* use the same gamut.
cs = create_matrix_colorspace(
'Linear - Rec.709',
from_reference_values=[aces.ACES_AP0_TO_XYZ, XYZ_to_Rec709],
# -------------------------------------------------------------------------
# Rec 2020
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *Rec. 2020* primaries
- XYZ_to_Rec2020 = [1.7166511880, -0.3556707838, -0.2533662814,
- -0.6666843518, 1.6164812366, 0.0157685458,
- 0.0176398574, -0.0427706133, 0.9421031212]
+ # *ACES* to *Linear*, *Rec. 2020* primaries, D65 white point, using
+ # Bradford chromatic adaptation
+ XYZ_to_Rec2020 = [1.69662619, -0.36551982, -0.24857099,
+ -0.67039877, 1.62348187, 0.01503821,
+ 0.02063163, -0.04775634, 1.01910818]
cs = create_matrix_colorspace(
'Linear - Rec.2020',
aliases=['crv_rec1886'])
colorspaces.append(cs)
- # *ACES* to *sRGB* Primaries + Transfer Function*
+ # *ACES* to *Rec. 709* Primaries + Transfer Function*
cs = create_matrix_plus_transfer_colorspace(
'Rec.709 - Display',
'rec1886',
aliases=['rec709_display'])
colorspaces.append(cs)
- # *ACES* to *sRGB* Primaries + Transfer Function*
+ # *ACES* to *Rec. 2020* Primaries + Transfer Function*
cs = create_matrix_plus_transfer_colorspace(
'Rec.2020 - Display',
'rec1886',
# -------------------------------------------------------------------------
# ProPhoto
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *Pro Photo* primaries
+ # *ACES* to *Linear*, *Pro Photo* primaries, D50 white point, using
+ # Bradford chromatic adaptation
AP0_to_RIMM = [1.2412367771, -0.1685692287, -0.0726675484,
0.0061203066, 1.083151174, -0.0892714806,
-0.0032853314, 0.0099796402, 0.9933056912]
# -------------------------------------------------------------------------
# Adobe RGB
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *Adobe RGB* primaries
+ # *ACES* to *Linear*, *Adobe RGB* primaries, D65 white point, using
+ # Bradford chromatic adaptation
AP0_to_ADOBERGB = [1.7245603168, -0.4199935942, -0.3045667227,
-0.2764799142, 1.3727190877, -0.0962391734,
-0.0261255258, -0.0901747807, 1.1163003065]
# -------------------------------------------------------------------------
# Adobe Wide Gamut RGB
# -------------------------------------------------------------------------
- # *ACES* to *Linear*, *Adobe Wide Gamut RGB* primaries
- AP0_to_ADOBERGB = [1.3809814778, -0.1158594573, -0.2651220205,
- 0.0057015535, 1.0402949043, -0.0459964578,
- -0.0038908746, -0.0597091815, 1.0636000561]
+ # *ACES* to *Linear*, *Adobe Wide Gamut RGB* primaries, D50 white point,
+ # using Bradford chromatic adaptation
+ AP0_to_ADOBEWIDEGAMUT = [1.3809814778, -0.1158594573, -0.2651220205,
+ 0.0057015535, 1.0402949043, -0.0459964578,
+ -0.0038908746, -0.0597091815, 1.0636000561]
cs = create_matrix_colorspace(
'Linear - Adobe Wide Gamut RGB',
- from_reference_values=[AP0_to_ADOBERGB],
+ from_reference_values=[AP0_to_ADOBEWIDEGAMUT],
aliases=['lin_adobewidegamutrgb'])
colorspaces.append(cs)
def create_raw():
+ """
+ Creates the *raw* color space
+
+ Parameters
+ ----------
+ None
+
+ Returns
+ -------
+ ColorSpace
+ *raw* and all its identifying information
+ """
# *Raw* utility space
name = 'Raw'
raw = ColorSpace(name)