[Bf-docboard-svn] bf-manual: [8229] trunk/blender_docs/manual: A note on Eyedropper consistancy

[Aaron Carlisle]

Revision: 8229
          https://developer.blender.org/rBM8229
Author:   Blendify
Date:     2021-07-24 00:05:41 +0200 (Sat, 24 Jul 2021)
Log Message:
-----------
A note on Eyedropper consistancy

The default option for view transform (Properties -> Render Properties (any engine) -> Color Management -> View Transform) is set to Filmic. This can lead to eyedropper returning a color darker than what the sample actually is. This is especially evident when we use the eyedropper to sample the color of an object and then set the color of the same object to the sampled color. Normally you expect the color to remain the same when doing so but with the Filmic option, every time you do this you get a darker color until you reach black.

I decided to add this edit to the manual since this can be really frustrating to people that are relatively new to blender like myself and that I couldn't find anything about this issue by searching for issues related to eyedropper. Hopefully this would save someone's time.

Author: @WetBird

Differential Revision: https://developer.blender.org/D11884

Modified Paths:
--------------
    trunk/blender_docs/manual/interface/controls/buttons/eyedropper.rst
    trunk/blender_docs/manual/render/color_management.rst

Modified: trunk/blender_docs/manual/interface/controls/buttons/eyedropper.rst
===================================================================
--- trunk/blender_docs/manual/interface/controls/buttons/eyedropper.rst	2021-07-23 21:57:04 UTC (rev 8228)
+++ trunk/blender_docs/manual/interface/controls/buttons/eyedropper.rst	2021-07-23 22:05:41 UTC (rev 8229)
@@ -9,11 +9,20 @@
 
 Color
    This is the most common usage, the eyedropper is used to sample a pixels color from anywhere within Blender.
+
+   .. note::
+
+      The color management's :ref:`View Transform <bpy.types.ColorManagedViewSettings.view_transform>`
+      affects eyedropper's functionality. In order to get consistent results, it should be set to "Standard".
+      If it's set to any other option, the eyedropper may return an inaccurate color. 
+
 Color Ramp
    Dragging the cursor over the window to sample a line which is converted into a color ramp.
+
 Objects/Object-Data
    This is used with object buttons (such as parent, constraints or modifiers) to
    select an object from the 3D Viewport or Outliner.
+
 Camera Depth
    Number fields effecting distance can also use the eyedropper.
 

Modified: trunk/blender_docs/manual/render/color_management.rst
===================================================================
--- trunk/blender_docs/manual/render/color_management.rst	2021-07-23 21:57:04 UTC (rev 8228)
+++ trunk/blender_docs/manual/render/color_management.rst	2021-07-23 22:05:41 UTC (rev 8229)
@@ -2,7 +2,6 @@
 .. _bpy.types.ColorManagedDisplaySettings:
 .. _bpy.types.ColorManagedViewSettings:
 
-
 ****************
 Color Management
 ****************