1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
|
.. |snap-header-icon| image:: /images/editors_3dview_controls_snapping_header-magnet-icon.png
.. _bpy.types.ToolSettings.use_snap:
********
Snapping
********
.. reference::
:Mode: Object, Edit, and Pose Mode
:Header: :menuselection:`Snap` (|snap-header-icon|)
:Shortcut: :kbd:`Shift-Tab`
.. figure:: /images/editors_3dview_controls_snapping_element-menu.png
:align: right
Snap menu.
Snapping lets you easily align objects and mesh elements to others.
It can be toggled by clicking the magnet icon in the 3D Viewport's header,
or more temporarily by holding :kbd:`Ctrl`.
.. container:: lead
.. clear
.. seealso::
Transform operators have their own snapping operators,
see :doc:`Transform Modal Map </modeling/transform/modal_map>`
.. _bpy.types.ToolSettings.snap_target:
Snap Base
=========
.. reference::
:Mode: Object, Edit, and Pose Mode
:Header: :menuselection:`Snapping --> Snap Base`
:Shortcut: :kbd:`Shift-Ctrl-Tab`
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.
:Median:
Snaps using the median of the selection.
:Center:
Snaps using the current transformation center
(another word for the :doc:`pivot point </editors/3dview/controls/pivot_point/index>`).
This option is especially useful in combination with the
:doc:`3D Cursor </editors/3dview/3d_cursor>` for choosing the snapping
point completely manually.
:Closest:
Snaps using the vertex that's closest to the target.
.. list-table::
* - .. figure:: /images/editors_3dview_controls_snapping_target-closest.png
Closest.
- .. figure:: /images/editors_3dview_controls_snapping_target-active.png
Active.
- .. figure:: /images/editors_3dview_controls_snapping_target-median.png
Median.
.. _bpy.types.ToolSettings.snap_elements_base:
Snap Target
===========
.. reference::
:Mode: Object, Edit, and Pose Mode
:Header: :menuselection:`Snapping --> Snap Target`
:Shortcut: :kbd:`Shift-Ctrl-Tab`
Determines the target which the selection will be snapped to.
:Increment:
Snaps to grid points. When in Orthographic view, the snapping increment changes depending on the zoom level.
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
grid cell size.
:Grid:
Snaps to the grid that's displayed in the viewport.
:Vertex:
Snaps to the vertex that's closest to the mouse cursor.
:Edge:
Snaps to the edge that's closest to the mouse cursor.
:Volume:
Snaps the selection to a depth that's centered *inside* the object under the cursor.
This is useful for positioning an :doc:`Armature </animation/armatures/introduction>`
bone so it's centered inside a character's arm, for example; the other snapping options
would place it on the arm's surface instead.
While Blender also has :doc:`Volume objects </modeling/volumes/introduction>`, this option
is not related to those.
:Edge Center:
Snaps to the centerpoint of the edge that's closest to the mouse cursor.
:Edge Perpendicular:
Snaps to a specific point on the edge so that the line from the selection's original location
(indicated by a white cross) to its new location is perpendicular to that edge.
.. tip::
Multiple snapping modes can be enabled at once using :kbd:`Shift-LMB`.
.. _bpy.types.ToolSettings.snap_elements_individual:
Snap Target for Individual Elements
===================================
.. reference::
:Mode: Object, Edit, and Pose Mode
:Header: :menuselection:`Snapping --> Snap Target for Individual Elements`
:Shortcut: :kbd:`Shift-Ctrl-Tab`
Type of element for individual transformed elements to snap to.
:Face Project:
Snaps to the face that's under the mouse cursor.
This can be used for bending a flat sheet so it snugly fits against a curved surface, for example.
This works similar to the :doc:`/modeling/modifiers/deform/shrinkwrap`.
:Face Nearest:
Individually snaps each object (in Object Mode) or vertex (in Edit Mode) to the face that's closest
to its new location. This makes it possible to snap to occluded geometry.
Target Selection
================
Sets more detailed snapping options. The available options depend on the mode
(Object/Edit) as well as the :ref:`Snap Target <bpy.types.ToolSettings.snap_elements_base>`.
.. _bpy.types.ToolSettings.use_snap_self:
Include Active :guilabel:`Edit Mode`
Snap to other mesh elements of the active object.
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 to other objects that are also in Edit Mode.
.. _bpy.types.ToolSettings.use_snap_nonedit:
Include Non-Edited :guilabel:`Edit Mode`
Snap to other objects that are not in Edit Mode.
.. _bpy.types.ToolSettings.use_snap_selectable:
Exclude Non-Selectable
Snap only to objects that are selectable.
.. _bpy.types.ToolSettings.use_snap_align_rotation:
Align Rotation to Target
Rotates the selection so that its Z axis gets aligned to the normal of the target.
.. _bpy.types.ToolSettings.use_snap_backface_culling:
Backface Culling
Exclude back-facing geometry from snapping.
.. _bpy.types.ToolSettings.use_snap_to_same_target:
Snap to Same Target :guilabel:`Face Nearest`
Snap only to the object which the selection was nearest to before starting
the transformation.
.. _bpy.types.ToolSettings.snap_face_nearest_steps:
Face Nearest Steps :guilabel:`Face Nearest` :guilabel:`Edit Mode`
Breaks the overall transformation into multiple steps, performing a snap each time.
This can give better results in certain cases.
.. _bpy.types.ToolSettings.use_snap_peel_object:
Snap Peel Object :guilabel:`Volume`
If the target object is composed of several disconnected mesh islands that
intersect each other, "Snap To Volume" will normally snap to the island which the
mouse is hovering over, ignoring the other islands. By enabling "Snap Peel Object,"
you can instead treat the target object as one connected whole.
.. _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.
.. _bpy.types.ToolSettings.snap_angle_increment_3d:
.. _bpy.types.ToolSettings.snap_angle_increment_3d_precision:
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 :kbd:`Shift` key.
|
