[Bf-docboard-svn] bf-manual: [9273] branches/blender-3.2-release/blender_docs/manual: Expand and clarify the varius color space options

Aaron Carlisle noreply at blender.org
Wed May 11 02:37:49 CEST 2022 

Revision: 9273
          https://developer.blender.org/rBM9273
Author:   Blendify
Date:     2022-05-11 02:37:49 +0200 (Wed, 11 May 2022)
Log Message:
-----------
Expand and clarify the varius color space options

Modified Paths:
--------------
    branches/blender-3.2-release/blender_docs/manual/compositing/types/converter/color_space.rst
    branches/blender-3.2-release/blender_docs/manual/editors/image/image_settings.rst
    branches/blender-3.2-release/blender_docs/manual/editors/video_sequencer/sequencer/sidebar/strip.rst
    branches/blender-3.2-release/blender_docs/manual/glossary/index.rst
    branches/blender-3.2-release/blender_docs/manual/render/color_management.rst
    branches/blender-3.2-release/blender_docs/manual/render/shader_nodes/textures/environment.rst
    branches/blender-3.2-release/blender_docs/manual/render/shader_nodes/textures/image.rst

Modified: branches/blender-3.2-release/blender_docs/manual/compositing/types/converter/color_space.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/compositing/types/converter/color_space.rst	2022-05-10 23:48:34 UTC (rev 9272)
+++ branches/blender-3.2-release/blender_docs/manual/compositing/types/converter/color_space.rst	2022-05-11 00:37:49 UTC (rev 9273)
@@ -12,8 +12,8 @@
 
 .. note::
 
-    Images are automatically converted into linear color space unless specified in the image's
-    :ref:`Colorspace <bpy.types.ColorManagedInputColorspaceSettings.name>` option.
+    Images are already automatically converted into linear color space unless specified in the image's
+    :ref:`Color Space <bpy.types.ColorManagedInputColorspaceSettings.name>` option.
 
 
 Inputs
@@ -30,17 +30,10 @@
    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:
+   The default supported color spaces are described in detail here:
+   :ref:`Default OpenColorIO Configuration <ocio-config-default-color-spaces>`
 
-   :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
 =======
 

Modified: branches/blender-3.2-release/blender_docs/manual/editors/image/image_settings.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/editors/image/image_settings.rst	2022-05-10 23:48:34 UTC (rev 9272)
+++ branches/blender-3.2-release/blender_docs/manual/editors/image/image_settings.rst	2022-05-11 00:37:49 UTC (rev 9273)
@@ -137,17 +137,16 @@
    Once loaded into Blender, the color will be treated as linear color.
    This option ensure the correct conversion to linear color is used.
 
+   Texture's color, and final renders are  often stored in sRGB,
+   while OpenEXR images are stored in a linear color space.
+   Some images such as normal, bump or stencil maps do not strictly contain 'colors',
+   and on such values, no color space conversion should ever be applied.
+   For such images, the color space should be set to *Non-Color*.
+
    The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
-   Using the default config will list the following options:
+   The default supported color spaces are described in detail here:
+   :ref:`Default OpenColorIO Configuration <ocio-config-default-color-spaces>`
 
-   :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.
-
 .. _bpy.types.Image.alpha_mode:
 
 Alpha

Modified: branches/blender-3.2-release/blender_docs/manual/editors/video_sequencer/sequencer/sidebar/strip.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/editors/video_sequencer/sequencer/sidebar/strip.rst	2022-05-10 23:48:34 UTC (rev 9272)
+++ branches/blender-3.2-release/blender_docs/manual/editors/video_sequencer/sequencer/sidebar/strip.rst	2022-05-11 00:37:49 UTC (rev 9273)
@@ -219,6 +219,10 @@
    based on the specified amount of previous frames (e.g. 15 for MPEG-2 DVD).
 Color Space
    To specify the color space of the source file.
+
+   The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
+   The default supported color spaces are described in detail here:
+   :ref:`Default OpenColorIO Configuration <ocio-config-default-color-spaces>`
 Alpha Mode
    If the source file has an Alpha (transparency) channel, you can choose:
 

Modified: branches/blender-3.2-release/blender_docs/manual/glossary/index.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/glossary/index.rst	2022-05-10 23:48:34 UTC (rev 9272)
+++ branches/blender-3.2-release/blender_docs/manual/glossary/index.rst	2022-05-11 00:37:49 UTC (rev 9273)
@@ -218,9 +218,13 @@
       - The :term:`White Point`
       - A transfer function
 
