[Bf-docboard-svn] bf-manual: [7303] trunk/blender_docs/manual/sculpt_paint/sculpting: Sculpt: Boundary Brush

Thu Oct 29 21:22:10 CET 2020

Revision: 7303
          https://developer.blender.org/rBM7303
Author:   Blendify
Date:     2020-10-29 21:22:10 +0100 (Thu, 29 Oct 2020)
Log Message:
-----------
Sculpt: Boundary Brush

rBed9c0464bae66411384c216ba3f34f65658e0f68
rBc77bf952210a4947f151b3f6cb657584d788a548
rB2b2f3da721bf3dc4a62c6132e8120c50503e3c15

Modified Paths:
--------------
    trunk/blender_docs/manual/sculpt_paint/sculpting/introduction.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/tools/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/sculpt_paint/sculpting/tools/boundary.rst

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/introduction.rst
===================================================================

--- trunk/blender_docs/manual/sculpt_paint/sculpting/introduction.rst	2020-10-29 18:33:01 UTC (rev 7302)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/introduction.rst	2020-10-29 20:22:10 UTC (rev 7303)
@@ -14,10 +14,6 @@
 
    Sculpting Mode Example.
 
-
-Sculpt Mode
-===========
-
 Sculpt Mode is selected from the mode menu of the 3D Viewport header.
 Once Sculpt Mode is activated, the Toolbar of the 3D Viewport will change to
 Sculpt Mode specific panels. A red circle will appear and
@@ -35,7 +31,7 @@
 but it is slightly more advanced. All the normal brush controls still apply,
 and it functions exactly the same, yet the brush for sculpting is displayed in 3D.
 This means that the brush will follow the contours of the mesh and the radius is displayed
-by orienting the brush to match the meshes :term:`Normal`.
+by orienting the brush to match the topology :term:`Normal`.
 How closely the cursor follows the curvature of the mesh can be changed in
 the :doc:`Brush Settings </sculpt_paint/sculpting/tool_settings/brush_settings>`.
 

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst	2020-10-29 18:33:01 UTC (rev 7302)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst	2020-10-29 20:22:10 UTC (rev 7303)
@@ -62,7 +62,7 @@
    Flattens the mesh in the brush area, while moving it in the direction of the brush stroke.
 
 :doc:`/sculpt_paint/sculpting/tools/pose`
-   This brush is used to pose a model simulating an armature-like deformations.
+   Poses a model simulating an armature-like deformations.
 
 :doc:`/sculpt_paint/sculpting/tools/nudge`
    Moves vertices in the direction of the brush stroke.
@@ -71,9 +71,12 @@
    Rotates vertices within the brush in the direction the cursor is moved.
 
 :doc:`/sculpt_paint/sculpting/tools/slide_relax`
-   This brush slides the topology of the mesh in the direction of the stroke
+   Slides the topology of the mesh in the direction of the stroke
    without changing the geometrical shape of the mesh.
 
+:doc:`/sculpt_paint/sculpting/tools/boundary`
+   Transforms and deforms the mesh boundaries.
+
 :doc:`/sculpt_paint/sculpting/tools/cloth`
    Simulates cloth that can be sculpted.
 

Added: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/boundary.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/boundary.rst	                        (rev 0)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/boundary.rst	2020-10-29 20:22:10 UTC (rev 7303)
@@ -0,0 +1,73 @@
+
+********
+Boundary
+********
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Boundary`
+
+This tool is used to transform and deform the boundaries i.e. the unconnected edges of a mesh.
+The tool detects the mesh boundary closest to the active vertex and
+propagates the deformation using the brush :doc:`Falloff </sculpt_paint/brush/falloff>` into the mesh.
+
+.. note::
+
+   Even if this brush can produce deformations in triangle meshes and meshes with a non-regular quad grid,
+   the more regular and clean the topology is, the better the result.
+
+
+Brush Settings
+==============
+
+.. _bpy.types.Brush.boundary_deform_type:
+
+Deformation
+   Deformation type that is used by the brush.
+
+   Bend
+      Rotates the active boundary around the local Y axis.
+   Expand
+      Moves/extends the mesh boundary in the local X direction.
+   Inflate
+      Works similar to the :doc:`Inflate </sculpt_paint/sculpting/tools/inflate>` tool but,
+      the vertices that are inflated are constrained to the the mesh boundary.
+   Grab
+      Works similar to the :doc:`Grab </sculpt_paint/sculpting/tools/grab>` tool but,
+      the vertices that are grabbed are constrained to the the mesh boundary.
+   Twist
+      Rotates the active boundary around the local Z axis.
+   Smooth
+      Works similar to the :doc:`Grab </sculpt_paint/sculpting/tools/smooth>` tool but,
+      the vertices that are smoothed are constrained to the the mesh boundary.
+
+.. _bpy.types.Brush.boundary_falloff_type:
+
+Boundary Falloff
+   How the brush :doc:`Falloff </sculpt_paint/brush/falloff>` is applied across the boundary.
+
+.. _bpy.types.Brush.boundary_offset:
+
+Boundary Origin Offset
+   Offset of the boundary origin in relation to the brush radius.
+
+   Constant
+      Applies the same deformation in the entire boundary.
+   Brush Radius
+      Applies the deformation in a localized area limited by the brush radius.
+   Loop
+      Applies the brush falloff in a loop pattern.
+   Loop and Invert
+      Applies the fallof radius in a loop pattern,
+      inverting the displacement direction in each pattern repetition.
+
+
+Usage
+=====
+
+The main use cases of this brush are the *Bend* and *Expand* deformation modes,
+which depend on a grid topology to create the best results.
+In order to do further adjustments and tweaks to the result of these deformations,
+use the Inflate, Grab, Twist, and Smooth deformation modes, which do not depend that much on the topology.


Property changes on: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/boundary.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/index.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/index.rst	2020-10-29 18:33:01 UTC (rev 7302)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/index.rst	2020-10-29 20:22:10 UTC (rev 7303)
@@ -29,6 +29,7 @@
    nudge.rst
    rotate.rst
    slide_relax.rst
+   boundary.rst
    cloth.rst
    simplify.rst
    mask.rst

