napkin-sketchdocs 1.0.0 GitHub

Gestures and input#

On this page

At a glance#

Held keys and gestures#

ActionHow
Rotate Copic nibHold Ctrl still 1s, then Alt / Shift
Zoom (mouse)Hold Alt and scroll the wheel
Zoom In / Zoom OutCtrl++ / Ctrl+-, or the View menu
Pan (mouse)Scroll to pan; Ctrl+Shift + scroll pans across
Pan (any tool)Hold Space and drag
Select with a drawing toolHold Ctrl (Select or Direct, whichever was last)
Straight linePress, then hold Space
Lock a line to 45°Shift while dragging (release to free)
Shift-click lineClick or draw, then Shift + click
Quick curve (ellipse)Press, then hold Ctrl + Space
Quick curve (circle)Press, then hold Ctrl + Space + Alt
Open the menu barAlt alone, after 5 s with no other key
Swing a quick curve apexShift (90° clockwise per press)
Endpoint snapHold Shift while drawing
Edit a vector pathVector Path tool, click a committed path
Hold a vector point to 45°Hold Shift while placing it or pulling its handle
Close a vector pathClick the first point where the close indicator shows
Move point / round cornerCtrl (drag point, handle, or target)
Toggle anchor handlesAlt + click the anchor
Step a Move fieldArrow keys; hold Shift for a coarse step
Keep the shapeHold Shift while dragging a handle
Scale from the centreHold Alt while dragging a handle
Turn by handDrag on the canvas while Rotate is open
Dock / undock a panelThe button in the panel's title bar
Move the rotation centreClick the canvas, drag the crosshair, the grid, or Centre x / y
Snap a rotation to 15°Hold Shift while dragging, or the Snap toggle
Close shapeClose Shape button, then Sharp or Smooth
Drag-copy selectionHold Alt and drag the selection
Add / remove a layer rowCtrl/Cmd + click the row
Select a run of layersShift + click the far row

How far the canvas zooms#

Changed in 1.0.0-alpha.4.6.0: the canvas stopped at 800%, and View > Zoom In and Zoom Out zoomed the whole window - the panels and the toolbar with the drawing - rather than the canvas.

Space and Ctrl before a press#

Changed in 1.0.0-alpha.4.6.0: Space and Ctrl pressed before the press used to make the straight line and the quick curve. Those are now pressed after it, below, and before a press the two keys do what they do in most drawing programs.

The hand: hold Space with any tool and the pointer becomes a hand; a drag pans the canvas, and letting Space go gives the tool back. It works over a Transform box or with the Rotate dialog open, and a Vector Path being placed waits for its next point.

The selection tool: hold Ctrl with a drawing tool - Brush, Marker, Copic, Eraser, Text, Rectangle, Ellipse, Curve, Paint Bucket, Fill Color or the Eyedropper - and it becomes Select or Direct Select, whichever was chosen last, for as long as Ctrl is down. It comes up as soon as the pointer moves or presses, or after a fifth of a second; a chord typed faster than that, such as Ctrl+Z or Ctrl+S, runs with the drawing tool still in hand. A drag begun with the selection tool finishes with it even if Ctrl comes up first. Vector Path and Mesh Warp keep their own Ctrl: the path's anchors, and the mesh's pins.

The Copic nib: hold Ctrl still for the hold time (1 s by default) and the Copic comes up instead, at twice the width, its nib turned by Alt and Shift for as long as Ctrl stays down. Moving the pointer, pressing or typing another key during the hold cancels it, so aiming the selection tool never turns the nib. The hold time, the keys and the switch are in the Verbose Settings window.

Straight line#

Changed in 1.0.0-alpha.4.6.0: Shift locked the line to level or plumb only, and the line's end never snapped.

Straight line: press with a freehand tool - Brush, Marker, Copic or Eraser - then hold Space: the stroke becomes a clean two-point line from where it began to the pointer, and what was drawn freehand before is dropped. The end follows the pointer until the release, and snaps to a stroke's end within the snap sensitivity, a ring marking it, as a freehand stroke's end does - though never back onto the line's own start. Hold Shift during the drag to hold the line to the nearest of eight directions - level, plumb, or a 45° diagonal - with its end where the pointer falls along it, and release Shift to free it again; the lock follows the key live, so you can toggle it as often as you like mid-drag, and it engages without waiting for the pointer to move. Once straight, the line stays straight until the release, whether Space is held or not.

