Beam Bench Docs

Node Edit

Edit vector path nodes, drag, add, delete, change handle type. Beam Bench's most complex tool.

The Node tool is for fine-grained editing of vector paths: move individual nodes, add or remove them, change handle types, split paths, join paths, convert curves to lines and back. It has the most sub-modes of any tool.

Activate

  • Hotkey: Ctrl+`
  • Toolbar: Creation Toolbar

How to use

  1. Select a vector path object.
  2. Activate the Node tool.
  3. The path's nodes and handles become visible.
  4. Click and drag a node to move it.
  5. Or pick a sub-mode and click in the path to perform that sub-mode's action.

Non-vector-path objects (rectangles, ellipses, polygons, stars, text) are converted to a path on the first edit, lazily.

Sub-modes

The Node tool has many sub-modes. The active one is picked via toolbar buttons or single-key shortcuts (while the tool is active):

KeySub-modeEffect
(default)SelectClick and drag nodes.
MInsert midpointClick any segment to add a node at its midpoint.
IInsertClick any point on a segment to add a node there.
DDelete nodeClick a node to delete it.
BBreakClick a node to break the path there into two subpaths.
XDelete segmentClick a segment to delete it.
LTo lineClick a curve segment to convert it to a straight line.
STo smoothClick a node to make its handles smooth (continuous tangent).
CTo cornerClick a node to make it a corner (independent handles).
AAlignAlign selected handles.
TTrimTrim the path at the clicked point.
EExtendExtend the path from an endpoint.
ZClose / openToggle whether the selected path is closed.
JAuto-joinAutomatically join nearby subpath endpoints.

Modifiers and interactions

  • Shift + drag a node: constrain motion to cardinal directions (8-way: 0°, 45°, 90°, ...).
  • Alt + drag a node: constrain to vertical only.
  • Arrow keys: nudge selected nodes.
    • Shift + arrow: coarse nudge.
    • Ctrl + arrow: fine nudge.
  • Drag a handle: the opposite handle mirrors automatically (for smooth nodes).
  • Drag an endpoint near another endpoint: a join indicator appears; releasing joins the two subpaths.
  • Esc: exit any in-progress operation.

Working with handles

Each node has zero, one, or two Bezier handles:

  • Corner nodes have independent handles. Dragging one does not affect the other.
  • Smooth nodes have mirrored handles. Dragging one moves the other to maintain a straight line through the node.
  • Drag the small handle dot to reshape the curve into / out of the node.

What gets modified

The selected path is modified in place. No new objects are created (except when a shape is converted to a path on first edit).

Behavior worth knowing

  • All actions are undoable. Each drag commits as a single undo step.
  • Auto-join (J) is helpful after manual trimming or breaking when you want to clean up.
  • The Node tool does not need a sub-mode for moving, the default click-and-drag works regardless of active sub-mode.

On this page