+      The color spaces supported by Blender depend on the active :ref:`OCIO config <ocio-config>`.
+      The default supported color spaces are described in detail here:
+      :ref:`Default OpenColorIO Configuration <ocio-config-default-color-spaces>`
+
       sRGB
-         A color space that uses the Rec .709 :term:`Primaries` and white point but,
-         with a slightly different transfer function.
+         A color space that uses the Rec .709 :term:`Primaries` and a D65 white point,
+         and 2.2 gamma correction value as the transfer function.
 
    Concave Face
       Face in which one vertex is inside a triangle formed by other vertices of the face.

Modified: branches/blender-3.2-release/blender_docs/manual/render/color_management.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/render/color_management.rst	2022-05-10 23:48:34 UTC (rev 9272)
+++ branches/blender-3.2-release/blender_docs/manual/render/color_management.rst	2022-05-11 00:37:49 UTC (rev 9273)
@@ -167,7 +167,11 @@
    but it can also be set to work in Linear space like the Compositing nodes, or another color space.
    Different color spaces will give different results for color correction, crossfades, and other operations.
 
+   The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
+   The default supported color spaces are described in detail here:
+   :ref:`Default OpenColorIO Configuration <ocio-config-default-color-spaces>`
 
+
 .. _bpy.types.ColorManagedViewSettings.use_curve_mapping:
 
 Use Curves
@@ -187,17 +191,11 @@
 Those images should be marked as *Non-Color Data*.
 
 Image data-blocks will always store float buffers in memory in the scene linear color space,
-while a byte buffer in memory and files in a drive are stored in the color space specified with this setting:
+while a byte buffer in memory and files in a drive are stored in the specified
+:ref:`color space <bpy.types.ColorManagedInputColorspaceSettings.name>` setting.
 
-Color Space
-   The color space of the image file on a drive. This depends on the file format,
-   for example, PNG or JPEG images are often stored in sRGB, while OpenEXR images are stored in a linear color space.
-   Some images such as normal, bump or stencil maps do not strictly contain 'colors',
-   and on such values, no color space conversion should ever be applied.
-   For such images, the color space should be set to *Non-Color*.
-
-By default only renders are displayed and saved with the render view transformations applied.
-These are the Render Result and Viewer image data-blocks,
+By default, only renders are displayed and saved with the render *View Transformation* applied.
+These images are the "Render Result" and "Viewer" image data-blocks,
 and the files saved directly to a drive with the Render Animation operator.
 However, when loading a render saved to an intermediate OpenEXR file,
 Blender cannot detect automatically that this is a render
@@ -223,7 +221,7 @@
 The reference linear :term:`Color Space` used is the linear color space
 with Rec. 709 chromaticities and D65 white point.
 
-However, OpenColorIO was also designed to give a consistent user experience across
+However, OpenColorIO is also designed to give a consistent user experience across
 `multiple applications <https://opencolorio.org/#supported_apps>`__,
 and for this, a single shared configuration file can be used.
 Blender will use the standard OCIO environment variable to read an OpenColorIO configuration
@@ -257,3 +255,22 @@
 an ACES specific configuration file should be used. OpenColorIO provides
 an `ACES configuration <https://opencolorio.readthedocs.io/en/latest/configurations/_index.html>`__ file,
 though it may need a few more tweaks to be usable in production.
+
+
+Default OpenColorIO Configuration
+=================================
+
+.. _ocio-config-default-color-spaces:
+
+Color Spaces
+   Blender's OCIO configuration file is equipped by default to read/write files in these color spaces:
+
+   :sRGB: Standard RGB display space using Rec. 709 chromaticities and a D65 white point.
+   :Linear:
+      Blender's native linear space meaning there is no gamma mapping,
+      using Linear Rec. 709 chromaticities and a D65 white point.
+   :Linear ACES: ACES linear space using AP0 RGB primaries and a white point close to D60.
+   :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.

Modified: branches/blender-3.2-release/blender_docs/manual/render/shader_nodes/textures/environment.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/render/shader_nodes/textures/environment.rst	2022-05-10 23:48:34 UTC (rev 9272)
+++ branches/blender-3.2-release/blender_docs/manual/render/shader_nodes/textures/environment.rst	2022-05-11 00:37:49 UTC (rev 9273)
@@ -32,6 +32,11 @@
    Type of data that the image contains, either Color or Non-Color Data.
    For most color textures the default of Color should be used, but in case of e.g. a bump or alpha map,
    the pixel values should be interpreted as Non-Color Data, to avoid doing any unwanted color space conversions.
+
+   The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
+   The default supported color spaces are described in detail here:

@@ Diff output truncated at 10240 characters. @@

More information about the Bf-docboard-svn mailing list