Overview
HanSketch is a WebGL-based canvas for creating physics-driven paths, circles, particles, and extracted-shape bindings. Draw forms, tune the motion, then export to SVG, JPG, TIFF, PDF, or animation.
Interface
- Tool rail (left) – actions: Pen, Circle, Rectangle, Triangle, Particles, attractor/repulsor, and the editing tools.
- Canvas stage (center) – the artboard scales to the available viewport while preserving its internal pixel dimensions.
- Physics dials (bottom) – visible Form and Motion controls, with Blob Size, Spacing, and Bounce in Advanced.
- Inspector (right) – the current selection, colour, size and smoothing, palettes, layers, relief shadow, topology, and Shape + Motion Binding Studio.
Draw Tools
- Pen – click-drag to draw. Release near the starting point and HanSketch closes the stroke into a blob; release elsewhere and it remains an open curve. The endpoint detection is intentionally forgiving and scales with the canvas. Strokes are smoothed when you lift the pen; set how much under Smoothing in Shape Settings.
- Circle – draw a repulsion circle. Drag sets radius; blobs avoid inside. Wrap blobs around circles to create controlled shapes.
- Rectangle – drag to size a rectangle. Corners are pinned so the shape holds its geometry while its edges still breathe, and they are drawn as real, sharp corners.
- Triangle – drag to size an isosceles triangle, apex centred on the top edge. Corners are pinned and sharp, as with the rectangle.
The active tool is marked with an accent rim.
Edit Tools
- Select (V) – click a form to select it. Hold Shift while clicking to add or remove forms, or use Cmd/Ctrl+A to select all visible, unlocked forms. Drag the selection to move; drag a corner to scale from the opposite corner (hold Alt to scale from the centre); drag the round handle to rotate (hold Shift for 15° steps). Arrow keys nudge. The Selection panel in the inspector duplicates, deletes, and moves the selected forms forward or back within their own layers. Each group transform, duplicate or delete is one undo step. A scaled form keeps its new size; the physics treats it as the form's natural shape. Corners: as with Illustrator's Curvature tool, double-click a point on an outline to make it a sharp corner, and double-click it again to make it smooth (the point under the cursor is ringed). Every corner keeps a small diamond marker on the canvas, so it can always be found again; Pin, Drag and this double-click snap to a corner when you click near its diamond. The Pen always draws smooth; corners are added afterwards. A corner stays sharp while the form moves, and Push or Drag can pull it into a point. Markers are hidden in Presentation Mode and never exported.
- Drag – pull a single point of a form; the rest follows through the physics. Also moves circles and other geometry.
- Push (P) – a liquify brush: drag across an edge to push it in or out, strongest at the centre of the circle. [ and ] change the brush size. The pushed outline becomes the form's remembered shape.
- Freeze – lock physics in a shape (dashed rendering). Click inside a closed form, or on an open path.
- Slice – click a chain segment to split the shape.
- Pin – fix single points in place (red target ring). Click red target ring to release point.
- Recolor – give an existing form the current colour. Pick a colour or a palette swatch in Shape Settings, then click the shape. Works on imported shapes too, and undo restores the previous colour.
- Delete – click a line, particle, blob or guide to erase it, or drag a lasso around several. Locked and hidden layers are left alone.
Only one edit mode may be active at a time. Undo (⎌ or Cmd/Ctrl+Z) reverses deletes, moves, scaling, pushes, imports and chance drops as well as new shapes.
Shape Settings
- Color – sets stroke/fill color.
- Size – sets the base radius used for new paths and particles.
- Smoothing – how much hand tremor is taken out of a Pen stroke when you lift the pen. 0% keeps every wobble; the stroke's point density is unchanged either way.
- Palette – load a
hansketch.colorexport and click a swatch to use it.
Preset Library
Open Presets from the title bar to add a starting study to the active layer. Search by name or description, then filter by category. Built-ins include circle/blob grids, Blob Face, Organic Garden, Gesture Ribbons, Hollow Seed, and Orbit Field. The procedural studies fit the current canvas and use the active palette when one is loaded. The Organic and Geometric categories come from the shape library — JSON outlines shipped alongside the app — and are fitted to the canvas without changing your physics dials.
Save current stores the current chains and circles in this browser only. Saved cards can be deleted individually with × or all at once with Clear saved. Applying a saved preset aspect-fits it to the current canvas and resets its velocities; it does not alter the source scene or upload anything.
Physics Dials
Material (Inflation, Stiffness, Shape Memory) and Motion (Chaos, Speed) sit on the bar. Advanced folds away and holds Blob Size, Spacing and Bounce — the three you usually set once and leave. Bounce is the material’s springiness, not its rate: Speed changes how fast the same motion plays, Bounce changes whether a form settles or keeps trembling.
| Slider | Description |
|---|---|
| Blob Size | Changes vertex size, point spacing, and spring rest length, so existing forms can re-shape. |
| Bounce | Controls how much motion carries over from frame to frame. High keeps forms trembling; low lets them settle. |
| Inflation | Internal pressure that pushes closed forms outward; open paths are unaffected. |
| Stiffness | Spring strength that pulls vertices back toward their rest spacing. |
| Spacing | Repulsion strength that keeps points and forms from overlapping. |
| Chaos | An ambient noise field that pushes every vertex around, with a gentle pull back toward the centre. 0 is off. |
| Speed | How fast the simulation plays. 50% is real time; forms behave the same at any speed. |
Canvas Controls
- Appearance (🎨) – choose outline, fill, background, and stroke settings.
- Spacing – choose no, normal, or high repulsion between forms.
- Undo (⎌) – reverses the last edit (Cmd/Ctrl+Z).
- Topology – enable Self-intersection → hole for nested inner rings.
- Edit → Reset Settings – restores physics, drawing and appearance defaults while keeping artwork, layers, palette and paper size. Undo restores the previous settings.
- Clear Canvas (🗑️) – clears the scene after confirmation.
- Shape + Motion – open Binding Studio to map an extracted shape to a continuous motion clip.
Keyboard
- Q Pen · E Circle · T Rectangle · Y Triangle · R Particles
- V Select · A Drag · P Push · S Freeze · D Pin · C Recolor · Z Slice · X Delete
- Cmd/Ctrl+Z Undo · Cmd/Ctrl+A Select all visible, unlocked forms · Shift-click add/remove a form
- With a selection: Cmd/Ctrl+D duplicate · Backspace delete · arrows nudge (Shift ×10) · Esc deselect
- Push brush: [ smaller · ] larger
- Mouse‑Wheel over canvas / slider – adjust Blob Size smoothly.
- Space – physics on / off. A badge on the canvas shows when it is off (click it to resume); no dial moves. If every visible layer is set to stay still (◇ — for example a placed artwork), the badge offers to let them move.
File & Export
File Menu
- Autosave – the sketch and all its settings (background colour included) are kept in this browser and reopened on your next visit. It is a safety net, not a file: use Save to keep or share a sketch.
- New Sketch – clears the autosaved sketch and starts again with default settings.
- Save Blobs – saves shapes + settings (including layers) to JSON.
- Load Blobs – import shapes + settings from JSON.
- Import SVG – open an Illustrator SVG. Top-level groups become layers, per-shape fill colours are kept, and hidden groups arrive hidden. Imported layers start with physics off so the artwork matches the source file; switch a layer's physics on when you want it to move. You can also drop an SVG straight onto the canvas.
- Digitise an Artwork… – opens Shape Extractor in Composition mode. Its Open in HanSketch button sends the digitised artwork back here without a file; a dialog with a preview then asks how to place it (a new sketch in the artwork's proportions or added to this one, the artwork's ground as background, flat colour, Relief Shadow, physics). Each plane becomes a layer. A composition SVG imported or dropped here opens the same dialog.
Paper size
New sketches start at A3 portrait (297 × 420 mm), 300 dpi: TIFF and JPG exports are 3508 × 4961 pixels. In Appearance → Canvas Size, choose A3 or A2 in either orientation, or enter a custom size. A2 portrait (420 × 594 mm) exports at 4961 × 7016 pixels at 300 dpi. The live canvas uses a smaller working resolution; export size and paper proportions are preserved. Existing saved sketches keep their own size.
Export Menu
- SVG – editable vector groups for every layer; hidden layers retain their hidden state.
- JPG – full-colour raster at the chosen paper size and DPI. Pixel-native sketches keep the existing 2000-pixel long-edge export.
- TIFF – lossless, uncompressed 8-bit RGB, with the chosen DPI stored in the file. A3 and A2 at 300 dpi work without reducing the paper size.
- PDF · artwork – one page at the exact paper size. Contours, holes, outlines and particles remain vector; soft relief shadows use lossless images at the chosen print resolution.
- PDF · all layers for screen printing – one named, black-on-white vector page per layer, bottom first, including hidden and locked layers. Every page has the same paper size and alignment; background colour and relief shadows are omitted. The current fill/outline style is kept. Arrange one printing ink per layer when preparing separations; this exports layers, not automatic colour separations or halftones. Print at 100% / Actual Size.
- Background Color – artwork exports use the canvas background when on, or white when off (SVG omits its backdrop).
- JPG, TIFF and artwork PDF include visible layers only. SVG and the screen-print PDF retain every layer.
Exported SVGs write one group per layer, named the way Illustrator names its own, so opening the file in Illustrator reconstructs the layers.
Layers
- New shapes are drawn onto the highlighted layer. Click a layer to make it active.
- Double-click a layer name to rename it. Names carry through to SVG export.
- ◉ / ○ – show or hide the layer. Hidden layers cannot be picked.
- 🔓 / 🔒 – lock the layer. Locked shapes cannot be dragged, pinned, frozen, sliced or deleted.
- ◈ / ◇ – per-layer physics. Switch it off to hold a layer perfectly still while the rest of the canvas keeps moving — useful for crisp geometric shapes.
- ▲ – move the layer up one step. The top of the list draws last.
Relief Shadow
Tick Layers cast shadows in the inspector and every layer casts one soft shadow onto the layers below it, like the cut planes of a painted wood relief. Forms on the same layer are one plane, so their shadows merge rather than darken where they overlap. Distance, Angle, Softness, Spread, Opacity and Colour update live and are saved with the sketch. Put forms on separate layers to lift them off one another. Particles cast no shadow. Load a palette from Color Extractor in Shape Settings, then choose one of its swatches under Relief Shadow → Colour. The colour picker and palette stay in sync; Opacity controls how it blends with the paper.
Laws of Chance
After Arp's collages arranged "according to the laws of chance" (1916–17), for which he let torn paper fall onto a sheet and glued it where it landed. Open Chance in the title bar, choose how many pieces, which forms (torn paper squares, the organic library forms, or both) and their size, then Drop. The pieces fall one after another onto a new layer, at random positions, turns and sizes, in your palette's colours (or a default set). The layer's physics is off unless you tick Let them settle, so the pieces stay where chance put them. Drop again takes the last drop back and rolls again; Undo removes a drop in one step.
System Requirements
Hardware
- Desktop / Laptop (recommended) – any CPU from 2013‑onward with an integrated or discrete GPU that supports OpenGL 2.1 / WebGL 1.0.
- iPad – Supported with the touch-friendly overlay layout; iPhone is not supported.
Software
- Browsers – Chrome 49+, Firefox 44+, Edge 79+, Safari 11+ with WebGL enabled.
- OS – Windows 7+, macOS 10.11+, Linux distros with Mesa 11+ drivers.
Performance Tips
- Lower Blob Size or Speed on older integrated GPUs.
- Press Space to switch physics off when previewing static artwork.
- Laptop users: disable high‑DPI rendering by setting browser zoom to 100 % for extra FPS.
Troubleshooting
- No drawing? Ensure WebGL is enabled in your browser.
- Red glow won’t go away? Click the active Edit‑Tool icon again to exit edit mode.
- Slow performance? Lower Blob Size or Speed, or press Space to switch physics off for a moment.
- Mobile warning? App requires a desktop browser.