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 Entity by index or based on the selection if index isn't provided

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 BGS tools.

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

Workspacetool Access Keymap

Whenever one of the addon'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

TODO: Add selection modes

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_point3d

Add a point in 3d space

View3D_OT_slvs_add_line3d

Add a line in 3d space

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_add_workplane

Add a workplane

View3D_OT_slvs_add_workplane_face

Add a statically placed workplane, orientation and location is copied from selected mesh face

View3D_OT_slvs_trim

Trim segment to its closest intersections