Update and improve snapping documentation #104750

Merged
Matthew Hinson merged 3 commits from mano-wii/blender-manual:transform_documentation into main 2024-04-21 20:04:49 +02:00
3 changed files with 13 additions and 7 deletions
Showing only changes of commit 59afa895b6 - Show all commits

View File

@ -33,17 +33,16 @@ or more temporarily by holding :kbd:`Ctrl`.
.. _bpy.types.ToolSettings.snap_target:
Snap With
Snap Base
=========
.. reference::
:Mode: Object, Edit, and Pose Mode
:Header: :menuselection:`Snapping --> Snap with`
:Header: :menuselection:`Snapping --> Snap Base`
:Shortcut: :kbd:`Shift-Ctrl-Tab`
Determines what part of the selection will coincide with the target.
(The rest of the selection will follow along.)
Determines which point in the geometry is the snap base that will snap to the target.
Active
Snaps using the origin (in Object Mode) or center (in Edit Mode) of the active element.
@ -225,3 +224,10 @@ Affect
Specifies which transformations are affected by snapping.
By default, snapping only happens while moving something,
but you can also enable it for rotating and scaling.
Matthew-Hinson marked this conversation as resolved Outdated

Keyboard shortcuts should be formatted like :kbd:`Shift`.
(Same for the UV editor)

Keyboard shortcuts should be formatted like :kbd:\`Shift\`. (Same for the UV editor)
Rotation Increment
======
Angle used in incremental snapping for the rotation operator.
The second value is the `Rotation Precision Increment`, used for finer transformations
and activated by default with the `Shift` key.

Binary file not shown.

View File

@ -41,7 +41,7 @@ The default hotkey in this case is :kbd:`Ctrl`.
Set Snap Base
-------------
Snap Base is taken automatically depending on the :ref:`Snap With <bpy.types.ToolSettings.snap_target>` options.
Snap Base is taken automatically depending on the :ref:`Snap Base <bpy.types.ToolSettings.snap_target>` options.
However, this automatic snap detection point of origin is not always what the user desires.
Therefore, transform operations have a utility to set a new snap origin point during the transformation.
By default the hotkey is :kbd:`B`.