Shift-click line#

New in 1.0.0-alpha.4.6.0.

Shift-click line: click or draw with the Brush, Marker or Copic - that leaves point 1, the end of what you drew - then hold Shift and click: the click is point 2, and a straight line from point 1 to it appears at once. The line is part of the mark you drew, not a mark of its own, so at under 100% opacity nothing darkens where the two meet, and each Shift-click after it adds another line from the last: a polyline, one undo per line. A Shift-press that goes on as a drag draws on freehand from point 2, in the same mark; hold Space during it for a straight line on from point 2, or Ctrl + Space for a quick curve.

Quick curve#

Quick curve: press with a freehand tool, then hold Ctrl + Space - or Space first and Ctrl after - to sweep a quarter ellipse from where the press began: one gesture, no bend step. The arc leaves the point you pressed at flat and arrives at the pointer turning straight up, bowing through the corner of the drag, and it reshapes live as you move; releasing places the far end, which snaps to a stroke's end in reach unless Shift is held. Hold Alt for a quarter circle instead: the shorter side of the drag sets the radius, the same way Shift constrains the Ellipse tool. Alt is read continuously, so pressing or releasing it mid-drag flips the arc between circle and ellipse as often as you like.

Tap Shift to swing the apex 90° clockwise, once per press. The apex is the arc's bowed-out belly, and only it moves: both ends stay exactly where the drag put them, so a curve begun on an existing stroke stays joined to it and its far end stays under the pointer while you choose which way the curve bellies out. Two taps mirror the sweep across its chord — the same arc bowed the other way — and four bring it back around. Holding Shift down does not spin the apex; it parks at one angle. Note that on an Alt quarter circle (or a square drag) the odd stops put the apex on the chord itself, flattening the arc into a straight segment — with both ends pinned, a quarter circle can only bow two ways — so mirroring a circle is two taps, not one.

Esc cancels. The committed stroke is one cubic Bézier — two anchors and two control points, not a chain of dozens — so picking it up with the Vector Path tool shows just those four, ready to rework. For a curve you can bow by hand instead, use the Curve tool (V) below.

Endpoint snap#

Endpoint snap: hold Shift while drawing with the brush, marker, or Copic marker and the stroke snaps to the nearest endpoint of an existing stroke — the start point snaps on pen-down and the end point on pen-up (the Curve tool's chord snaps both ends live). The straight line and the quick curve keep the start the press snapped to, and their end snaps without Shift, because mid-drag Shift is the angle lock for one and the apex key for the other; with a point 1 to draw from, a Shift press is a Shift-click line instead. A small ring shows the endpoint you will snap to whenever one is within the snap sensitivity (a screen-pixel radius, so zooming in gives finer control). The sensitivity (1–20px, default 10px) and the feature's on/off switch live under Quick Features in the Verbose Settings window, alongside Join stroke (off by default): when on, a snapped stroke merges with the stroke it touched (same tool and color) into one continuous stroke.

When something interrupts a press#

A press on the canvas always ends, and ends in one of two ways.

Alt and the menu bar#

On Windows a bare Alt, pressed and let go, hands the keyboard to the menu bar. Drawing uses Alt a great deal, so the menu bar only gets a bare Alt when it was meant for it: when no other key was pressed in the 5 seconds before it, and nothing was done with Alt while it was held - no scroll, no drag, no press. Alt + scroll, Alt + drag, or Alt a moment after other keys leaves the keyboard with the drawing. Alt with a menu's underlined letter (Alt+F for File) still opens that menu at once.

CapsLock cursor#

CapsLock cursor: while any drawing tool is active, CapsLock on shows a precision crosshair; CapsLock off shows a circle preview matching the current stroke width. The eraser shows a dashed circle the size of its footprint, so the area about to be cleared is visible before pressing.