What the painters were given

The painter's sketchbook

notes/sketchbook.md · 744 lines · Studio notes

Given to 1 painter:

The painter's sketchbook

Read this before you paint at the easel (crates/easel/README.md). It holds craft (techniques with the numbers that worked, and the mistakes that cost painters the most time), never finished pictures to copy. Credits in brackets: [r2 winter] is round 2 (Rust, older API, notes/amnesia2/, only its lessons that translate to the easel), [r3 ...] round 3 (notes/amnesia3/), [r4 ...] round 4 with the drawing tools (easel4_green, easel4_near). Add what you learn in the same form: what to do, the recipe, what goes wrong.

These are the best techniques so far, not the best possible. Every recipe is a floor to beat. Each section names its ceiling: where the best recipe still reads as schematic or digital. If a passage of yours still reads digital, don't settle for the recipe: try something new, and if the critic scores it better, replace the entry (don't keep both). Pitfalls stay: they only prevent bad results.

Hierarchical detail, not maximal subtraction (Alice, Round 6). Economy doesn't mean less detail everywhere; it means detail placed where the eye goes and massed where it doesn't. Big shapes and value families first, then a middle scale of irregular groups, then a few selected particulars. The Round 6 lab (notes/lab/, notes/round6.md) found both failures: too little (foliage as blobs or domes, a bare tree's twigs as a tone that read as fur) lost to the old detailed recipes, and too much (an even carpet of 40,000 touches, a starburst at every twig tip) read as procedural noise. What won kept the middle scale: bare tree C (fewer, varied, tapered twigs, all connected), water B, sky B, rock B.


1. Working order and time

2. Skies and air

Ceiling: skies read as smooth, even gradients ("too neat") and impasto cumulus reads lumpy; nobody has yet painted a Friedrich sky with real structure (banks, breaks, an uneven glow) that also reads as paint.

3. Water

4. Distance and ranges

Ceiling: ranges still read as parallel bands or boxy crests; far woods as hedges of repeated round blobs.

5. Trees

Ceiling: oaks come out as umbrella/savanna crowns or "broccoli"; spruce tiers as regular chevrons; field trees as identical balls; wood interiors as flat black masses. No painter has yet drawn a tree with its structure, only built one from parameters.

Broadleaves from a drawing: tree_in{} and tree_group{} (THE TOOL TO USE for oak, beech, lime, birch and willow; use it before tree{}/t:foliage{} or a hand-built crown). Draw the crown as an outline{}, lopsided and lobed (a symmetric blob grows a lollipop), and the trunk from the foot up. Then t = tree_in{crown=o, trunk={{x,foot},...}, species="oak"|"beech"|"lime"|"birch"|"willow", season="summer"|"spring"|"autumn"|"late_autumn"|"winter", sun=WORLD, seed=} grows the limbs from the trunk into your crown, with the crown's own gaps, leaf clumps on the twigs and hooked touches on the clumps [trees_in study, paintings/lua/trees_in.lua]. Paint it in this order:

  1. Wood: work(t:wood(3.5), {hand="body", tool="round 2", ...}). Put the lit flank only on t:wood(7), since a flank on thin limbs turns them into pale lines. Then t:paint_wood(brush("round", 2.4), {min=1.2, max=3.5}) and brush("rigger", 0.9), {max=1.2}.
  2. The leaves' body: work(t:leaves(), {hand="hatch", tool="round 1.6", hug=false, clip=...}), colored from L = t:light(): mix(mix("#222b1d", "#35412a", smoothstep(0.1, 0.45, v)), "#5c6a3a", smoothstep(0.5, 0.85, v)). A single body color gives one dark blob.
  3. Sky into t:gaps() before the touches, or the holes keep hard cut-out edges.
  4. Touches, b = brush("round", t.touch_w): lit={0, 0.4} #263020; lit={0.15, 0.4}, depth={0.25, 1}, share=0.5 in a cool #4a5446 (the front shade masses catch the sky); lit={0.4, 0.6} #46522e; lit={0.6, 0.78} #6f7c45; lit={0.78, 1} #98a060, every=6.

A bare tree: the same crown, trunk and seed with season="winter" grow the same wood (even moved across the canvas). Principle: draw the structure, select the twigs, leave the sky. A painter draws the big limbs whole and a few twigs with character, and leaves the rest out. tree_in does the picking: detail= (default 0.35 bare) is the share of the fine wood drawn, always with the wood it leaves from. An oak's wood is angular (straight runs, elbows at the nodes, short stiff twigs; angular, on by default for oaks) [bare_trees study, paintings/lua/bare_trees.lua, notes/oak.md]. Paint the wood thick to thin, each band with a brush that can lay its widths: t:wood(3.5) as body paint (lit flank on t:wood(7)), then t:paint_wood(brush("round", 2.4), {min=1.2, max=3.5}), then t:paint_wood(brush("rigger", 0.9), {min=0.5, max=1.2, every=2}) and t:paint_wood(brush("rigger", 0.55), {max=0.5, pressure=0.04, every=2}), the fine wood a shade lighter than the limbs. The bands are local widths, so nothing floats. A single rigger 0.55 for everything under 1.2 paints it all one width (it lays 0.21 to 0.71): no taper at the forks. Don't lay a tone for the undrawn twigs (t:twig_mass()): a blind panel of four critics called it "steel wool", "fur" and "gray scribble cushions" and preferred the drawn twigs, and toned trees look heavier and smeared. Paint only share=0.4 of the dead leaves an oak keeps, or they read as burrs. Ceiling: at 1000 px the drawn twigs are sub-pixel hairlines and read as faint lines; the oak's crown is still a model's (limbs cross each other more than a real crown's do), and a few sibling limbs run side by side like doubled lines. Field trees: draw 2–3 different crowns (a broad low one, a tall narrow one) with short trunks, then tree_group{crowns=, trunks=, species={...}, count=6, horizon=HZ, spread=0.8}. Paint far to near with t.haze, and lay one g:shadow():blur(1.5) glaze at 0.25. Don't roughen the shadow: it breaks into speckles. Still weak [trees_in study]: sky holes have crisp torn-paper edges at 3200; a beech's leader reads as a gray pole through its crown; a birch's white stem runs high into the crown.

Firs from a drawing: fir{} and fir_wood{} (use these before hand-building a spruce). Draw the silhouette as an outline{} (apex, flanks, the crown's base) and fir{envelope=o, foot={x, y}, habit="spire"|"old"|"young"|"storm", seed=} grows a spruce into it: uneven whorls, gaps in runs, dead and broken lower boughs, tips on your line. Paint it in this order [firs study, paintings/lua/firs.lua]:

  1. work(f:needles(), {hand="hatch", tool="round 1.8", length={3, 7}, coverage=2.4, clip=f:needles(), angle=...}), dark #1c2621→#25302a down the tree. Use a continuous angle, 1.57 + 0.5*clamp((ax - x)/12, -1, 1). An angle that flips at the stem leaves a pale seam down the tree at 3200.
  2. Boughs with a rigger 1.2 (f.boughs, dead ones #6a655d) and f:paint(brush("rigger", 0.6), {color="#77716a", kind="twig"}). Stroke the stem only below f.crown_base - f.tier; a full-length stem stroke reads as a pale line.
  3. f:paint(brush("round", f.hatch), {color="#18211d", lit={0, 0.5}}), then #34402f for lit={0.5, 0.7}, then #667052 with a brush 0.8x for lit={0.7, 1}, every=6. These are the short hatched strokes, hung from each bough, lit by the sun you passed (sun=).

Draw each envelope yourself: lopsided, a torn flank, a notch for a lost top. A symmetric envelope still gives a Christmas tree. old at 400 units reads as curtain branches hanging off a crooked stem, young as a dense cone to the snow.

A wood: wood = fir_wood{skyline=outline{pts=TOP, open=true, char="soft", lobe=14}, foot=516, depth=4, count=13}. Paint rows far to near. Row r's needles are mix(dark, air, 0.62*wood:haze(r)) with air a shade darker than the low sky (#a4a7a1); 0.95 went milky. Paint trunks with a rigger (wood:trees(r), f.leader.pts) and the hatched strokes (wood:paint(b, r, {...})) on rows 1–2 only. Between rows 3 and 2, lay the floor: wood:floor():roughen(7, 22, seed, 3) in #2a302d→#555c5a down to the foot, hug=false. Use wood:haze(r), not wood.rows[r].haze, inside color functions: wood.rows builds every tree (14 s).

Spruces by hand (the older recipe; tree{habit="spruce"} gives a forest spruce with a bare trunk). tree{habit="spruce"} is a tall forest tree; years=14 gave a lollipop [r4 near]. What worked is a spruce hand of your own: an axis, then per tier a left and a right branch that droops and lifts at the tip, longer toward the foot, plus a shorter foreshortened branch toward you about 70% of the time. The numbers from [r4 near] chunk 7:

Place wood-edge spruces with uneven(), tips on a drawn line, heights varied and overlapping, over one dark interior mass. Even spacing reads as a row of Christmas trees and an even crest as a clipped hedge. A transparent gray-green glaze over the interior tones sky holes that read as bright paper at 3200 [r3 near]. Still weak: spires from one function share a shape, and tiers come out as symmetric chevrons [r4 near]. Vary halfw, droop and lean per tree.

Oaks and broadleaves.

6. Rocks and stones

Ceiling: stones read as loaves, eggs or stacked masonry; snow on stone reads as blotches or lichen.

Rocks from a drawing: rock{} (use this before building a rock from ellipsoids and cuts). Draw the silhouette as outline{pts=..., char="broken"} ("firm" for a sure contour). Mark corners with "c". Draw the main cracks as point lists. Then r = rock{outline=o, cracks={...}, kind="granite"|"sandstone"|"chalk", sun=..., seed=}. It infers the planes, lights them and gives masks and fields [rocks_in study, paintings/lua/rocks_in.lua, paint_rock in chunk 2]:

  1. Take the color from r:value() through a five-stop gradient anchored on r:levels(0.03, 0.97). Mix in P.bounce by r:reflected() and P.core by r:core().
  2. Lay the whole mass (filbert 4, coverage 3.2, medium 0.25) and then r:lit(0.2) stiffer (medium 0.12). Both go angle=r:field("plane"), so the strokes change direction at every plane break.
  3. blend(r:shadow(0.3), ...) only. Blending the whole rock gave back the pale smooth loaf.
  4. Stroke every line in r.seams once with a round brush (pressure={0.8, 0.2}, clip=r:mask()). Short detail strokes over r:cracks() came out as dotted lines, and the sandstone read as a crate.
  5. Glaze r:cast() (0.3 coats) and r:contact() (0.35), each times a mask of your panel or ground, because the cast shadow reaches far under a low sun.

What decided the look:

7. Snow

Ceiling: snow fields are flat and empty; lit snow under a low sun came out lilac until overruled by hand.

8. Grass and foreground particulars

Ceiling: foregrounds are the dullest passages in every round (a barcode of upright dashes, a smooth band with sparse incident); Friedrich's are dark but drawn, every tuft particular.

The foreground is where every round fell shortest of Friedrich. Budget real time for it.

9. Figures

Ceiling: figures are stiff, symmetric silhouettes, sometimes cut-out looking at 3200.

10. Drawing

11. Masks

Edges: found, soft and lost [r7 edges]

Decide every edge; vary it along one contour. A stencil (clip=true) makes the edge no brush makes: one crisp, even line the length of a ridge, the same for every stroke. That is what Alice and both critics called "a filled selection" in Evening at a Mountain Lake (measured: the ridge's edge 0.38 units wide all along, 100% crisp, contrast varying 3%, wandering 0.1 unit off a perfect curve; notes/edges.md). A painter makes an edge found where a form turns against the light (the peak against the glow, a figure's lit shoulder), soft along most of a contour and lost where a shape runs into its neighbor at a close value (a ridge running down into haze, a reflection's lower edge in the water).

Goes wrong: lose into wet paint with its default lean brush lifts the wet film and shows what is under it (pale "teeth" along a ridge in the lab); lose over dry paint, or load more. On a ridge that edge= already carried outward, lose works along the mask's line, now inside the dark, and leaves gray patches there: use it on edges a pass stencilled or held found. Large overruns only move the edge out as a staircase of opaque stroke ends; the fence keeps them short on purpose.

Ceiling: the lab ridge (notes/edges/alice_edges.png) is brushed and varied but still reads mostly crisp over dry sky (86% of its length found at 3200, from 100%): a truly soft dark-on-light edge over dry paint needs a blend of the two in the wet or a scumble, which lose does only roughly. Not yet tried on firs, the figure or grass, or on the wet engine (r7-paint-wet).

12. Color

13. Pitfalls that cost the most time

Pitfall Fix
Paint laid over paint that's still open (translucent rock, fog band, plowed river) dry() first, or check drying(x, y) [r3 near, r4 near, r4 green]
A later pass paints over an earlier motif Depth layers and behind=, or subtract the motif (grown) from every later mask; crop the motif after every big pass [r3 free]
clip=<mask> taken for a softer fence (it clips hard to the region itself) clip=true or edge= [r7 edges]
rect() fades and ring masks leave ruled edges and outlines smoothstep fades in mask(fn), hug=false, v:contact_shadow [r4 near, r3 near]
Fixing an early chunk by hand-editing the log (close, sed, 30 to 100 s replay; close once overwrote the edit) easel edit N -f, edit N --insert, edit N --drop in the live session [r3 green, r3 free]
Probe chunks cluttering the log easel try [r3 free]
Body radii mistaken for full sizes size and s:size are radii [r4 near, r3 green]
eye= is absolute, not above the ground: the camera sat inside a knoll Make the ground about 0 at the camera [r3 free]
Judging detail at 1000 px (figure ruined under a veil, grain in a stipple) look --crop ... --scale 3.2 on the motif after each pass that touches it [r3 free]
A generator's defaults (sward, spruce, oak crown) taken as the answer Treat each as a first try: thin, cull, vary, restate by hand
A chunk that silently painted nothing Print an area or count at the end of each chunk (print(m:area()), blade counts) [r3 green]
The live 3200 crop timing out under load Retry later, or easel run --crop in the background [r4 near]
Scratch study sessions write paintings/lua/<name>.lua Move study logs to your scratch dir afterward [r3 green]

14. Habits of looking

Source