[Bf-docboard-svn] bf-manual: [7312] trunk/blender_docs/manual: Sculpting: Split Editing & Combine with hide_mask
Aaron Carlisle
noreply at blender.org
Thu Oct 29 23:32:15 CET 2020
Revision: 7312
https://developer.blender.org/rBM7312
Author: Blendify
Date: 2020-10-29 23:32:14 +0100 (Thu, 29 Oct 2020)
Log Message:
-----------
Sculpting: Split Editing & Combine with hide_mask
Modified Paths:
--------------
trunk/blender_docs/manual/files/linked_libraries/link_append.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/index.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/introduction.rst
Added Paths:
-----------
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/index.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/sculpt.rst
Removed Paths:
-------------
trunk/blender_docs/manual/sculpt_paint/sculpting/editing.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/hide_mask.rst
Modified: trunk/blender_docs/manual/files/linked_libraries/link_append.rst
===================================================================
--- trunk/blender_docs/manual/files/linked_libraries/link_append.rst 2020-10-29 22:07:34 UTC (rev 7311)
+++ trunk/blender_docs/manual/files/linked_libraries/link_append.rst 2020-10-29 22:32:14 UTC (rev 7312)
@@ -151,7 +151,8 @@
Options
-------
-The operation available from the *Outliner*'s context menu has no options, and only affects the selected data-block.
+The operation available from the *Outliner*'s context menu has no options,
+and only affects the selected data-block.
The operation available from the *3D View* only directly affects selected objects,
but it can also make local the objects' dependencies:
Added: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst (rev 0)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst 2020-10-29 22:32:14 UTC (rev 7312)
@@ -0,0 +1,157 @@
+.. _sculpting-editing-facesets:
+
+*********
+Face Sets
+*********
+
+Face Sets are another way to control the visibility state of the mesh in Sculpt Mode.
+They are designed to work in modes where brushes are the primary way of interaction and they provide
+much more control when working with meshes with complex shapes and overlapping surfaces.
+Geometry can be assigned to a Face Set and each Face Set is represented as a different color in the 3D Viewport.
+A pie menu to edit Face Sets can be accessed with :kbd:`W`.
+
+
+.. _bpy.ops.sculpt.face_sets_create:
+
+Face Set from Masked
+====================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Face Set from Masked`
+
+Creates a new Face Set from :ref:`Masked Geometry <sculpt-mask-menu>`.
+
+
+Face Set from Visible
+=====================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Face Set from Visible`
+
+Creates a new Face Set from all visible geometry.
+
+
+Face Set from Edit Mode Selection
+=================================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Face Set from Edit Mode Selection`
+
+Creates a new Face Set corresponding to the Edit Mode face selection.
+
+
+.. _bpy.ops.sculpt.face_sets_init:
+
+Init Face Sets
+==============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Init Face Sets`
+
+Initializes all Face Sets on the mesh at once based off one of several mesh attribute properties.
+
+Mode
+ The mesh data attribute used to define the boundaries for the Face Sets.
+
+ By Loose Parts
+ Creates a new Face Set per discontinuous part of the mesh.
+ By Materials
+ Creates a Face Set per :ref:`Material Slot <material-slots>`.
+ By Normals
+ Creates Face Sets for Faces that have similar :ref:`Normals <modeling-meshes-structure-normals>`.
+ By UV Seams
+ Creates Face Sets using :doc:`UV Seams </modeling/meshes/uv/unwrapping/seams>` as boundaries.
+ By Edge Creases
+ Creates Face Sets using :ref:`Edge Creases <bpy.ops.transform.edge_crease>` as boundaries.
+ By Edge Bevel Weight
+ Creates Face Sets using :ref:`Bevel Weights <bpy.ops.transform.edge_bevelweight>` as boundaries.
+ By Sharp Edges
+ Creates Face Sets using :ref:`Sharp Edges <bpy.ops.mesh.mark_sharp>` as boundaries.
+ By Face Maps
+ Creates a Face Set per :ref:`Face Map <bpy.types.FaceMaps>`.
+
+Threshold
+ The minimum value to consider a certain attribute a boundary when creating the Face Sets.
+
+
+.. _bpy.ops.sculpt.face_set_edit:
+
+Grow/Shrink Face Sets
+=====================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Grow/Shrink Face Sets`
+ :Hotkey: :kbd:`Ctrl-W`, :kbd:`Ctrl-Alt-W`
+
+Expands or contracts the area of face set under the cursor by adding or removing surrounding faces.
+
+
+.. _bpy.ops.mesh.face_set_extract:
+
+Extract Face Set
+================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Grow/Shrink Face Sets`
+
+Creates a new mesh based on the selected Face Set.
+Once the operator is initiated, hover over the Face Set and :kbd:`LMB` to create the new mesh.
+After the operator is finished the new mesh will be selected in Object Mode.
+
+
+.. _bpy.ops.sculpt.face_set_change_visibility:
+
+Invert Visible Face Sets
+========================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Invert Visible Face Sets`
+
+Hides all geometry that is part of a Face Set and makes all hidden geometry that is part of a face set visible.
+
+
+Show All Face Sets
+==================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Show All Face Sets`
+
+Shows all hidden geometry that is part of a Face Set.
+
+
+.. _bpy.ops.sculpt.face_sets_randomize_colors:
+
+Randomize Colors
+================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Face Sets --> Randomize Colors`
+
+Generates a new set of random colors to render the Face Sets in the 3D Viewport.
Property changes on: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/face_sets.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/index.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/index.rst (rev 0)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/index.rst 2020-10-29 22:32:14 UTC (rev 7312)
@@ -0,0 +1,11 @@
+
+###########
+ Editing
+###########
+
+.. toctree::
+ :maxdepth: 2
+
+ sculpt.rst
+ mask.rst
+ face_sets.rst
Property changes on: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst (rev 0)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2020-10-29 22:32:14 UTC (rev 7312)
@@ -0,0 +1,136 @@
+.. _sculpt-mask-menu:
+.. _bpy.ops.paint.mask:
+
+****
+Mask
+****
+
+Masking to control which areas of the mesh are influenced by sculpting.
+
+.. figure:: /images/sculpt-paint_sculpting_hide-mask_example.jpg
+
+ Black part is masked.
+
+
+Brush
+=====
+
+To edit the mask, select the *Mask Brush* from the Brush panel.
+
+
+.. _bpy.ops.paint.mask_flood_fill:
+.. _bpy.ops.paint.mask_lasso_gesture:
+.. _bpy.ops.sculpt.mask_filter:
+.. _bpy.ops.sculpt.mask_expand:
+.. _bpy.ops.mesh.paint_mask_slice:
+.. _bpy.ops.sculpt.dirty_mask:
+
+Editing
+=======
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask`
+
+Masks can be edited across the entire model.
+Using :kbd:`A` opens a pie menu to choose different operations.
+
+Invert Mask :kbd:`Ctrl-I`
+ Inverts an existing mask.
+Fill Mask
+ Fills the whole mask with a value of 1.
+Clear Mask :kbd:`Alt-M`
+ Fills the mask with a value of 0. To completely remove the mask data, see `Clear Sculpt-Mask Data`_.
+Box Mask :kbd:`B`
+ Works like the *Box Select* tool, it creates a rectangular mask region.
+ Hold :kbd:`Shift` to clear the mask of the selected region.
+Lasso Mask :kbd:`Shift-Ctrl-LMB`
+ Can be used to create a free-form mask, similar to the *Lasso Select* tool.
+
+ .. tip::
+
+ To clear the mask of areas with the *Lasso Mask* tool, first invert the mask,
+ apply the *Lasso Mask*, and then invert the mask back.
+
+Mask Filters
+ Mask filters are operations that are applied to the whole paint mask.
+
+ Type
+ Smooth/Sharpen Mask
+ Changes the crispness of the mask edge.
+ Grow/Shrink Mask
+ Changes the size of the mask.
+ Increase/Decrease Contrast
+ Changes the contrast of the mask.
+ Iterations
+ The number of times that the filter is going to be applied.
+ Auto Iteration Count
+ Use a automatic number of iterations based on the number of vertices of the sculpt.
+
+Expand Mask by Topology :kbd:`Shift-A`
+ Creates a mask radiating outwards from the active vertex in a uniform manner.
+
+Expand Mask by Curvature :kbd:`Shift-Alt-A`
+ Creates a mask radiating outwards from the active vertex while following the curvature of the mesh.
+
+Mask Extract
+ Creates a duplicate mesh object based on masked geometry.
+
+ Threshold
+ Minimum mask value to consider the vertex valid to extract a face from the original mesh.
+ Add Boundary Loop
+ Creates and extra boundary loop on the edges of the geometry,
+ making it ready for adding a Subdivision Surface modifier later.
+ Smooth Iterations
+ Smooth iterations applied to the extracted mesh.
+ Project to Sculpt
+ Project the extracted mesh on to the original sculpt object.
+ Extract as Solid
+ Adds a :doc:`Solidify Modifier </modeling/modifiers/generate/solidify>` to the newly created mesh object.
+
+Mask Slice
+ Removes the masked vertices from the mesh.
+
+ Threshold
+ Minimum mask value to consider the vertex valid to extract a face from the original mesh
+ Fill Holes
+ Fills concave holes with geometry that might have resulted from the *Mask Slice* operation.
+ Slice to New Object
+ Create a new object from the masked geometry.
+
+Dirty Mask
+ Generates a mask based on the geometry cavity and pointiness.
+
+
+.. _bpy.types.Sculpt.show_mask:
+.. _bpy.types.View3DOverlay.sculpt_mode_mask_opacity:
+
+Display Settings
+================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list