blender/blender-manual
23
23
Fork 104
Code Issues 74 Pull Requests 6 Projects 1 Releases Wiki Activity

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
Conversation 1 Commits 3 Files Changed 4 +16 -20
3 changed files with 16 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 6a8fec1a4a - Show all commits

13
manual/editors/3dview/controls/snapping.rst
View File

@ -88,12 +88,9 @@ Determines the target which the selection will be snapped to.
Increment Increment
Snaps to grid points. When in Orthographic view, the snapping increment changes depending on the zoom level. Snaps to grid points. When in Orthographic view, the snapping increment changes depending on the zoom level.
.. note:: This option snaps to an imaginary grid that starts at the selection's original location and has the same
resolution as the viewport grid. In other words, it lets you move the selection in "increments" of the
By default, this option won't snap to the grid that's displayed in the viewport, grid cell size.
but an imaginary grid with the same resolution that starts at the selection's
original location. In other words, it lets you move the selection in "increments" of the
grid cell size.
Grid Grid
Snaps to the grid that's displayed in the viewport. Snaps to the grid that's displayed in the viewport.
Vertex Vertex
@ -220,8 +217,8 @@ By default, snapping only happens while moving something,
but you can also enable it for rotating and scaling. but you can also enable it for rotating and scaling.
Rotation Increment Rotation Increment
====== ==================
Angle used in incremental snapping for the rotation operator. Angle used in incremental snapping for the rotation operator.
The second value is the `Rotation Precision Increment`, used for finer transformations The second value is the `Rotation Precision Increment`, used for finer transformations
mano-wii marked this conversation as resolved
Matthew Hinson commented 2024-04-06 20:38:32 +02:00
Review
Copy Link

Please make sure the number of = signs matches the length of the title (same for the UV editor)

Please make sure the number of `=` signs matches the length of the title (same for the UV editor)
and activated by default with the `Shift` key. and activated by default with the :kbd:`Shift` key.

13
manual/editors/uv/controls/snapping.rst
View File

@ -23,12 +23,9 @@ Snap Target
Increment Increment
Snaps to grid points. Snaps to grid points.
.. note:: This option snaps to an imaginary grid that starts at the selection's original location and has the same
resolution as the grid displayed in the editor. In other words, it lets you move the selection in
By default, this option won't snap to the grid that's displayed in the editor, "increments" of the grid cell size.
but an imaginary grid with the same resolution that starts at the selection's
original location. In other words, it lets you move the selection in "increments" of the
grid cell size.
Grid Grid
Snaps to grid points. Snaps to grid points.
@ -53,8 +50,8 @@ but you can also enable it for rotating and scaling.
Rotation Increment Rotation Increment
====== ==================
Angle used in incremental snapping for the rotation operator. Angle used in incremental snapping for the rotation operator.
The second value is the `Rotation Precision Increment`, used for finer transformations The second value is the `Rotation Precision Increment`, used for finer transformations
and activated by default with the `Shift` key. and activated by default with the :kbd:`Shift` key.

10
manual/modeling/transform/modal_map.rst
View File

@ -41,9 +41,11 @@ The default hotkey in this case is :kbd:`Ctrl`.
Set Snap Base Set Snap Base
------------- -------------
Snap Base is taken automatically depending on the :ref:`Snap Base <bpy.types.ToolSettings.snap_target>` options. The Snap Base is automatically determined based 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. However, this automatic snap detection point of origin may not always align with the user's intentions.
Therefore, transform operations have a utility to set a new snap origin point during the transformation. Therefore, transform operations include a utility to set a new snap origin point during the transformation.
The new Snap Base will correspond to the snap point whose target is defined by the
:ref:`Snap Target <bpy.types.ToolSettings.snap_elements_base>`.
By default the hotkey is :kbd:`B`. By default the hotkey is :kbd:`B`.
@ -51,7 +53,7 @@ By default the hotkey is :kbd:`B`.
.. note:: .. note::
mano-wii marked this conversation as resolved
Matthew Hinson commented 2024-04-06 21:08:20 +02:00
Review
Copy Link

Could add some explanation about how this Set Snap Base command actually works, because right now, it's rather minimal and the note kind of comes out of nowhere. (The section is about setting the Snap Base, so why is there suddenly a note about the Snap Target?)

The first snap target which the note refers to is called "Vertex" in the UI, not "Vert." Also, are you sure that Edge Perpendicular is used? I tried it but couldn't confirm.

Could add some explanation about how this Set Snap Base command actually works, because right now, it's rather minimal and the note kind of comes out of nowhere. (The section is about setting the Snap Base, so why is there suddenly a note about the Snap Target?) The first snap target which the note refers to is called "Vertex" in the UI, not "Vert." Also, are you sure that Edge Perpendicular is used? I tried it but couldn't confirm.
If only Snap to Increment is enabled as :ref:`Snap Target <bpy.types.ToolSettings.snap_elements_base>`, If only Snap to Increment is enabled as :ref:`Snap Target <bpy.types.ToolSettings.snap_elements_base>`,
the targets `Vert`, `Edge`, `Face`, `Edge Center`, `Edge Perpendicular` will be used instead. the targets `Vertex`, `Edge`, `Face` and `Edge Center` will be used instead.
Add Snap Point Add Snap Point