Tools

Tools in CAD Sketcher are either exposed as a workspacetool or as an operator. Note however that either of those use the same interaction system.

Generic Tools

`View3D_OT_slvs_add_sketch`

Add a sketch

`View3D_OT_slvs_delete_entity`

Delete selected sketch geometry

`View3D_OT_slvs_delete_constraint`

Delete constraint by type and index

Workspacetools

Workspacetools are used to interactively create entities. You can access them from the viewport's "T"-panel. Check the tools section to get familiar with the behavior of CAD Sketcher tools.

INFO: Interaction with extension geometry is only possible when one of the extension tools is active.

Workspacetool Access Keymap

Whenever one of the extension's tools is active the tool access keymap allows to quickly switch between the different tools.

Key	Modifier	Action
Esc / Rmb	-	Activate Tool: Select
P	-	Invoke Tool: Add Point 2D
L	-	Invoke Tool: Add Line 2D
C	-	Invoke Tool: Add Circle
A	-	Invoke Tool: Add Arc
R	-	Invoke Tool: Add Rectangle
Y	-	Invoke Tool: Trim
B	-	Invoke Tool: Bevel
O	-	Invoke Tool: Offset
S	-	Invoke Tool: Add Sketch

Dimensional Constraints:

Key	Modifier	Action
D	Alt	Distance
V	Alt	Vertical Distance
H	Alt	Horizontal Distance
A	Alt	Angle
O	Alt	Diameter
R	Alt	Radius

Geometric Constraints:

Key	Modifier	Action
C	Shift	Coincident
V	Shift	Vertical
H	Shift	Horizontal
E	Shift	Equal
A	Shift	Parallel
P	Shift	Perpendicular
T	Shift	Tangent
M	Shift	Midpoint
R	Shift	Ratio

Editing Keymap

Available while any of the extension's tools is active.

Key	Modifier	Action
X / Del	-	Delete selected entities
C	Ctrl	Copy
V	Ctrl	Paste
D	Shift	Duplicate & move
G	-	Move
V	-	Align view to the active entity
M	Alt	Merge points
C	Alt+Shift	Toggle construction mode

Global Shortcuts

Available in Object Mode regardless of the active tool.

Key	Modifier	Action
A	Ctrl+Shift	Add sketch / leave the active sketch
E	Ctrl+Shift	Extrude the active sketch
D	Ctrl+Shift	Linear array of the active sketch
M	Ctrl+Shift	Open the CAD Sketcher pie menu (drawing tools and constraints)
Esc	Shift	Switch to Blender's Select tool

Basic Tool Keymap

The basic tool interaction is consistent between tools.

Key	Modifier	Action
Tab	-	Jump to next tool state or property substate when in numerical edit
0-9 / (-)	-	Activate numeric edit
Enter / Lmb	-	Verify the operation
Esc / Rmb	-	Cancel the operation

While numeric edit is active

Key	Modifier	Action
Tab	-	Jump to next tool property substate
0-9	-	Activate numeric edit
Minus(-)	-	Toggle between positive and negative values

Selection tools

`View3D_OT_slvs_select`

Select an entity

Either the entity specified by the index property or the hovered index if the index property is not set

`View3D_OT_slvs_select_all`

Select / Deselect all entities

`View3D_OT_slvs_select_invert`

Invert entities selection

`View3D_OT_slvs_select_extend`

Select neighbour entities

`View3D_OT_slvs_select_extend_all`

Select neighbour entities

Keymap:

Key	Modifier	Action
LMB (click)	-	Toggle select
LMB (click)	Shift	Extend selection
LMB (click)	Ctrl	Subtract from selection
LMB (click)	Alt	Select the next entity in the overlapping stack under the cursor
Wheel	Alt	Cycle the hovered entity through overlapping ones without selecting
LMB (drag)	-	Box select, or tweak the hovered entity
LMB (drag)	Shift	Box select (extend)
LMB (drag)	Ctrl	Box select (subtract)
A	Ctrl	Select all
Esc	-	Deselect all
I	Ctrl	Invert selection
E	Ctrl	Extend selection in chain
E	Ctrl+Shift	Select full chain
Rmb	-	Open the context menu

INFO: LMB in empty space will also deselect all.

INFO: Chain selection works with coincident constraints too

INFO: When entities overlap, a plain click grabs the nearest one. Alt+click steps to the next entity down (repeat to dig through the stack), and Alt+wheel cycles the hovered entity so you can preview before clicking. This also works while picking geometry inside a drawing or constraint tool.

`View3D_OT_slvs_add_point2d`

Add a point to the active sketch

`View3D_OT_slvs_add_line2d`

Add a line to the active sketch

`View3D_OT_slvs_add_circle2d`

Add a circle to the active sketch

`View3D_OT_slvs_add_arc2d`

Add an arc to the active sketch

`View3D_OT_slvs_add_rectangle`

Add a rectangle to the active sketch

`View3D_OT_slvs_trim`

Trim segment to its closest intersections

`VIEW3D_OT_slvs_project_geometry`

Project a mesh object's edges onto the active sketch

Project Geometry brings a mesh object's edges into the active sketch as native construction points and lines. The projected points stay linked to their source vertices, so editing or transforming the source object updates the projection.

Workplane tools

A workplane is any Blender object whose transform defines the sketch plane (see code documentation). These operators manage the workplane an active sketch is anchored to.

`View3D_OT_slvs_align_workplane_cursor`

Align workplane to the 3D Cursor

`View3D_OT_slvs_make_workplane_free`

Detach this workplane from its mesh face and keep it where it is

`View3D_OT_slvs_reattach_workplane`

Click a mesh face to re-anchor this workplane to it