[Bf-blender-cvs] [b138c8f5b3a] master: PyAPI Docs: Update Indirect Data Access docs

Aaron Carlisle noreply at git.blender.org
Thu Jan 7 01:34:24 CET 2021


Commit: b138c8f5b3a63b0cf10b20e874f6a16b8393485b
Author: Aaron Carlisle
Date:   Wed Jan 6 19:34:21 2021 -0500
Branches: master
https://developer.blender.org/rBb138c8f5b3a63b0cf10b20e874f6a16b8393485b

PyAPI Docs: Update Indirect Data Access docs

Fixes T84432

===================================================================

M	doc/python_api/rst/info_api_reference.rst

===================================================================

diff --git a/doc/python_api/rst/info_api_reference.rst b/doc/python_api/rst/info_api_reference.rst
index 0de977aaaa7..e39dc6e2c3e 100644
--- a/doc/python_api/rst/info_api_reference.rst
+++ b/doc/python_api/rst/info_api_reference.rst
@@ -194,34 +194,26 @@ For example, if you want to access the texture of a brush via Python to adjust i
    This takes you to ``bpy.types.Texture.contrast``. Now you can see that ``contrast`` is a property of texture.
 #. To find out how to access the texture from the brush check on the references at the bottom of the page.
    Sometimes there are many references, and it may take some guesswork to find the right one,
-   but in this case it's ``Brush.texture``.
+   but in this case it's ``tool_settings.sculpt.brush.texture``.
 
 #. Now you know that the texture can be accessed from ``bpy.data.brushes["BrushName"].texture``
    but normally you *won't* want to access the brush by name, instead you want to access the active brush.
    So the next step is to check on where brushes are accessed from via the references.
-   In this case there it is simply ``bpy.context.brush``.
 
 Now you can use the Python console to form the nested properties needed to access brush textures contrast:
-*Context -> Brush -> Texture -> Contrast*.
+*Context ->  Tool Settings --> Sculpt --> Brush -> Texture -> Contrast*.
 
 Since the attribute for each is given along the way you can compose the data path in the Python console:
 
 .. code-block:: python
 
-   bpy.context.brush.texture.contrast
-
-There can be multiple ways to access the same data, which you choose often depends on the task.
-An alternate path to access the same setting is:
-
-.. code-block:: python
-
-   bpy.context.sculpt.brush.texture.contrast
+   bpy.context.tool_settings.sculpt.brush.texture.contrast
 
 Or access the brush directly:
 
 .. code-block:: python
 
-   bpy.data.brushes["BrushName"].texture.contrast
+   bpy.data.textures["Texture"].contrast
 
 
 If you are writing a user tool normally you want to use the :mod:`bpy.context` since the user normally expects



More information about the Bf-blender-cvs mailing list