Appearance
Draw Brush
Draws a Shape with natural media — pencils, pens, charcoal, crayon, pastel, marker and spray strokes, a watercolor wash, and hand-drawn hatching.
Category: Render Menu path: Render > Draw Brush
Experimental. Draw Brush is a port of p5.brush by Alejandro Campos Uribe (MIT). The look is close to the original; the parameters and defaults may still change.
Ports
| Port | Type | Direction | Description |
|---|---|---|---|
shape_in | shape | input | The paths to draw. Every path gets a stroke; closed paths can also be filled and hatched. |
field_in | vectorField | input | Flow. An optional vector field that pushes the brush as it draws. When wired (and the Flow setting is above 0), each stroke is carried along the field instead of following its path exactly. Takes any vector field: Noise, Vortex, or the motion in footage from Optical Flow's Vector Field output. |
out | imageRgba16f | output | The drawing. Transparent by default; opaque when Background is Paper. |
Parameters
Stroke
| Param | Type | Default | Description |
|---|---|---|---|
strokeEnabled | boolean | true | Draw a brush stroke along every path. |
brush | enum | HB | Pen, Rotring, 2B, HB, 2H, Colored Pencil, Charcoal, Crayon, Pastel, Marker, Spray. |
strokeColor | color | near-black | Ink color. Its alpha scales the whole stroke. |
weight | scalar | 1.5 | Multiplies the brush's tip size and its scatter, so a heavier weight is a broader, grainier mark rather than just a fatter line. |
splitCorners | boolean | true | Split paths at sharp corners (over ~50°) into separate strokes, each with its own pressure — how a hand draws a rectangle. Off: one continuous stroke per path. |
Watercolor
| Param | Type | Default | Description |
|---|---|---|---|
fillEnabled | boolean | false | Paint closed paths with a watercolor wash. |
fillColor | color | blue | Pigment color. |
fillOpacity | scalar | 0.6 | How much pigment each wash layer lays down (0–1). |
bleed | scalar | 0.1 | How far the wash spreads past the outline (0–1). Keep it under ~0.3 for washes that hold the shape. |
texture | scalar | 0.4 | Blotchy paper texture: erased spots and sparse scatter layers (0–1). |
border | scalar | 0.4 | Strength of the darker, pooled rim (0–1). |
bleedDirection | enum | Out | Out bleeds past the outline; In pulls the wash inside it. |
Hatch
| Param | Type | Default | Description |
|---|---|---|---|
hatchEnabled | boolean | false | Hatch the inside of closed paths. Overlapping paths and holes are respected (even-odd). |
hatchBrush | enum | HB | Brush for the hatch lines (same list as brush). |
hatchColor | color | near-black | Hatch color. |
hatchWeight | scalar | 1 | Brush weight for the hatch lines. |
hatchSpacing | scalar | 8 | Distance between lines, in pixels. |
hatchAngle | scalar | 45 | Line angle in degrees. |
hatchJitter | scalar | 0 | Random endpoint wobble, as a fraction of the spacing (0–1). |
hatchGradient | scalar | 0 | Spacing grows line by line, for a fade-off (0–1). |
hatchContinuous | boolean | false | Join the lines into one zig-zag stroke. |
Variation
| Param | Type | Default | Description |
|---|---|---|---|
seed | scalar | 0 | Picks a different, repeatable set of marks. |
boil | scalar | 0 | Re-draw the marks every N frames — the hand-drawn "boil" of animation drawn frame by frame. 0 keeps the drawing still. Counted from the layer's start, so it boils the same wherever the clip sits. |
flow | scalar | 0.5 | How strongly the field wired into Flow steers the brush, against the pull of the path. 0 follows the path exactly. The field's own strength counts too, so a strong field needs a small value. Ignored when nothing is wired. |
Background
| Param | Type | Default | Description |
|---|---|---|---|
background | enum | Transparent | Transparent: marks over alpha, for compositing like any other draw node. Paper: an opaque sheet where watercolor, hatching and strokes mix as pigment. Blue over yellow makes green, as paint does. |
paperColor | color | warm off-white | The paper, in Paper mode. |
Expose Channels
None yet. Every parameter can be keyframed.
How It Works
A stroke is thousands of tiny, low-opacity dots laid along the path. Each brush has its own tip size, scatter, grain and pressure curve, and a stroke's pressure swells and fades along its length, so no two strokes are alike. Where dots pile up the mark darkens, like graphite burnishing or ink pooling.
The watercolor wash stacks about a hundred slightly different copies of the outline at very low opacity. Each copy has been "grown" outward at random, so the paint pools where the copies agree and feathers where they don't. Random spots are lifted between layers for paper texture. The technique comes from Tyler Hobbs' essay on generative watercolor.
Hatching cuts the closed paths with evenly spaced parallel lines and draws each line as its own brush stroke.
Flow. With a vector field wired into Flow, the brush stops riding its path. At every step it heads where the path points, plus the field's push at the spot the brush is on right now (scaled by the Flow setting), and moves that way. It never snaps back, so a stroke starts on its path and drifts further the longer it runs: lines wander, rectangles stop closing. Where the field is zero the stroke simply carries on in the path's direction from wherever it has got to.
- The push is the field's direction and its strength. Noise and Vortex push at strengths up to about 1, so at the default 0.5 the path still leads and the field bends it. Optical Flow measures motion in pixels per frame, so footage moving 10 px a frame pushes ten times harder: start around 0.05, or put a Field Remap in between to bring its speeds into a 0–1 range.
- Only the Stroke is steered. Hatch lines and the watercolor wash stay where they are.
- A flowing stroke can travel anywhere, so while a field is wired Draw Brush stops at the edge of the frame: marks carried past it are not kept.
Per-path attributes work the way they do in Draw Shape, so shapes colored upstream (Shape Attributes, or Clone to Points copying each point's color and opacity) keep their colors:
| Attribute | Effect |
|---|---|
color | Replaces Fill Color for that path's wash, and the stroke and hatch colors too unless the path has its own strokeColor. |
strokeColor | Replaces the stroke and hatch color for that path. |
opacity | Multiplies the path's wash, stroke and hatch opacity. |
strokeWidth | Multiplies the stroke and hatch Weight for that path. |
Hatching is linework, so it follows the stroke color. Shapes with the same hatch color and width are hatched together, so continuous hatch lines still run across them.
Everything is drawn on the CPU from a seed, so the same settings give exactly the same drawing on every frame, at every quality, and in exports.
Usage Examples
Basic: a sketched rectangle
Rectangle → Draw Brush → Output. Pick Charcoal, set Weight to 2. The four sides are drawn as four overlapping strokes.
Watercolor illustration
Turn on Watercolor and set Background to Paper. Draw the outline with Pen in a dark color, and add Hatch with a 2B brush at 30° for shading. Overlapping washes in different colors mix like real pigment.
Animated: boiling line art
Text → Text To Shape → Draw Brush with Boil at 3. The lettering redraws itself every three frames, like hand-drawn animation.
Particles in many colors
Point Emitter → Point Solver → Point Attributes (Color from a ramp) → Clone to Points with a Circle → Draw Brush with Watercolor on. Each circle is washed in its own particle's color, and Point Attributes' Opacity fades each wash.
Creative: wind-blown strokes
Wire Noise's vectorField into Flow, then use Point Scatter → Connect Points (or any shape) as the input. Raise Flow until the strokes drift with the field.
Strokes pushed by the motion in footage
VideoSource → OpticalFlow (Vector Field) → DrawBrush (Flow)
your shapes ───→ DrawBrush (Shape)Wire Optical Flow's Vector Field output (not its Flow image output) into Draw Brush's Flow. Strokes bend the way the picture is moving, harder where it moves faster, and hold their path where it is still. Set Flow to about 0.05 to start. The drawing is redone on every frame as the motion changes, and the layer's first frame has no motion to read, so its strokes sit on their paths.
Tips
- The fine brushes (Pen, Rotring, 2H, HB) are faint at Weight 1. They are meant to build up, so try Weight 2–4, or draw the same shape twice.
- Bleed is heavy-tailed: above ~0.5, single wisps can travel far past the shape. Draw Brush caps how far they reach so they never clip at the canvas edge.
- Draw Brush renders on the CPU, painting separate watercolor washes on all cores at once. A large wash still costs a few hundred milliseconds per redraw, so many big washes that change every frame (growing particles, for example) won't play in real time. A still drawing (Boil 0) is cached and costs nothing on later frames.
- Paper mode is opaque. Use it as a background layer, or keep Transparent and composite over a paper texture instead.
Related Nodes
- DrawShape — clean vector fill and stroke
- TextToShape — turn type into paths to draw
- Noise — a vector field for Flow
- OpticalFlow — the motion in footage as a vector field for Flow
- Remap — bring a strong field's speeds into range before Flow
- ShapeDeform — wobble the paths themselves before drawing