Skip to content

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

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 - 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
S - Invoke Tool: Add Sketch
Y - Invoke Tool: Trim

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
P Shift Parallel
N Shift Perpendicular
T Shift Tangent
M Shift Midpoint
R Shift Ratio

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 - Toggle Select
ESC - Deselect All
I Ctrl Inverse selection
E Ctrl Extend selection in chain
E Ctrl+Shift Select full chain

INFO: LMB in empty space will also deselect all.

INFO: Chain selection works with coincident constraints too

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

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