Draft Snap: Difference between revisions

From FreeCAD Documentation
No edit summary
(PR11688: MarkerSize)
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Page in progress}}
<languages/>
<languages/>
<translate>
<translate>
Line 5: Line 4:
<!--T:15-->
<!--T:15-->
{{Docnav
{{Docnav
|[[Draft_snap_widget|Snap widget]]
|
|[[Draft_Constrain|Constrain]]
|
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=
|
|IconR=
|
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 20: Line 19:


<!--T:1-->
<!--T:1-->
In the [[Image:Workbench_Draft.svg|24px]] [[Draft_Module|Draft Workbench]] and the [[Image:Workbench_Arch.svg|24px]] [[Arch_Module|Arch Workbench]] you can create geometry by picking points in the [[3D_view|3D view]] or by entering coordinates in the [[Task_panel|task panel]] of commands. Another way of selecting points is by snapping. Snapping allows to select exact geometric points on, or defined by, existing objects. You can for example snap to the endpoint of a line, to the center of a circle, or to the intersection of two edges.
In the [[Image:Workbench_Draft.svg|24px]] [[Draft_Workbench|Draft Workbench]] and the [[Image:Workbench_Arch.svg|24px]] [[Arch_Workbench|Arch Workbench]] you can create geometry by picking points in the [[3D_view|3D view]] or by entering coordinates in the [[Task_panel|task panel]] of commands. Another way of selecting points is by snapping. Snapping allows to select exact geometric points on, or defined by, existing objects or the grid. You can for example snap to the endpoint of a line, to the center of a circle, or to the intersection of two edges.


<!--T:9-->
<!--T:9-->
Snapping is available with most [[Draft_Module|Draft]] and [[Arch_Module|Arch]] commands.
Snapping is available with most [[Draft_Workbench|Draft]] and [[Arch_Workbench|Arch]] commands.


</translate>
</translate>
[[Image:Draft_Snap_example.jpg]]
[[Image:Draft_Snap_Endpoint_example.png]]
<translate>
<translate>
<!--T:2-->
<!--T:2-->
{{Caption|Line snapping perpendicularly to another line}}
{{Caption|Snapping to the endpoint of an edge}}


== Snap tools ==
== Snap tools == <!--T:22-->


<!--T:23-->
These tools are available in the Draft Snap toolbar and in the [[Draft_snap_widget|Draft snap widget]].
These tools are available in the Draft snap toolbar and in the [[Draft_snap_widget|Draft snap widget]].


<!--T:24-->
Note that circular edges do not have to be full circles.
Note that circular edges do not have to be full circles.


<!--T:19-->
<!--T:19-->
* [[Image:Draft_Snap_Lock.svg|32px]] [[Draft_Snap_Lock|Snap Lock]]: enables or disables snapping globally.
* [[Image:Draft_Snap_Lock.svg|32px]] [[Draft_Snap_Lock|Snap lock]]: enables or disables snapping globally.


<!--T:25-->
* [[Image:Draft_Snap_Endpoint.svg|32px]] [[Draft_Snap_Endpoint|Snap Endpoint]]: snaps to the endpoints of edges.
* [[Image:Draft_Snap_Endpoint.svg|32px]] [[Draft_Snap_Endpoint|Snap endpoint]]: snaps to the endpoints of edges.


<!--T:26-->
* [[Image:Draft_Snap_Midpoint.svg|32px]] [[Draft_Snap_Midpoint|Snap Midpoint]]: snaps to the midpoint of straight and circular edges.
* [[Image:Draft_Snap_Midpoint.svg|32px]] [[Draft_Snap_Midpoint|Snap midpoint]]: snaps to the midpoint of edges.


<!--T:27-->
* [[Image:Draft_Snap_Center.svg|32px]] [[Draft_Snap_Center|Snap Center]]: snaps to the center point of faces and circular edges, and to the {{PropertyData|Placement}} point of [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]] and [[Arch_BuildingPart|Arch BuildingParts]].
* [[Image:Draft_Snap_Center.svg|32px]] [[Draft_Snap_Center|Snap center]]: snaps to the center point of faces and circular edges, and to the {{PropertyData|Placement}} point of [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]] and [[Arch_BuildingPart|Arch BuildingParts]].


<!--T:28-->
* [[Image:Draft_Snap_Angle.svg|32px]] [[Draft_Snap_Angle|Snap Angle]]: snaps to the special cardinal points on circular edges, at multiples of 30° and 45°.
* [[Image:Draft_Snap_Angle.svg|32px]] [[Draft_Snap_Angle|Snap angle]]: snaps to the special cardinal points on circular edges, at multiples of 30° and 45°.


<!--T:29-->
* [[Image:Draft_Snap_Intersection.svg|32px]] [[Draft_Snap_Intersection|Snap Intersection]]: snaps to the intersection of two edges.
* [[Image:Draft_Snap_Intersection.svg|32px]] [[Draft_Snap_Intersection|Snap intersection]]: snaps to the intersection of two edges.


<!--T:30-->
* [[Image:Draft_Snap_Perpendicular.svg|32px]] [[Draft_Snap_Perpendicular|Snap Perpendicular]]: snaps to the perpendicular point on edges.
* [[Image:Draft_Snap_Perpendicular.svg|32px]] [[Draft_Snap_Perpendicular|Snap perpendicular]]: snaps to the perpendicular points on faces ({{Version|0.21}}) and edges.


<!--T:31-->
* [[Image:Draft_Snap_Extension.svg|32px]] [[Draft_Snap_Extension|Snap Extension]]: snaps to an imaginary line that extends beyond the endpoints of straight edges.
* [[Image:Draft_Snap_Extension.svg|32px]] [[Draft_Snap_Extension|Snap extension]]: snaps to an imaginary line that extends beyond the endpoints of straight edges.


<!--T:32-->
* [[Image:Draft_Snap_Parallel.svg|32px]] [[Draft_Snap_Parallel|Snap Parallel]]: snaps to an imaginary line parallel to straight edges.
* [[Image:Draft_Snap_Parallel.svg|32px]] [[Draft_Snap_Parallel|Snap parallel]]: snaps to an imaginary line parallel to straight edges.


<!--T:33-->
* [[Image:Draft_Snap_Special.svg|32px]] [[Draft_Snap_Special|Snap Special]]: snaps to special points defined by the object.
* [[Image:Draft_Snap_Special.svg|32px]] [[Draft_Snap_Special|Snap special]]: snaps to special points defined by the object.


<!--T:34-->
* [[Image:Draft_Snap_Near.svg|32px]] [[Draft_Snap_Near|Snap Near]]: snaps to the nearest point on faces or edges.
* [[Image:Draft_Snap_Near.svg|32px]] [[Draft_Snap_Near|Snap near]]: snaps to the nearest point on faces and edges.


<!--T:35-->
* [[Image:Draft_Snap_Ortho.svg|32px]] [[Draft_Snap_Ortho|Snap Ortho]]: snaps to imaginary lines that cross the previous point at 0°, 45°, 90° and 135°.
* [[Image:Draft_Snap_Ortho.svg|32px]] [[Draft_Snap_Ortho|Snap ortho]]: snaps to imaginary lines that cross the previous point at multiples of 45°.


<!--T:36-->
* [[Image:Draft_Snap_Grid.svg|32px]] [[Draft_Snap_Grid|Snap Grid]]: snaps to the intersections of grid lines.
* [[Image:Draft_Snap_Grid.svg|32px]] [[Draft_Snap_Grid|Snap grid]]: snaps to the intersections of grid lines.


<!--T:37-->
* [[Image:Draft_Snap_WorkingPlane.svg|32px]] [[Draft_Snap_WorkingPlane|Snap Working Plane]]: projects the snap point on the current [[Draft_SelectPlane|working plane]].
* [[Image:Draft_Snap_WorkingPlane.svg|32px]] [[Draft_Snap_WorkingPlane|Snap working plane]]: projects snap points onto the current [[Draft_SelectPlane|working plane]].


<!--T:38-->
* [[Image:Draft_Snap_Dimensions.svg|32px]] [[Draft_Snap_Dimensions|Snap Dimensions]]: shows temporary X and Y dimensions.
* [[Image:Draft_Snap_Dimensions.svg|32px]] [[Draft_Snap_Dimensions|Snap dimensions]]: shows temporary X and Y dimensions.


<!--T:39-->
* [[Image:Draft_ToggleGrid.svg|32px]] [[Draft_ToggleGrid|Toggle Grid]]: switches the grid on or off.
* [[Image:Draft_ToggleGrid.svg|32px]] [[Draft_ToggleGrid|Toggle grid]]: changes the visibility of the grid.


== Advanced snapping == <!--T:11-->
== Advanced snapping == <!--T:11-->


<!--T:12-->
<!--T:12-->
* Press {{KEY|`}} one or more times to snap to an object that is obscured by other geometry. This is called "snap cycling". Note that you must move the pointer by a small amount in the [[3D_view|3D view]] after pressing the key.
* Additional snap points can be obtained by combining two snap options. For example combining [[Draft_Snap_Ortho|Draft Snap Ortho]] and [[Draft_Snap_Extension|Draft Snap Extension]] will give you a snap point at the intersection of their imaginary lines.
* Additional snap points can be obtained by combining two snap options. For example combining [[Draft_Snap_Ortho|Draft Snap Ortho]] and [[Draft_Snap_Extension|Draft Snap Extension]] will give you a snap point at the intersection of their imaginary lines.
* Other snap points can be obtained by using [[Draft_Constrain|Draft Constraints]]: by holding {{KEY|Shift}}, or pressing {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}}.
* Snapping can be combined with [[Draft_Constrain|constraining]].
* Press {{KEY|Q}} to insert a "hold point" at the current location of the pointer. You can snap to the orthogonal axes of hold points, and to the intersections of these axes. If the [[Draft_Snap_Midpoint|Draft Snap Midpoint]] option is enabled, you can also snap to the midpoint between two hold points.
* Press {{KEY|Q}} to insert a "hold point" at the current location of the cursor. You can snap to the orthogonal axes of hold points, and to the intersections of these axes. If the [[Draft_Snap_Midpoint|Draft Snap Midpoint]] option is active, you can also snap to the midpoint between two hold points.
* Press {{KEY|`}} one or more times to snap to an object that is obscured by other geometry. This is called "snap cycling". Note that you must move the cursor by a small amount in the [[3D_view|3D view]] after pressing the key.

</translate>
[[Image:Draft_Snap_example_cycling_1.png]]
<translate>
<!--T:40-->
{{Caption|Snap cycling 1: The red rectangle was created first therefore it has snap priority. Without snap cycling you cannot snap to the green rectangle where it is overlapped by the red rectangle.}}

</translate>
[[Image:Draft_Snap_example_cycling_2.png]]
<translate>
<!--T:41-->
{{Caption|Snap cycling 2: After using the snap cycle key once the green rectangle receives snap priority. Snapping to the midpoint of the overlapped green edge is now possible.}}


== Notes == <!--T:21-->
== Notes == <!--T:21-->
Line 82: Line 110:
<!--T:10-->
<!--T:10-->
* Multiple snap options can be active at the same time, but it is advisable to only activate the snap options you really need. Activating too many can slow things down.
* Multiple snap options can be active at the same time, but it is advisable to only activate the snap options you really need. Activating too many can slow things down.
* It is not a good idea to have [[Draft_Snap_Near|Draft Snap Near]] permanently active as it makes using several other snap options almost impossible.
* It is not a good idea to have [[Draft_Snap_Near|Draft Snap Near]] permanently active as it takes precedence over many other snap options.


== Preferences == <!--T:18-->
== Preferences == <!--T:18-->


<!--T:42-->
See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]].
See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]].


