Differential D16335 Diff 57232 manual/sculpt_paint/sculpting/editing/sculpt.rst

Changeset View

Standalone View

manual/sculpt_paint/sculpting/editing/sculpt.rst


	******			******
	Sculpt			Sculpt
	******			******

				.. a screenshot of the menu.

				This page details the general hotkey operators and menu operators in sculpt mode.

	Show & Hide			Show & Hide
	===========			===========

				Some very common hotkey operators to control the visibility based on face sets.
				These are not part of any menu and have to be used via the hotkeys.
				More visibility operators can be found in the :doc:`Face Sets Menu</sculpt_paint/sculpting/editing/face_sets>`
				and the Pie Menu shortcut :kbd:`W`. (Since visibility is often toggled via face sets.)

				.. note::
				These two hotkeys are inverted compared to other modes, to make the operators more convenient to access.
				Toggling the Visibility is far more often used. If this behavior is undesired it's recommended
				to change the keymap in the preferences.

				Toggle Visibility :kbd:`H`
				Hide all face sets except the active one (under the cursor).
				If face sets are already hidden, then this operator will show everything.

				Hide Active Face Set :kbd:`Shift-H`
				Hide the face set under the cursor. Press :kbd:`H` afterwards to show everything.

	.. reference::			.. reference::

	:Mode: Sculpt Mode			:Mode: Sculpt Mode
	:Menu: :menuselection:`Sculpt`			:Menu: :menuselection:`Sculpt`

	Portions of the mesh can be hidden in Sculpt Mode to improve the viewport performance and
	to access parts of the mesh that would otherwise be difficult to access,
	because they are occluded by other parts. The hidden faces cannot be sculpted on.
	Hiding is shared between Edit Mode and Sculpt Mode
	(i.e. hiding/unhiding in one mode affects the other mode too).

	Show All :kbd:`Alt-H`			Show All :kbd:`Alt-H`
	Reveal all hidden parts.			Reveal all hidden faces.
	Show Bounding Box :kbd:`Shift-H`			Show Bounding Box
	To reveal a hidden part of a mesh inside the selection.			Draw a box to reveal hidden faces.
	Hide Bounding Box :kbd:`H`
	To hide a part of a mesh inside the selection.
	This works similar to the :ref:`Box Select <tool-select-box>` tool.			This works similar to the :ref:`Box Select <tool-select-box>` tool.
				Hide Bounding Box
				Draw a box to hide faces of a mesh.
	Hide Masked			Hide Masked
	Hides all masked vertices.			Hides all masked vertices.

				.. seealso::
				For a more general introduction see
				:doc:`Visibility, Masking & Face Sets </sculpt_paint/sculpting/introduction/visibility_masking_face_sets>`.

	.. _bpy.ops.sculpt.set_pivot_position:			.. _bpy.ops.sculpt.set_pivot_position:
				.. _Set Pivot:
				BlendifyUnsubmitted Done Inline Actions You can just use `bpy.ops.sculpt.set_pivot_position` as the reference. Blendify: You can just use `bpy.ops.sculpt.set_pivot_position` as the reference.

	Set Pivot			Set Pivot
	=========			=========

	.. reference::			.. reference::

	:Mode: Sculpt Mode			:Mode: Sculpt Mode
	:Menu: :menuselection:`Sculpt --> Set Pivot`			:Menu: :menuselection:`Sculpt --> Set Pivot`

	Like Object and Edit Mode, Sculpt Mode also has a :term:`Pivot Point`.			Like Object and Edit Mode, Sculpt Mode also has a :term:`Pivot Point`.
	This is because the basic move, scale, rotate transforms are also possible in Sculpt Mode.			This is because the basic :doc:`move, rotate and scale </sculpt_paint/sculpting/tools/transforms>`
				transforms are also supported in Sculpt Mode.
				But the pivot point in Sculpt Mode is unique. It always moves together with the transformed mesh
				and can be both manually & automatically placed.

	Origin			Origin
	Sets the pivot to the origin of the sculpt.			Sets the pivot to the origin of the sculpt.
	Unmasked			Unmasked
	Sets the pivot position to the average position of the unmasked vertices.			Sets the pivot position to the average position of the unmasked vertices.
	Mask Border			Mask Border
	Sets the pivot position to the center of the mask's border.			Sets the pivot position to the center of the mask's border.
				This operation will automatically happen when using :ref:`bpy.ops.sculpt.expand`.
	Active Vertex			Active Vertex
	Sets the pivot position to the active vertex position.			Sets the pivot position to the active vertex position.
	Surface			Surface
	Sets the pivot position to the surface under the cursor.			Sets the pivot position to the surface under the cursor.

	.. seealso::			.. tip::
				For more convenient placement of the pivot point it's recommended to assign a shortcut to either
				Surface or Active Vertex.

	:doc:`Object and Edit Mode Pivot </editors/3dview/controls/pivot_point/index>`			.. seealso::
				For a more general introduction see :doc:`Transforming </sculpt_paint/sculpting/introduction/transforming>`.


	.. _bpy.ops.sculpt.optimize:			.. _bpy.ops.sculpt.optimize:
				BlendifyUnsubmitted Done Inline Actions This needs to get moved with the "Rebuild BVH" heading Blendify: This needs to get moved with the "Rebuild BVH" heading

	Rebuild BVH
	===========

	.. reference::

	:Mode: Sculpt Mode
	:Menu: :menuselection:`Sculpt --> Rebuild BVH`

	Recalculates the :term:`BVH` used by :doc:`/sculpt_paint/sculpting/tool_settings/dyntopo`
	which can improve performance which might degrade over time while using Dyntopo.


	Transfer Sculpt Mode			Transfer Sculpt Mode
	====================			====================

	.. reference::			.. reference::

	:Mode: Sculpt Mode			:Mode: Sculpt Mode
	:Menu: :menuselection:`Sculpt --> Transfer Sculpt Mode`			:Menu: :menuselection:`Sculpt --> Transfer Sculpt Mode`
	:Shortcut: :kbd:`Alt-Q`			:Shortcut: :kbd:`Alt-Q`

	Switches Sculpt Mode from the :term:`Active` object to the object under the mouse.			Switches Sculpt Mode from the :term:`Active` object to the object under the mouse.
	See :ref:`bpy.ops.object.transfer_mode` for more information.			See :ref:`bpy.ops.object.transfer_mode` for more information.

				.. seealso::
				For a more general introduction see :doc:`Working with Multiple Objects </sculpt_paint/sculpting/introduction/multiple_objects>`.


				Rebuild BVH
				===========

				.. reference::

				:Mode: Sculpt Mode
				:Menu: :menuselection:`Sculpt --> Rebuild BVH`

				Recalculates the :term:`BVH` used by :doc:`/sculpt_paint/sculpting/tool_settings/dyntopo`
				to improve performance, which might degrade over time while using Dyntopo.

				.. seealso::
				For a more general introduction see :doc:`Adaptive Resolution </sculpt_paint/sculpting/introduction/adaptive>`.
				No newline at end of file