[Bf-docboard-svn] bf-manual: [7948] trunk/blender_docs/manual/sculpt_paint: Brush: Split texture and texture mask

[Aaron Carlisle]

Revision: 7948
          https://developer.blender.org/rBM7948
Author:   Blendify
Date:     2021-04-13 05:55:09 +0200 (Tue, 13 Apr 2021)
Log Message:
-----------
Brush: Split texture and texture mask

This fixes also compile warning

Modified Paths:
--------------
    trunk/blender_docs/manual/sculpt_paint/brush/index.rst
    trunk/blender_docs/manual/sculpt_paint/brush/texture.rst
    trunk/blender_docs/manual/sculpt_paint/texture_paint/tool_settings/brush_settings.rst

Added Paths:
-----------
    trunk/blender_docs/manual/sculpt_paint/brush/texture_mask.rst

Modified: trunk/blender_docs/manual/sculpt_paint/brush/index.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/index.rst	2021-04-13 03:21:08 UTC (rev 7947)
+++ trunk/blender_docs/manual/sculpt_paint/brush/index.rst	2021-04-13 03:55:09 UTC (rev 7948)
@@ -17,6 +17,7 @@
 
    brush.rst
    texture.rst
+   texture_mask.rst
    stroke.rst
    falloff.rst
    cursor.rst

Modified: trunk/blender_docs/manual/sculpt_paint/brush/texture.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/texture.rst	2021-04-13 03:21:08 UTC (rev 7947)
+++ trunk/blender_docs/manual/sculpt_paint/brush/texture.rst	2021-04-13 03:55:09 UTC (rev 7948)
@@ -1,10 +1,7 @@
 
-**********************
-Texture & Texture Mask
-**********************
-
+*******
 Texture
-=======
+*******
 
 .. figure:: /images/sculpt-paint_brush_texture_ui-example.jpg
    :width: 580px
@@ -79,29 +76,9 @@
       Random Angle
          Constraints the random deviation to a range.
 
-Offset
+Offset X, Y, Z
    Offset the texture map placement in X, Y, and Z axes.
-Size
+Size X, Y, Z
    Set the scale of the texture in each axis. Not available for *Drag* sculpting textures.
-Sample Bias
-   Value added to texture samples (sculpting only).
-
-
-.. _bpy.types.BrushTextureSlot.mask:
-
-Texture Mask
-============
-
-Brush strength is masked with a texture.
-
-Pressure Masking
-   A mask cut-off function. It allows to clip the mask result based on pressure,
-   creating areas of no paint when low pressure is applied to the brush,
-   similar to how a real brush would behave.
-
-   Off
-      Deactivated.
-   Ramp
-      Distributes the mask effect above the pressure value.
-   Cutoff
-      Simply selects between zero and one based on stylus pressure.
+Sample Bias :guilabel:`Sculpt Mode`
+   Value added to texture samples.

Added: trunk/blender_docs/manual/sculpt_paint/brush/texture_mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/texture_mask.rst	                        (rev 0)
+++ trunk/blender_docs/manual/sculpt_paint/brush/texture_mask.rst	2021-04-13 03:55:09 UTC (rev 7948)
@@ -0,0 +1,71 @@
+.. _bpy.types.BrushTextureSlot.mask:
+
+************
+Texture Mask
+************
+
+Whit a Texture Mask the brush strength is masked with a texture.
+
+Texture
+   In paint modes the texture is used as a color source,
+   while for sculpting it is used to determine the strength of the brush.
+
+Mask Mapping
+   Sets the way the texture is applied to the brush stroke.
+
+   View Plane
+      If *View Plane* is enabled, the current view angle is used to project the brush texture onto the model.
+      I.e. the texture follows the mouse, so it appears that the texture is being dragged across the model.
+      In 2D painting, the texture moves with the brush.
+   Tiled
+      The *Tile* option tiles the texture across the screen,
+      so moving the brush appears to move separately from the texture.
+      The *Tile* option is most useful with tileable images, rather than procedural textures.
+   Random
+      Picks a random texture coordinate to sample from for each dab.
+   Stencil
+      Stencil mapping works by projecting the paint from the camera space on the mesh or canvas.
+      Painting is applied only inside the boundaries of the stencil.
+      The stencil is displayed as a screen space overlay on the viewport.
+      To the transform the stencil texture and the stencil mask with additional :kbd:`Alt` pressed:
+
+      - Move :kbd:`RMB`
+      - Scale :kbd:`Shift-RMB`
+      - Rotate :kbd:`Ctrl-RMB`
+
+      When using stencil scaling, :kbd:`X` and :kbd:`Y` are used to constrain the scaling to one axis.
+      Pressing one of the buttons twice reverts to unconstrained scaling.
+
+      Image Aspect
+         Restore the aspect ratio of the original image to reset stretching introduce by scaling,
+         (Image textures only.) This operator can use the tiling and scale values of the brush texture
+         if the relevant are enabled in :ref:`ui-undo-redo-adjust-last-operation` panel.
+      Reset Transform
+         Restores the position of the stencil.
+
+Angle
+   This is the rotation angle of the texture brush.
+   It can be changed interactively via :kbd:`Ctrl-F` in the 3D Viewport.
+   While in the interactive rotation you can enter a value numerically as well.
+
+   Rake
+      Angle follows the direction of the brush stroke.
+   Random
+      Angle is randomized per dab.
+
+      Random Angle
+         Constraints the random deviation to a range.
+
+Pressure Masking
+   A mask cut-off function. It allows to clip the mask result based on pressure,
+   creating areas of no paint when low pressure is applied to the brush,
+   similar to how a real brush would behave.
+
+   :Off: Deactivated.
+   :Ramp: Distributes the mask effect above the pressure value.
+   :Cutoff: Simply selects between zero and one based on stylus pressure.
+
+Offset X, Y, Z
+   Offset the texture map placement in X, Y, and Z axes.
+Size X, Y, Z
+   Set the scale of the texture in each axis. Not available for *Drag* sculpting textures.


Property changes on: trunk/blender_docs/manual/sculpt_paint/brush/texture_mask.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/sculpt_paint/texture_paint/tool_settings/brush_settings.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/texture_paint/tool_settings/brush_settings.rst	2021-04-13 03:21:08 UTC (rev 7947)
+++ trunk/blender_docs/manual/sculpt_paint/texture_paint/tool_settings/brush_settings.rst	2021-04-13 03:55:09 UTC (rev 7948)
@@ -123,7 +123,7 @@
    :hidden:
 
    Texture </sculpt_paint/brush/texture.rst>
-   Texture Mask </sculpt_paint/brush/texture.rst>
+   Texture Mask </sculpt_paint/brush/texture_mask.rst>
    Stroke </sculpt_paint/brush/stroke.rst>
    Falloff </sculpt_paint/brush/falloff.rst>
    Cursor </sculpt_paint/brush/cursor.rst>