<!--T:4-->
<!--T:4-->
* When a [[Draft_Module|Draft]] or [[Arch_Module|Arch]] command requiring point input is active, the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines can be changed on-the-fly by pressing {{KEY|[}} (increase key) or {{KEY|]}} (decrease key). This setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange}}. It can also be changed in the task panel of the [[Draft_SelectPlane|Draft SelectPlane]] command.
* When a [[Draft_Workbench|Draft]] or [[Arch_Workbench|Arch]] command requiring point input is active, the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines can be changed on-the-fly by pressing {{KEY|P}} (increase key) or {{KEY|M}} (decrease key). This setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange}}. It can also be changed in the task panel of the [[Draft_SelectPlane|Draft SelectPlane]] command.
* To only snap when the {{MenuCommand|Snap mod}} key is held down:
* To only snap when the {{MenuCommand|Snap modifier}} key is held down:
** Deselect: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snapping → Always snap (disable snap mod)}}.
** Deselect: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Always snap}}.
** The default {{MenuCommand|Snap mod}} key, {{KEY|Ctrl}}, can be changed: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snapping → Snap mod}}.
** The default {{MenuCommand|Snap modifier}} key, {{KEY|Ctrl}}, can be changed: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snap modifier}}.
* To only show the Draft Snap toolbar when a command is active:
* To only show the Draft snap toolbar when a command is active select: {{MenuCommand|Edit → Preferences... → Draft → Interface → Only show the Draft snap toolbar during commands}}. {{Version|0.22}}
** Select: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snapping → Show Draft Snap toolbar}}.
* The snap symbols can be changed: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snap symbol style}}.
** Select: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snapping → Hide Draft Snap toolbar after use}}.
* The color of the snap symbols and the dimensions of [[Draft_Snap_Dimensions|Draft Snap Dimensions]] can be changed: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping → Snap symbol color}}.
* The snap symbols can be changed: {{MenuCommand|Edit → Preferences... → DraftVisual settingsVisual settings → Snap symbol style}}.
* The size of the snap symbols depends on: {{MenuCommand|Edit → Preferences... → Display3D ViewMarker size}}. {{Version|0.22}}
* The color of the snap symbols can be changed: {{MenuCommand|Edit → Preferences... → Draft → Visual settingsVisual settings → Color}}.
* The mentioned single character keyboard shortcuts can be changed: {{MenuCommand|Edit → Preferences... → Draft → InterfaceIn-command shortcuts}}.
* The mentioned single character keyboard shortcuts can be changed: {{MenuCommand|Edit → Preferences... → Draft → User interface settings → In-Command Shortcuts}}.




