[Bf-docboard-svn] bf-manual: [7952] trunk/blender_docs/manual: Sculpt: Expand Operator
Aaron Carlisle
noreply at blender.org
Thu Apr 15 02:51:12 CEST 2021
Revision: 7952
https://developer.blender.org/rBM7952
Author: Blendify
Date: 2021-04-15 02:51:12 +0200 (Thu, 15 Apr 2021)
Log Message:
-----------
Sculpt: Expand Operator
rB82e7032477283a9bf2747ee607da7c5ba3eb8986
Modified Paths:
--------------
trunk/blender_docs/manual/glossary/index.rst
trunk/blender_docs/manual/modeling/modifiers/common_options.rst
trunk/blender_docs/manual/render/materials/legacy_textures/types/image_movie.rst
trunk/blender_docs/manual/sculpt_paint/brush/texture.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
Modified: trunk/blender_docs/manual/glossary/index.rst
===================================================================
--- trunk/blender_docs/manual/glossary/index.rst 2021-04-14 21:04:09 UTC (rev 7951)
+++ trunk/blender_docs/manual/glossary/index.rst 2021-04-15 00:51:12 UTC (rev 7952)
@@ -350,6 +350,9 @@
See also `Gamma correction <https://en.wikipedia.org/wiki/Gamma_correction>`__ on Wikipedia.
+ Geodesic
+ Relating to the shortest possible path between two points on a curved surface.
+
Geometric Center
The mean average of the positions of all vertices making up the object.
Modified: trunk/blender_docs/manual/modeling/modifiers/common_options.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/common_options.rst 2021-04-14 21:04:09 UTC (rev 7951)
+++ trunk/blender_docs/manual/modeling/modifiers/common_options.rst 2021-04-15 00:51:12 UTC (rev 7952)
@@ -67,7 +67,7 @@
.. tip::
By clicking on the right-most button of this field (with the settings icon),
- you can go directly to the selected texture's settings in the *Texture Properties* editor.
+ you can go directly to the selected texture's settings in the *Texture Properties* tab.
Texture Coordinates
The texture's coordinates to get each vertex' value:
Modified: trunk/blender_docs/manual/render/materials/legacy_textures/types/image_movie.rst
===================================================================
--- trunk/blender_docs/manual/render/materials/legacy_textures/types/image_movie.rst 2021-04-14 21:04:09 UTC (rev 7951)
+++ trunk/blender_docs/manual/render/materials/legacy_textures/types/image_movie.rst 2021-04-15 00:51:12 UTC (rev 7952)
@@ -1,3 +1,4 @@
+.. _bpy.types.ImageTexture:
**************
Image or Movie
@@ -219,7 +220,7 @@
Uses several isotropic probes at several points along a line in texture space to produce
an anisotropic filter to reduce aliasing artifacts without considerably increasing rendering time.
- Probes
+ Light Probes
Number of probes to use. An integer between 1 and 256.
Further reading: McCormack, J; Farkas, KI; Perry, R; Jouppi, NP (1999)
`Simple and Table Feline: Fast Elliptical Lines for Anisotropic Texture Mapping
@@ -230,7 +231,7 @@
Eccentricity
Maximum Eccentricity. Higher values give less blur at distant/oblique angles, but is slower.
- Filter Size
+ Size
The filter size used by MIP Map and Interpolation.
- Minimum Filter Size
+ Minimum Size
Use Filter Size as a minimal filter value in pixels.
Modified: trunk/blender_docs/manual/sculpt_paint/brush/texture.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/texture.rst 2021-04-14 21:04:09 UTC (rev 7951)
+++ trunk/blender_docs/manual/sculpt_paint/brush/texture.rst 2021-04-15 00:51:12 UTC (rev 7952)
@@ -1,3 +1,4 @@
+.. _bpy.types.BrushTextureSlot:
*******
Texture
@@ -22,6 +23,8 @@
In paint modes the texture is used as a color source,
while for sculpting it is used to determine the strength of the brush.
+.. _bpy.types.BrushTextureSlot.map_mode:
+
Mapping
Sets the way the texture is applied to the brush stroke.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst 2021-04-14 21:04:09 UTC (rev 7951)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst 2021-04-15 00:51:12 UTC (rev 7952)
@@ -102,6 +102,44 @@
Expands or contracts the face set under the cursor by adding or removing surrounding faces.
+Expand Face Set by Topology
+===========================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Expand Face Set by Topology`
+ :Hotkey: :kbd:`Shift-W`
+
+Creates a face set radiating outwards from the active vertex in a uniform manner.
+This operator uses the same internal operator as :ref:`bpy.ops.sculpt.expand`
+meaning all the hotkeys and functionality works the same as that tool.
+
+.. note::
+
+ This operator is meant to be used interactively through the shortcut and available hotkeys.
+
+
+Expand Active Face Set
+======================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Expand Face Set by Topology`
+ :Hotkey: :kbd:`Shift-Alt-W`
+
+Expands a face set by radiating outwards from the face set in a uniform manner.
+This operator uses the same internal operator as :ref:`bpy.ops.sculpt.expand`
+meaning all the hotkeys and functionality works the same as that tool.
+
+.. note::
+
+ This operator is meant to be used interactively through the shortcut and available hotkeys.
+
+
.. _bpy.ops.mesh.face_set_extract:
Extract Face Set
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2021-04-14 21:04:09 UTC (rev 7951)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2021-04-15 00:51:12 UTC (rev 7952)
@@ -136,6 +136,7 @@
.. _bpy.ops.sculpt.mask_expand:
+.. _bpy.ops.sculpt.expand:
Expand Mask by Topology
-----------------------
@@ -149,20 +150,87 @@
Creates a mask radiating outwards from the active vertex in a uniform manner.
+.. note::
-Expand Mask by Curvature
-------------------------
+ This operator is meant to be used interactively through the shortcut and available hotkeys.
+.. rubric:: Hotkeys
+
+:Confirm: :kbd:`LMB`
+ Confirms the action of the operator.
+:Cancel: :kbd:`Esc`/:kbd:`RMB`
+ Cancels the action of the operator.
+:Invert: :kbd:`F`
+ Flips between expanding a positive mask (value of one) or a negative mask (value of zero).
+ In the case of face sets, this option flips between including areas inside the masked area
+ or areas outside the masked area.
+:Toggle Preserve State: :kbd:`E`
+ Accumulates the new mask on top of the previous one instead of replacing it.
+ For Face Sets, this creates Face Sets boundaries instead of replacing the existing Face Set.
+:Toggle Gradient: :kbd:`G`
+ Enables linear gradient, creates a linear gradient of values from the origin to the current active vertex.
+:Geodesic Recursive Step: :kbd:`R`
+ Generate a new :term:`Geodesic` falloff from the boundary of the enabled vertices of the current falloff.
+:Topology Recursive Step: :kbd:`Alt-R`
+ Generate a new topology flood fill falloff from the boundary of the enabled vertices of the current falloff.
+:Move Origin: :kbd:`Spacebar`
+ Moves the initial vertex used for calculating the falloff.
+:Geodesic Falloff: :kbd:`1`
+ Uses a falloff based on the :term:`Geodesic` distances from the edge boundary to the active vertex.
+:Topology Falloff: :kbd:`2`
+ Uses a falloff based on a flood fill using edges.
+:Diagonals Falloff: :kbd:`3`
+ Uses a falloff based on a flood fill using polygon diagonals and edges.
+:Spherical Falloff: :kbd:`4`
+ Uses a falloff based on the Euclidean distances from the edge boundary to the active vertex.
+:Snap Expanded to Face Sets: :kbd:`Ctrl`
+ Isolates the expanded region to the boundary of the face set under the cursor.
+:Loop Count Increase: :kbd:`W`
+ Increase the number of loops or iterations the operator is run; using four loops will split the mask into 4 parts.
+:Loop Count Decrease: :kbd:`Q`
+ Decrease the number of loops or iterations the operator is run; using four loops will split the mask into 4 parts.
+:Toggle Brush Gradient: :kbd:`B`
+ Similar to linear gradient but uses the current brush :doc:`Falloff </sculpt_paint/brush/falloff>`
+ to define the shape of the falloff
+:Texture Distortion Increase: :kbd:`Y`
+ Increases the falloff distance when using a texture to distort the mask shape.
+:Texture Distortion Decrease: :kbd:`T`
+ Decreases the falloff distance when using a texture to distort the mask shape.
+
+
+Usage
+^^^^^
+
+.. rubric:: Textures
+
+Textures can be used to affect the "strength" of the mask.
+This feature can be combined with loops and recursion to create really unique looking masks.
+To enable textures, you first need to create/select a texture to use,
+this is done by in the Properties editor's :doc:`Texture Properties </render/materials/legacy_textures/index>`.
+Next select the texture in the :doc:`Texture </sculpt_paint/brush/texture>` Brush Settings,
+while there **make sure** to enable *3D* :ref:`Mapping <bpy.types.BrushTextureSlot.map_mode>`.
+Now, you can use :kbd:`Y` and :kbd:`T` to increase or decrease the affect the texture has on the edge of the mask.
+
+
+Expand Mask by Normals
+----------------------
+
.. admonition:: Reference
:class: refbox
:Mode: Sculpt Mode
- :Menu: :menuselection:`Mask --> Expand Mask by Curvature`
+ :Menu: :menuselection:`Mask --> Expand Mask by Normals`
:Hotkey: :kbd:`Shift-Alt-A`
Creates a mask radiating outwards from the active vertex while following the curvature of the mesh.
+This operator uses the same internal operator as :ref:`bpy.ops.sculpt.expand`
+meaning all the hotkeys and functionality works the same as that tool.
+.. note::
+ This operator is meant to be used interactively through the shortcut and available hotkeys.
+
+
.. _bpy.ops.mesh.paint_mask_extract:
Mask Extract
More information about the Bf-docboard-svn
mailing list