Implement support for "Look" transform.

Signed-off-by: Thomas Mansencal <[email protected]>

Author: KelSolaar

docs/opencolorio_config_aces.config.rst

@@ -19,6 +19,7 @@ Config Generation Common Objects
 
     colorspace_factory
     view_transform_factory
+    look_factory
     ConfigData
     validate_config
     generate_config

opencolorio_config_aces/config/__init__.py

@@ -2,7 +2,7 @@
 # Copyright Contributors to the OpenColorIO Project.
 
 from .generation import (ConfigData, colorspace_factory,
-                         view_transform_factory, generate_config,
+                         view_transform_factory, look_factory, generate_config,
                          validate_config)
 from .reference import (
     ColorspaceDescriptionStyle, build_aces_conversion_graph,
@@ -13,7 +13,7 @@
 
 __all__ = [
     'ConfigData', 'colorspace_factory', 'view_transform_factory',
-    'generate_config', 'validate_config'
+    'look_factory', 'generate_config', 'validate_config'
 ]
 __all__ += [
     'ColorspaceDescriptionStyle', 'build_aces_conversion_graph',

opencolorio_config_aces/config/generation/__init__.py

@@ -1,10 +1,10 @@
 # SPDX-License-Identifier: BSD-3-Clause
 # Copyright Contributors to the OpenColorIO Project.
 
-from .common import (colorspace_factory, view_transform_factory, ConfigData,
-                     validate_config, generate_config)
+from .common import (colorspace_factory, view_transform_factory, look_factory,
+                     ConfigData, validate_config, generate_config)
 
 __all__ = [
-    'colorspace_factory', 'view_transform_factory', 'ConfigData',
-    'validate_config', 'generate_config'
+    'colorspace_factory', 'view_transform_factory', 'look_factory',
+    'ConfigData', 'validate_config', 'generate_config'
 ]

opencolorio_config_aces/config/generation/common.py

@@ -29,7 +29,7 @@
 
 __all__ = [
     'LOG_ALLOCATION_VARS', 'colorspace_factory', 'view_transform_factory',
-    'ConfigData', 'validate_config', 'generate_config'
+    'look_factory', 'ConfigData', 'validate_config', 'generate_config'
 ]
 
 LOG_ALLOCATION_VARS = (-8, 5, 2**-8)
@@ -223,6 +223,64 @@ def view_transform_factory(name,
     return view_transform
 
 
+@required('OpenColorIO')
+def look_factory(name,
+                 process_space=None,
+                 description=None,
+                 forward_transform=None,
+                 inverse_transform=None,
+                 base_look=None):
+    """
+    *OpenColorIO* look factory.
+
+    Parameters
+    ----------
+    name : unicode
+        *OpenColorIO* look name.
+    process_space : unicode, optional
+        *OpenColorIO* look process space, e.g. *OpenColorIO* colorspace or role
+        name.
+    description : unicode, optional
+        *OpenColorIO* look description.
+    forward_transform : object, optional
+        *To Reference* *OpenColorIO* look transform.
+    inverse_transform : object, optional
+        *From Reference* *OpenColorIO* look transform.
+    base_look : ViewTransform, optional
+        Inherited *OpenColorIO* base look.
+
+    Returns
+    -------
+    Look
+        *OpenColorIO* look.
+    """
+
+    import PyOpenColorIO as ocio
+
+    if process_space is None:
+        process_space = ocio.ROLE_SCENE_LINEAR
+
+    if base_look is not None:
+        look = base_look
+    else:
+        look = ocio.Look()
+
+        look.setProcessSpace(process_space)
+
+        if forward_transform is not None:
+            look.setTransform(forward_transform)
+
+        if inverse_transform is not None:
+            look.setInverseTransform(inverse_transform)
+
+    look.setName(name)
+
+    if description is not None:
+        look.setDescription(description)
+
+    return look
+
+
 @dataclass
 class ConfigData:
     """
@@ -239,6 +297,9 @@ class ConfigData:
     colorspaces : array_like
         Config colorspaces, an iterable of
         :attr:`PyOpenColorIO.ColorSpace` class instances.
+    looks : array_like, optional
+        Config looks, an iterable of :attr:`PyOpenColorIO.Look` class
+        instances.
     view_transforms : array_like, optional
         Config view transforms, an iterable of
         :attr:`PyOpenColorIO.ViewTransform` class instances.
@@ -265,6 +326,7 @@ class ConfigData:
     description
     roles
     colorspaces
+    looks
     view_transforms
     inactive_colorspaces
     shared_views
@@ -280,6 +342,7 @@ class ConfigData:
         'An "OpenColorIO" config generated by "OpenColorIO-Config-ACES".')
     roles: Union[dict, OrderedDict] = field(default_factory=dict)
     colorspaces: Union[list, tuple] = field(default_factory=list)
+    looks: Union[list, tuple] = field(default_factory=list)
     view_transforms: Union[list, tuple] = field(default_factory=list)
     inactive_colorspaces: Union[list, tuple] = field(default_factory=list)
     shared_views: Union[list, tuple] = field(default_factory=list)
@@ -354,6 +417,10 @@ def generate_config(data, config_name=None, validate=True):
         logging.debug(f'Adding "{view_transform.getName()}" view transform.')
         config.addViewTransform(view_transform)
 
+    for look in data.looks:
+        logging.debug(f'Adding "{look.getName()}" look.')
+        config.addLook(look)
+
     if data.profile_version >= 2:
         logging.debug(f'Disabling "{data.inactive_colorspaces}" colorspaces.')
         config.setInactiveColorSpaces(','.join(data.inactive_colorspaces))
@@ -479,6 +546,10 @@ def generate_config(data, config_name=None, validate=True):
         'Colorspace',
         to_reference=ocio.ColorSpaceTransform('CCTF - sRGB', 'Gamut - sRGB'))
     colorspace_4 = colorspace_factory('Utility - Raw', 'Utility', is_data=True)
+    _red_cdl_transform = ocio.CDLTransform()
+    _red_cdl_transform.setSlope([0, 0, 0])
+    _red_cdl_transform.setOffset([1, 0, 0])
+    look_1 = look_factory('Look - Red', forward_transform=_red_cdl_transform)
     display_1 = colorspace_factory(
         'View - sRGB Monitor - sRGB', 'View', base_colorspace=colorspace_3)
 
@@ -487,6 +558,7 @@ def generate_config(data, config_name=None, validate=True):
         colorspaces=[
             colorspace_1, colorspace_2, colorspace_3, colorspace_4, display_1
         ],
+        looks=[look_1],
         views=[
             {
                 'display': 'sRGB Monitor',
@@ -526,6 +598,10 @@ def generate_config(data, config_name=None, validate=True):
     colorspace_4 = colorspace_factory(
         'CCTF - sRGB', 'CCTF', to_reference=transform)
     colorspace_5 = colorspace_factory('Utility - Raw', 'Utility', is_data=True)
+    _red_cdl_transform = ocio.CDLTransform()
+    _red_cdl_transform.setSlope([0, 0, 0])
+    _red_cdl_transform.setOffset([1, 0, 0])
+    look_1 = look_factory('Look - Red', forward_transform=_red_cdl_transform)
     interchange = colorspace_factory('CIE-XYZ D65')
     display_1 = colorspace_factory(
         'sRGB Monitor',
@@ -567,6 +643,7 @@ def generate_config(data, config_name=None, validate=True):
             colorspace_1, colorspace_2, colorspace_3, colorspace_4,
             colorspace_5, interchange, display_1, display_2
         ],
+        looks=[look_1],
         view_transforms=[view_transform_1, view_transform_2],
         inactive_colorspaces=['CIE-XYZ D65'],
         shared_views=shared_views,