<!--T:5-->
<!--T:5-->
{{Docnav
{{Docnav
|[[Draft_snap_widget|Snap widget]]
|
|[[Draft_Constrain|Constrain]]
|
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=
|
|IconR=
|
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}

Revision as of 21:00, 8 December 2023

Description

In the Draft Workbench and the Arch Workbench you can create geometry by picking points in the 3D view or by entering coordinates in the task panel of commands. Another way of selecting points is by snapping. Snapping allows to select exact geometric points on, or defined by, existing objects or the grid. You can for example snap to the endpoint of a line, to the center of a circle, or to the intersection of two edges.

Snapping is available with most Draft and Arch commands.

Snapping to the endpoint of an edge

Snap tools

These tools are available in the Draft snap toolbar and in the Draft snap widget.

Note that circular edges do not have to be full circles.

  • Snap lock: enables or disables snapping globally.
  • Snap angle: snaps to the special cardinal points on circular edges, at multiples of 30° and 45°.
  • Snap extension: snaps to an imaginary line that extends beyond the endpoints of straight edges.
  • Snap parallel: snaps to an imaginary line parallel to straight edges.
  • Snap special: snaps to special points defined by the object.
  • Snap near: snaps to the nearest point on faces and edges.
  • Snap ortho: snaps to imaginary lines that cross the previous point at multiples of 45°.
  • Snap grid: snaps to the intersections of grid lines.

Advanced snapping

  • Additional snap points can be obtained by combining two snap options. For example combining Draft Snap Ortho and Draft Snap Extension will give you a snap point at the intersection of their imaginary lines.
  • Snapping can be combined with constraining.
  • Press Q to insert a "hold point" at the current location of the cursor. You can snap to the orthogonal axes of hold points, and to the intersections of these axes. If the Draft Snap Midpoint option is active, you can also snap to the midpoint between two hold points.
  • Press ` one or more times to snap to an object that is obscured by other geometry. This is called "snap cycling". Note that you must move the cursor by a small amount in the 3D view after pressing the key.

Snap cycling 1: The red rectangle was created first therefore it has snap priority. Without snap cycling you cannot snap to the green rectangle where it is overlapped by the red rectangle.

Snap cycling 2: After using the snap cycle key once the green rectangle receives snap priority. Snapping to the midpoint of the overlapped green edge is now possible.

Notes

  • Multiple snap options can be active at the same time, but it is advisable to only activate the snap options you really need. Activating too many can slow things down.
  • It is not a good idea to have Draft Snap Near permanently active as it takes precedence over many other snap options.

Preferences

See also: Preferences Editor and Draft Preferences.

  • When a Draft or Arch command requiring point input is active, the maximum distance at which Draft Snap Grid detects the intersections of grid lines can be changed on-the-fly by pressing P (increase key) or M (decrease key). This setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange. It can also be changed in the task panel of the Draft SelectPlane command.
  • To only snap when the Snap modifier key is held down:
    • Deselect: Edit → Preferences... → Draft → Grid and snapping → Always snap.
    • The default Snap modifier key, Ctrl, can be changed: Edit → Preferences... → Draft → Grid and snapping → Snap modifier.
  • To only show the Draft snap toolbar when a command is active select: Edit → Preferences... → Draft → Interface → Only show the Draft snap toolbar during commands. introduced in version 0.22
  • The snap symbols can be changed: Edit → Preferences... → Draft → Grid and snapping → Snap symbol style.
  • The color of the snap symbols and the dimensions of Draft Snap Dimensions can be changed: Edit → Preferences... → Draft → Grid and snapping → Snap symbol color.
  • The size of the snap symbols depends on: Edit → Preferences... → Display → 3D View → Marker size. introduced in version 0.22
  • The mentioned single character keyboard shortcuts can be changed: Edit → Preferences... → Draft → Interface → In-command shortcuts.