[Bf-docboard-svn] bf-manual: [9898] trunk/blender_docs/manual: GPencil: Doc update for Sculpt auto-masking

[Matias Mendiola]

Revision: 9898
          https://developer.blender.org/rBM9898
Author:   mendio
Date:     2023-01-21 16:28:28 +0100 (Sat, 21 Jan 2023)
Log Message:
-----------
GPencil: Doc update for Sculpt auto-masking 

Modified Paths:
--------------
    trunk/blender_docs/manual/grease_pencil/modes/sculpting/introduction.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/grease-pencil_modes_sculpting_introduction_auto-masking.png

Modified: trunk/blender_docs/manual/grease_pencil/modes/sculpting/introduction.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/sculpting/introduction.rst	2023-01-21 15:02:11 UTC (rev 9897)
+++ trunk/blender_docs/manual/grease_pencil/modes/sculpting/introduction.rst	2023-01-21 15:28:28 UTC (rev 9898)
@@ -44,9 +44,41 @@
    You can activate multiframe edition with the Multiframe button next to the modes selector (faded lines icon).
    See :doc:`Multiframe </grease_pencil/multiframe>` for more information.
 
+Auto-Masking
+============
 
+.. figure:: /images/grease-pencil_modes_sculpting_introduction_auto-masking.png
+
+   Auto-Masking settings.
+
+These properties automatically mask geometry based on stroke, layers and materials under the cursor.
+It's an quick alternative to frequent manual masking.
+These masks are initialized on every new tool usage. They are also never visible as an overlay.
+
+These properties can be accessed via a :ref:`bpy.types.UIPieMenu` by pressing :kbd:`Shift-Alt-A`.
+
+All auto-masking modes can be combined, which makes the generated auto-mask more specific.
+For example it's possible to auto-mask strokes that use specific layer and material while excluding others.
+
+Strokes
+   Only strokes that are under the cursor when you started the tool are affected.
+
+Layers
+   Only strokes on the same layers that are under the cursor when you started the tool are affected.
+
+Materials
+   Only materials with the same material that are under the cursor when you started the tool are affected.
+
+Active Layer
+   Only the strokes on the active layer are affected.
+
+Active Material
+   Only the strokes with the active material are affected.
+
+
 Keyboard Shortcuts
 ==================
 
 - Invert stroke toggle :kbd:`Ctrl`
 - Change active material :kbd:`U`
+- Auto-masking :kbd:`Shift-Alt-A`

Added: trunk/blender_docs/manual/images/grease-pencil_modes_sculpting_introduction_auto-masking.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/grease-pencil_modes_sculpting_introduction_auto-masking.png
===================================================================
--- trunk/blender_docs/manual/images/grease-pencil_modes_sculpting_introduction_auto-masking.png	2023-01-21 15:02:11 UTC (rev 9897)
+++ trunk/blender_docs/manual/images/grease-pencil_modes_sculpting_introduction_auto-masking.png	2023-01-21 15:28:28 UTC (rev 9898)

Property changes on: trunk/blender_docs/manual/images/grease-pencil_modes_sculpting_introduction_auto-masking.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property