[Bf-docboard-svn] bf-manual: [8939] branches/blender-3.1-release/blender_docs/manual: Compositing Convert color space node

[Aaron Carlisle]

Revision: 8939
          https://developer.blender.org/rBM8939
Author:   Blendify
Date:     2022-02-09 21:38:58 +0100 (Wed, 09 Feb 2022)
Log Message:
-----------
Compositing Convert color space node

rB6beaa297918b24de00d26886e981312b041748b0

Fixes T95186

Modified Paths:
--------------
    branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/index.rst
    branches/blender-3.1-release/blender_docs/manual/editors/image/image_settings.rst
    branches/blender-3.1-release/blender_docs/manual/render/color_management.rst

Added Paths:
-----------
    branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/color_space.rst
    branches/blender-3.1-release/blender_docs/manual/images/compositing_node-CompositorNodeConvertColorSpace.png

Added: branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/color_space.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/color_space.rst	                        (rev 0)
+++ branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/color_space.rst	2022-02-09 20:38:58 UTC (rev 8939)
@@ -0,0 +1,49 @@
+.. _bpy.types.CompositorNodeConvertColorSpace:
+
+****************
+Color Space Node
+****************
+
+.. figure:: /images/compositing_node-CompositorNodeConvertColorSpace.png
+   :align: right
+
+   Color Space Node.
+
+The *Color Space Node* converts images from one :term:`color spaces <Color Space>`.
+
+.. note::
+
+    Images are automatically converted into linear color space unless specified in the image's
+    :ref:`Colorspace <bpy.types.ColorManagedInputColorspaceSettings.name>` option.
+
+
+Inputs
+======
+
+Image
+   Standard color input.
+
+
+Properties
+==========
+
+From, To
+   The color space of the input image and the color space to convert the image to.
+
+   The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
+   Using the default config will list the following options:
+
+   :sRGB: Standard RGB display space.
+   :Linear: Linear 709 (full range). Blender native linear space.
+   :Linear ACES: ACES linear space.
+   :XYZ: Standard linear XYZ space.
+   :Non-Color: Color space used for images which contains non-color data (e.g. normal maps).
+   :Raw: Does not automatically convert to linear; same as Non-Color.
+   :Filmic Log: Intermediate log color space of Filmic view transform.
+
+
+Outputs
+=======
+
+Image
+   Standard color output.


Property changes on: branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/color_space.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/index.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/index.rst	2022-02-09 04:16:07 UTC (rev 8938)
+++ branches/blender-3.1-release/blender_docs/manual/compositing/types/converter/index.rst	2022-02-09 20:38:58 UTC (rev 8939)
@@ -16,6 +16,7 @@
    :maxdepth: 1
 
    alpha_convert.rst
+   color_space.rst
    color_ramp.rst
    combine_separate.rst
    id_mask.rst

Modified: branches/blender-3.1-release/blender_docs/manual/editors/image/image_settings.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/editors/image/image_settings.rst	2022-02-09 04:16:07 UTC (rev 8938)
+++ branches/blender-3.1-release/blender_docs/manual/editors/image/image_settings.rst	2022-02-09 20:38:58 UTC (rev 8939)
@@ -133,14 +133,19 @@
 .. _bpy.types.ColorManagedInputColorspaceSettings.name:
 
 Color Space
-   :term:`Color Space`.
+   The :term:`Color Space` the image file was saved in.
+   Once loaded into Blender, the color will be treated as linear color.
+   This option ensure the correct conversion to linear color is used.
 
+   The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
+   Using the default config will list the following options:
+
    :sRGB: Standard RGB display space.
    :Linear: Linear 709 (full range). Blender native linear space.
    :Linear ACES: ACES linear space.
    :XYZ: Standard linear XYZ space.
    :Non-Color: Color space used for images which contains non-color data (e.g. normal maps).
-   :Raw: Same as Non-Color.
+   :Raw: Does not automatically convert to linear; same as Non-Color.
    :Filmic Log: Intermediate log color space of Filmic view transform.
 
 .. _bpy.types.Image.alpha_mode:

Added: branches/blender-3.1-release/blender_docs/manual/images/compositing_node-CompositorNodeConvertColorSpace.png
===================================================================
(Binary files differ)

Index: branches/blender-3.1-release/blender_docs/manual/images/compositing_node-CompositorNodeConvertColorSpace.png
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/images/compositing_node-CompositorNodeConvertColorSpace.png	2022-02-09 04:16:07 UTC (rev 8938)
+++ branches/blender-3.1-release/blender_docs/manual/images/compositing_node-CompositorNodeConvertColorSpace.png	2022-02-09 20:38:58 UTC (rev 8939)

Property changes on: branches/blender-3.1-release/blender_docs/manual/images/compositing_node-CompositorNodeConvertColorSpace.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: branches/blender-3.1-release/blender_docs/manual/render/color_management.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/render/color_management.rst	2022-02-09 04:16:07 UTC (rev 8938)
+++ branches/blender-3.1-release/blender_docs/manual/render/color_management.rst	2022-02-09 20:38:58 UTC (rev 8939)
@@ -213,6 +213,8 @@
    This is useful for saving linear OpenEXR to e.g. PNG or JPEG files in display space.
 
 
+.. _ocio-config:
+
 OpenColorIO Configuration
 =========================