[Bf-docboard-svn] bf-manual: [9554] branches/blender-3.3-release/blender_docs/manual/editors/3dview/controls/snapping.rst: Transform Snap: nearest face snap mode, snapping options, refactoring

[Aaron Carlisle]

Revision: 9554
          https://developer.blender.org/rBM9554
Author:   Blendify
Date:     2022-09-12 02:50:07 +0200 (Mon, 12 Sep 2022)
Log Message:
-----------
Transform Snap: nearest face snap mode, snapping options, refactoring

rB011327224ecec1312e0780865a1fb0dc83830a30

Modified Paths:
--------------
    branches/blender-3.3-release/blender_docs/manual/editors/3dview/controls/snapping.rst

Modified: branches/blender-3.3-release/blender_docs/manual/editors/3dview/controls/snapping.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/editors/3dview/controls/snapping.rst	2022-09-11 02:09:15 UTC (rev 9553)
+++ branches/blender-3.3-release/blender_docs/manual/editors/3dview/controls/snapping.rst	2022-09-12 00:50:07 UTC (rev 9554)
@@ -53,9 +53,13 @@
    Snaps to the nearest vertex of a mesh object.
 Edge
    Snaps to the nearest point on the nearest edge.
-Face
-   Snaps to the nearest point on the nearest face.
-   This is useful for retopologizing.
+Face Project
+   Snaps to the face by projecting the current point on the nearest face.
+   This snap mode will snap geometry to both visible and occluded.
+   This snap mode is useful for retopologizing.
+Face Nearest
+   Snaps to the nearest surface in world space.
+   This snap mode will only snap geometry to visible (non occluded) geometry.
 Volume
    Snaps to regions within the volume of the first object found below the mouse cursor.
    Unlike the other options, this option controls the depth
@@ -115,8 +119,8 @@
           Median.
 
 
-Additional Options
-==================
+Target Selection
+================
 
 .. figure:: /images/editors_3dview_controls_snapping_options.png
 
@@ -124,6 +128,31 @@
 additional controls are available to alter snap behavior. These options vary between mode
 (Object and Edit) as well as snap target. The available options are:
 
+.. _bpy.types.ToolSettings.use_snap_self:
+
+Include Active
+   Only available in Edit Mode.
+   Allows snapping mesh elements to other elements of the same mesh.
+
+   This checkbox is ignored if
+   :doc:`Proportional Editing </editors/3dview/controls/proportional_editing>`
+   is enabled.
+
+.. _bpy.types.ToolSettings.use_snap_edit:
+
+Include Edited :guilabel:`Edit Mode`
+   Snap onto non-active objects in Edit Mode.
+
+.. _bpy.types.ToolSettings.use_snap_nonedit:
+
+Include Non-Edited :guilabel:`Edit Mode`
+   Snap onto objects not in Edit Mode.
+
+.. _bpy.types.ToolSettings.use_snap_selectable:
+
+Exclude Non-Selectable
+   Snap only onto objects that are selectable.
+
 .. _bpy.types.ToolSettings.use_snap_grid_absolute:
 
 Absolute Grid Snap
@@ -135,16 +164,6 @@
 Backface Culling
    Exclude back-facing geometry from snapping.
 
-.. _bpy.types.ToolSettings.use_snap_self:
-
-Project Onto Self
-   Only available in Edit Mode.
-   Allows snapping mesh elements to other elements of the same mesh.
-
-   This checkbox is ignored if
-   :doc:`Proportional Editing </editors/3dview/controls/proportional_editing>`
-   is enabled.
-
 .. _bpy.types.ToolSettings.use_snap_align_rotation:
 
 Align Rotation to Target
@@ -167,6 +186,17 @@
 
       :doc:`/modeling/modifiers/deform/shrinkwrap`
 
+.. _bpy.types.ToolSettings.use_snap_to_same_target:
+
+Snap to Same Target :guilabel:`Face Nearest`
+   Snap only to target that source was initially near.
+
+.. _bpy.types.ToolSettings.snap_face_nearest_steps:
+
+Face Nearest Steps :guilabel:`Face Nearest`
+   Number of steps to break transformation into for face nearest snapping.
+   This option is only available in Edit mode.
+
 .. _bpy.types.ToolSettings.use_snap_peel_object:
 
 Snap Peel Object
@@ -173,21 +203,24 @@
    Only available if Snap To Volume is enabled.
    Consider objects as a whole when finding volume center.
 
+
 .. _bpy.types.ToolSettings.use_snap_translate:
 .. _bpy.types.ToolSettings.use_snap_rotate:
 .. _bpy.types.ToolSettings.use_snap_scale:
 
 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.
+======
 
+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.
 
+
 Multiple Snap Targets
 ---------------------
 
 While you're transforming a selection with snapping enabled,
-you can press :kbd:`A` whenever there's a hilighted snap target to
+you can press :kbd:`A` whenever there's a highlighted snap target to
 mark it. With multiple such targets marked, the selection will
 then be snapped to their average location.