Add NamedTransform Processor constructors (#1689)

* Add NamedTransform Processor constructors

Signed-off-by: Michael Dolan <[email protected]>

* Update frozen Python API docs

Signed-off-by: Michael Dolan <[email protected]>

* Add NamedTransform::GetTransform static function to public API

Signed-off-by: Michael Dolan <[email protected]>

* Move function from NamedTransformImpl to NamedTransform

Signed-off-by: Michael Dolan <[email protected]>

* Update Python frozen rst with API changes

Signed-off-by: Michael Dolan <[email protected]>

* Update comment and variable naming

Signed-off-by: Michael Dolan <[email protected]>

Signed-off-by: Michael Dolan <[email protected]>

Author: michdolan

docs/api/python/frozen/pyopencolorio_allocation.rst

@@ -31,3 +31,7 @@
       :module: PyOpenColorIO
       :value: <Allocation.ALLOCATION_UNKNOWN: 0>
 
+
+   .. py:property:: Allocation.value
+      :module: PyOpenColorIO
+

docs/api/python/frozen/pyopencolorio_baker.rst

@@ -61,6 +61,10 @@
       :module: PyOpenColorIO
 
 
+   .. py:method:: Baker.getDisplay(self: PyOpenColorIO.Baker) -> str
+      :module: PyOpenColorIO
+
+
    .. py:method:: Baker.getFormat(self: PyOpenColorIO.Baker) -> str
       :module: PyOpenColorIO
 
@@ -94,6 +98,10 @@
       :module: PyOpenColorIO
 
 
+   .. py:method:: Baker.getView(self: PyOpenColorIO.Baker) -> str
+      :module: PyOpenColorIO
+
+
    .. py:method:: Baker.setConfig(self: PyOpenColorIO.Baker, config: PyOpenColorIO.Config) -> None
       :module: PyOpenColorIO
 
@@ -103,7 +111,13 @@
    .. py:method:: Baker.setCubeSize(self: PyOpenColorIO.Baker, cubeSize: int) -> None
       :module: PyOpenColorIO
 
-      Override the default cube sample size. default: <format specific>
+      Override the main LUT (3d or 1d) sample size. Default value is -1, which allows each format to use its own most appropriate size.
+
+
+   .. py:method:: Baker.setDisplayView(self: PyOpenColorIO.Baker, display: str, view: str) -> None
+      :module: PyOpenColorIO
+
+      Set the display and view to apply during the baking. Must not be used if setTargetSpace is used.
 
 
    .. py:method:: Baker.setFormat(self: PyOpenColorIO.Baker, formatName: str) -> None
@@ -133,13 +147,13 @@
    .. py:method:: Baker.setShaperSpace(self: PyOpenColorIO.Baker, shaperSpace: str) -> None
       :module: PyOpenColorIO
 
-      Set an *optional* :ref:`ColorSpace` to be used to shape / transfer the input colorspace. This is mostly used to allocate an HDR luminance range into an LDR one. If a shaper space is not explicitly specified, and the file format supports one, the :ref:`ColorSpace` Allocation will be used (not implemented for all formats).
+      Set an *optional* :ref:`ColorSpace` to shape the incoming values of the LUT. When baking 3DLUT, this will correspond to the 1D shaper used to normalise incoming values to the unit range. When baking 1D LUT, this will be used to determine the input range of the LUT.
 
 
    .. py:method:: Baker.setTargetSpace(self: PyOpenColorIO.Baker, targetSpace: str) -> None
       :module: PyOpenColorIO
 
-      Set the target device colorspace for the LUT.
+      Set the target (i.e., output) color space for the LUT. Must not be used if setDisplayView is used.
 
 
 .. py:class:: FormatIterator

docs/api/python/frozen/pyopencolorio_bitdepth.rst

@@ -22,7 +22,7 @@
 
      BIT_DEPTH_UINT16 :
 
-     BIT_DEPTH_UINT32 :
+     BIT_DEPTH_UINT32 : Here for historical reason but that's not supported.
 
      BIT_DEPTH_F16 :
 
@@ -75,3 +75,7 @@
       :module: PyOpenColorIO
       :value: <BitDepth.BIT_DEPTH_UNKNOWN: 0>
 
+
+   .. py:property:: BitDepth.value
+      :module: PyOpenColorIO
+

docs/api/python/frozen/pyopencolorio_cdlstyle.rst

@@ -31,3 +31,7 @@
       :module: PyOpenColorIO
       :value: <CDLStyle.CDL_NO_CLAMP: 1>
 
+
+   .. py:property:: CDLStyle.value
+      :module: PyOpenColorIO
+

docs/api/python/frozen/pyopencolorio_channelordering.rst

@@ -47,3 +47,7 @@
       :module: PyOpenColorIO
       :value: <ChannelOrdering.CHANNEL_ORDERING_RGBA: 0>
 
+
+   .. py:property:: ChannelOrdering.value
+      :module: PyOpenColorIO
+

docs/api/python/frozen/pyopencolorio_colorspace.rst

@@ -10,8 +10,6 @@
 
    While a complete discussion of color spaces is beyond the scope of header documentation, traditional uses would be to have *ColorSpaces* corresponding to: physical capture devices (known cameras, scanners), and internal 'convenience' spaces (such as scene linear, logarithmic).
 
-   *ColorSpaces* are specific to a particular image precision (float32, uint8, etc.), and the set of ColorSpaces that provide equivalent mappings (at different precisions) are referred to as a 'family'.
-
 
    .. py:method:: ColorSpace.__init__(*args, **kwargs)
       :module: PyOpenColorIO
@@ -97,7 +95,7 @@
    .. py:method:: ColorSpace.getEqualityGroup(self: PyOpenColorIO.ColorSpace) -> str
       :module: PyOpenColorIO
 
-      Get the :ref:`ColorSpace` group name (used for equality comparisons) This allows no-op transforms between different colorspaces. If an equalityGroup is not defined (an empty string), it will be considered unique (i.e., it will not compare as equal to other ColorSpaces with an empty equality group). This is often, though not always, set to the same value as 'family'.
+      Get the :ref:`ColorSpace` group name (used for equality comparisons) This allows no-op transforms between different colorspaces. If an equalityGroup is not defined (an empty string), it will be considered unique (i.e., it will not compare as equal to other ColorSpaces with an empty equality group).
 
 
    .. py:method:: ColorSpace.getFamily(self: PyOpenColorIO.ColorSpace) -> str

docs/api/python/frozen/pyopencolorio_colorspacedirection.rst

@@ -24,3 +24,7 @@
       :module: PyOpenColorIO
       :value: <ColorSpaceDirection.COLORSPACE_DIR_TO_REFERENCE: 0>
 
+
+   .. py:property:: ColorSpaceDirection.value
+      :module: PyOpenColorIO
+

docs/api/python/frozen/pyopencolorio_colorspacevisibility.rst

@@ -31,3 +31,7 @@
       :module: PyOpenColorIO
       :value: <ColorSpaceVisibility.COLORSPACE_INACTIVE: 1>
 
+
+   .. py:property:: ColorSpaceVisibility.value
+      :module: PyOpenColorIO
+