# riso-film

Adopt this skill: https://proskills.md/skills/other/sevenevesai-riso-windowseat-claude-skills-riso-film

Page: https://proskills.md/skills/other/sevenevesai-riso-windowseat-claude-skills-riso-film
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .claude/skills/riso-film/SKILL.md
size: 7583
sha: ddf135e0aebc9f760a46dec17266d8a3cb318872
upstream: https://github.com/sevenevesai/riso-windowseat/blob/main/.claude/skills/riso-film/SKILL.md

````text
---
name: riso-film
description: Design, build or improve procedural risograph animations and videos in this repo, including narrative films, abstract shorts, motion effects and visual inspection. Delivers self-contained Canvas 2D HTML and a verified MP4. For standalone still art use riso-still; for sound use riso-score. Not for editing tools/.
---

# Riso film

Deliver `films/<name>/index.html` plus a verified MP4 in `out/`. Every pixel is drawn in Canvas
2D; the deliverable has no libraries, fonts, images or network calls. External subject references
may be studied, never embedded. Paths are relative to the repo root; commands run in `tools/`.
Reference exclusions in the user's request take precedence.

## 1. Direction

Read `.claude/rules/riso-plates.md`, `docs/brief.md` and `docs/visual-development.md` first.
Add `docs/drawing.md` and `docs/motion.md` for what is being built, `docs/characters.md` for
people, animals or hands, `docs/scene-space.md` for complex objects, framing, perspective or
precise speed changes, and `docs/quality-bar.md` for print finish and playback defects. Load
`docs/sound.md` only when scoring. [examples.md](examples.md) maps techniques to the shipped
films; open the matching source before inventing a routine that already exists.

Extract subject, feeling, scope and constraints. For an open aesthetic brief, choose a direction
and proceed; if the user asks for proposals, propose first. Write `FILM.md` early: design
decisions, observed references, shot/action plan, user constraints, remaining work.

Plan actions and consequences, not illustrated nouns. Per substantial shot: camera and shot size,
what changes, a readable arrival/hold, and where the eye goes at the next cut. Keep subject
motion, camera motion, transition and atmosphere distinct. `docs/forms/resonance.md` is an
optional call-and-response form (used by `films/lumen` and `films/emergence`); use it only when
asked or deliberately chosen. A single journey through one fixed frame (`films/window-seat`) or
one continuous take of one event (`films/roost`, `films/nonpareil`, `films/eclosion`,
`films/passenger`, `films/standby`) is an equally valid alternative to a montage. Preserve approved direction in revisions.

## 2. Prove the hard part first

Before filling a timeline, inspect real subject references and build one representative hard
frame. For complex art, compare small viewpoint/value thumbnails first. When the request remakes
a known video, measure the file itself (cuts, shots, actions) before choosing what to keep.
Figures get debug views and photo comparisons before shots: likeness judged at recognition scale,
a posable 3D hand per grip, 3D-solved arms (`docs/characters.md`). A subject that recurs at
several sizes goes on one sheet at its smallest and largest size first. Fix generic silhouettes
and inconsistent perspective before adding grain, hatching or more scenes.

Then build a short sample of the hardest action: the subject doing something, not just arriving.
Check attachments, mass, timing and aftermath. Encode that sample as soon as it exists
(`render.mjs --from a --to b`) and read its fastest frame at 1:1: strobing, mushy dots and bitrate
only show in the MP4. For a long film, make a full-duration silent rough cut before polishing.
Set holds and cut lengths from information and action, not equal slots or an
inherited timeline. These are working checks, not extra approval steps.

## 3. Build from a clean engine

```
node new-riso.mjs --kind film --duration 60 --out ../films/<name>/index.html
```

Choose the real duration. The generator refuses to overwrite and copies only the print, drawing
and motion kits plus `tools/lib/visual-kit.mjs`; it gives a blank `drawArt(t)`, a player and the
`__riso` contract. Edit the generated HTML directly. Copy routines from donors
(`prints/workings`, `studies/index.html`, the films in examples.md), never their scenes. When most
of the frame moves with tone (parallax, smears, moving gradients), copy the live-plate compositor
from `films/window-seat/index.html` (see `docs/live-plates.md`).

- Bake static scenes at displayed size. Screen moving geometry in page space. Reproject vectors
  for camera moves; never resize a screened bitmap.
- Share geometry between marks and their knockouts, and one clock between actions coupled
  across shots.
- Build in small batches; inspect each scene at its real duration and its render cost. Live
  plates run 100–200 ms/frame; profile per draw function before optimising
  (`docs/live-plates.md`, cost). The generated player buffers slow films, so share MP4s for
  judging pace.
- Keep `__riso.shots = [{id,start,end,readAt,action,transition}]` derived from the one
  authoritative timeline; `readAt` is a representative visible moment. No second set of timing
  constants.

## 4. Review picture and motion

```
node review.mjs ../films/<name>/index.html
node verify.mjs ../films/<name>/index.html
node shoot.mjs ../films/<name>/index.html --range 6.6:6.9:0.0333333333 --sheet --engine firefox
```

Use this film's event times. Read every sheet you generate. `verify.mjs` proves seek purity in
both browsers across the actual duration and shot boundaries; it proves repeatability, not beauty
or stable adjacent-frame texture, and a sheet cannot judge pacing or choppiness at speed. When it
fails, its `DIAGNOSIS` line names the per-seek state or the earlier frame that poisons the time.
Measure the playback defects in `docs/quality-bar.md` (flicker, jitter, pops, held stretches) and
watch a silent range render; `docs/motion.md` lists the traps that pass verify.

Inspect frame-spaced strips around handoffs, contacts, mask completions and visible wraps, on both
sides of each reset. For a retimable effect check 0.5x, 1x and 2x and move coupled clocks and holds
together. Settle texture questions on native PNGs or 1:1 crops; reduced sheets invent moiré and
hide small subjects. `docs/quality-bar.md` separates art, construction, print, action, pacing and
delivery evidence.

## 5. Export and finish

```
node render.mjs ../films/<name>/index.html --from 0 --to 6 --engine firefox --out ../out/section.mp4
node render.mjs ../films/<name>/index.html --fps 30 --size 1080 --engine firefox
node review.mjs ../films/<name>/index.html --mp4 ../out/<name>.mp4
```

Range renders are silent; render the whole film after picture review. `review.mjs --mp4` lists
every held stretch with its shot; confirm each is an intended hold (`--from` for a range render).
Score with `riso-score` first when sound is wanted. Decode the final MP4 and check duration,
dimensions, frame count and audio; inspect encoded motion too. Record evidence, remaining
weaknesses and anything not reviewed in `FILM.md`. Technical validity is not the user's artistic
approval.

For revisions, read `FILM.md` and edit the authoritative HTML; never rerun an old assembly script
over revised art. Keep the previous render for comparison and preserve approved pacing and score
during local fixes. Cut secondary detail before compromising the hard frame, the full progression
or verification.

When handing a revision to a fresh session, write a self-contained prompt: the film path; read
`FILM.md` first and treat `index.html` as authoritative; the user's words quoted; what is approved
and must not change, by time range; copy the delivered MP4 and WAV to `-v1` before editing; each
suspected cause labelled unconfirmed with the check that would confirm it; and how to read the
file safely (sampled films carry multi-MB lines). Keep it in the film folder (`HANDOVER.md`).
````

## File: .claude/skills/riso-film/examples.md
size: 18559
sha: f32cbfecca91bc2ff921ca463ce760b85f58b3ab
upstream: https://github.com/sevenevesai/riso-windowseat/blob/main/.claude/skills/riso-film/examples.md

```text
# Worked examples: where to look

Every shipped work is one `index.html` with the whole engine inline. These tables point at
named functions and constants; search for the name (`grep -n "function compose"`,
`grep -n "const VK"`) rather than trusting line numbers. Each film's `FILM.md` explains why
the design went the way it did; read it before borrowing from that film.

The common engine is in every file under the same names: `rngFor`, `buildScreen`/`screenOf`
(halftone screens), `bakePaper`, `bakeScene`, `print`/`plane`/`shade`/`carve`/`hatch`/`spray`
(plate marks), `nib` (tapered stroke), `makeWob`/`wobbler` (seamless wobble).

## films/window-seat — fixed-frame journey, 78 s

One window, a world that travels past it, and every content switch hidden under full cover.
Its own plate compositor lets live elements be drawn per frame without baked scenes.

| Technique | Where | Why copy it |
|---|---|---|
| Analytic speed profile | `VK`, `VSEG`, `S`, `accel`, `speed`, `invS` | Distance is a closed-form integral of smoothstep speed keys, so every position is pure in `t` and parallax, vibration and sound can all read `S(t)`. |
| Shot list for tools | `SHOTS`, `shot`, `window.__riso.shots` | Named shots with `readAt` and transition give the harness and score one timing source. |
| Live-plate compositor | `compose`, `resetPlates`, `put`, `add`, `knock`, `putM`, `smear`, `mixCov` | Per-plate coverage canvases screened by threshold at compose time; `put` occludes exactly, `knock` returns plates to paper, `smear` blurs along travel. |
| Parallax layers | `fields`, `bridge`, `forest`, `towers`, `mountains`, `ridgePath` | Each layer is placed by `S(t)` times its depth factor. |
| Reflections | `reflectPlates` (option `squash`), `canal`, `lakeside`, `mirrorAt` | Mirrors the plate stack below a waterline in rippled slices; `mirrorAt` turns the glass into a mirror in the dark. |
| Covered switches | `veil`, `fogD`, `hazeD`, `tunnel`, `passingTrain` | A content switch happens only while the view is a uniform field (D = 1) or fully occluded. |
| Sky keying | `SKYK`, `skyAt` | Palette keys over time; the one hard jump sits under a covered moment. |
| Seeded drops | `DROPS`, `dropPos`, `drops` | Seeded birth, stick time and radius; horizontal run follows `S(t)`, so drops stream at speed and fall straight once stopped. |
| Ballistic sparks | `BURSTS`, `ballistic`, `fwPos`, `fireworks` | Closed-form trajectories with drag; each burst is pure in its age. |
| Long exposure | `stars`, `STARS`, `POLE` | Trail arc length is a function of `t − T0`, not accumulated across frames. |
| Rainbow over reflection | `rainbow`, `lakeside` | Draw order fix: the arc drawn after the reflection so it does not mirror into an eye shape. |
| Sloshing glass | `SLOSH`, `slosh`, `glass` | A damped oscillator driven by `accel(t)` is integrated once at load into a table; `slosh(t)` interpolates it, so physics stays pure in `t`. |
| Level crossing | `crossing`, `X_LC` | A world event placed at a distance (`S(26.4)`), not a time. |

## films/roost — one continuous take, 70 s

A starling murmuration from sunset to nightfall in one fixed view. Eleven thousand birds are
the halftone: each is a solid 2–3 px indigo dot, and where the sheet turns edge-on they pile
into printed dark bands. Its compositor is window-seat's, copied.

| Technique | Where | Why copy it |
|---|---|---|
| Analytic crowd | `flockState`, `birdPos`, `BU`/`BV`/`BW`, `flockC` | Each bird owns a slot on a thin 3-D sheet that twists, bends and yaws by sums of slow sines; no simulation, so any `t` is exact and thousands of agents stay pure. |
| Crowd as tone | `drawFlock`, `birdGlyph` | Distant birds are dots whose density makes the value; only close birds get flapping glyphs. |
| Predator through a crowd | `falconWorld`, `TS`, `PS` | Birds are pushed from the falcon's current and two lagged positions, so the hollow trails it; the strike adds a travelling twist pulse. |
| Tilt as a horizon shift | `lookUp`, `horizon` | The only camera move is the horizon; every layer hangs off `horizon(t)`. |
| Draining into a point | `TR`, `XR`/`ZR` | Per-bird roost times are ordered along the sheet, so the flock pours in from one end rather than fading. |
| Reflections without glitter over them | `drawWater`, `GLIT`, `BK`, `BR` | Birds drawn to `BK` are mirrored into `BR` with the water's ripple, then cut from the glint mask so glints never print over reflected birds. |
| Stable glitter | `GLIT`, `drawWater` | Glints grow and shrink over about 2 s at full ink on a page-fixed column; see `FILM.md` for the flashing version this replaced. |
| Seeded reedbed | `REEDS`, `drawReeds`, `PLUMEC` | 210 stems with ribbon leaves; plumes on their own lighter plate mask; per-stem sway plus a shared gust. |

## films/held — cut narrative with physical rope, 70 s

A kite's line parts, it tumbles across a town, is snagged by a vane and caught by a sloop. Five
shots on window-seat's live plates; camera moves are vector reprojections before screening.

| Technique | Where | Why copy it |
|---|---|---|
| Rope and tail physics | `simChain`, `breeze`, `drawTail` | Verlet chain integrated once at load on a 1/240 s step, recorded at 60 Hz and interpolated, so `seek(t)` stays pure. Head node rides the attachment; bows orient from nodes ±2. |
| Line running through a snag | `gripAt`, `C_GRIP` | Pulls the rope point at arc length s onto a moving point, so line slides through a vane or up a forestay instead of pinning. |
| Velocity-matched handoff | `hk`, `C_KEYS`, `C_HAND`, `catchKite` | Hermite keys with explicit velocities; after the catch the kite is keyed relative to the masthead from its current position and velocity. |
| Events derived from simulation | `C_RING` | Where the simulated tail first meets the water, so the splash and its pan follow the physics. |
| Jitter metric | `chainsAt` (`__riso.chains`), `jitter.mjs` | Screen-space chain points for measuring frame-to-frame jumps; nothing draws them. |

## films/nonpareil — one overhead take, 70 s

Paper marbling from above: drops, stones, rake, comb and a pulled flower, then a sheet rolled on,
peeled back toward the lens like a page and landed face up, mirrored, beside the tray. The
compositor is window-seat's; the camera stays overhead and reprojects vectors.

| Technique | Where | Why copy it |
|---|---|---|
| Closed-form marbling | `opMap`, `applyOp`, `mapPoly`, `refine`, `stateAt`, `PREFIX` | Drops and tine passes are bijections of the plane (Jaffer & Lu), so every boundary stays a simple closed curve; stretched edges refine through the map; prefix checkpoints keep `seek(t)` pure. |
| One list for picture and score | `OPS`, `buildOps`, `beat` | Every drop lands on the 96 BPM grid; the picture, ripples, tools and score all read the same ops. |
| Bending sheet in perspective | `sheetAt`, `drawSheet`, `CURL`, `LOOP`, `PAT` | A curve across the fold drawn as runs of a baked coverage map, one affine map per run; heights scale by `HCAM/(HCAM − Z)`; screening stays in `compose()`. |
| Page-turn transfer | `peelAt`, `LOOP`, `PX` | A loop rolling without slipping puts the flap at x = 2a + λ − s, so the print is face up and mirrored by construction and lands exactly at `PX − s`. |
| Shadow of a rising surface | `castShadow` | Laid on the ground before any of the sheet is drawn; laid again only where the flap overhangs the part still lying down. |
| Lagging follow camera | `camTail`, `follow`, `sheetMid` | The camera tracks the carried sheet's mean x averaged over the last 0.6 s: a late, smooth follow that stays pure in `t`. |
| Water on a print | `drawRinse`, `frontV`, `wetRim`, `drawPool`, `RIVULETS` | A wavy front with a glossy band, flow streaks and the window reflected where it is wet; rivulets start on beats and are also score notes. |

## films/eclosion — one macro take, 36 s

A monarch leaves its chrysalis, pumps its crumpled wings full, shows them once and flies; the
camera returns to the empty case. Window-seat's compositor; the butterfly is a planar 3D model.

| Technique | Where | Why copy it |
|---|---|---|
| Planar 3D wings | `WING`, `wingFrame`, `bodyR`, `drawWingPattern` | Pattern in specimen units under one affine per wing (sweep, fold, body yaw/pitch/roll, orthographic camera); the wing normal picks the dorsal or ventral pattern. |
| Depth layering | `drawButterfly`, `wingDepth`, `axisFront`, `halfPlane` | Legs and far wings first; after each body part, wing surface nearer than it is redrawn through a screen half-plane clip. Holds from the side, from behind and in flight. |
| Crumple that unfolds | `PLEAT`, `deformer`, `drawCreases`, `expansion` | In-plane pleat displacement before the affine; creases print dark with paper ridges and fade as the wings pump full. |
| Layer through a ramp mask | `layer` | Draws a modelled surface into sprite plates and lays it over the frame as old·(1 − m) + new·m: the jade shell clearing bottom-up. |
| Motion blur for one subject | `blurred`, `TG`, `SIL` | Shutter samples drawn into sprite plates, averaged through the averaged silhouette. |
| Pendulum driven by events | `SWING`, `caseSwing` | Damped pendulum integrated once at load (240 Hz) and interpolated: shivers, the body's tug, a loaded rest, the push-off kick. |
| Still inside a container | `drawArt` (`inside`), `caseOutline` | The emerging body is clipped to below the split line and drawn under the case, so nothing pokes through the shell. |
| Measured specimen geometry | `measure-wings.py` | Rebuilds `WING` from a hash-pinned Commons photo; credit and license in `FILM.md`. |

## films/passenger — macro to wide in one take, 36 s

A butterfly draws itself in window fog, is warmed alive at sunrise and lands on the glass of
water; a child of Window Seat and anidoodle. Window-seat's compositor; a perspective dolly over a
3D carriage.

| Technique | Where | Why copy it |
|---|---|---|
| Fog as a scatter layer | `fogField`, `fogLayer`, `fogTint`, `fogGlow`, `fogLamps` | World-anchored density on a 270² grid; each plate halved to 34², mixed toward a near-paper tint, glows added at 135², laid through the mask as old·(1 − m) + F·m. Clear marks are cut from the mask at full resolution. |
| A drawing made in hand order | `STROKES`, `sched`, `tapAt`, `strokeHead`, `drawStrokes` | The schedule is built from stroke lengths and speeds at load, so the colouring-in can speed up; the score reads the same list. |
| Cells from a fan of veins | `makeWing`, `rayExit`, `scribble` | The outline is ray-cast from the wing base; cells are angular bands inset by the vein width; a boustrophedon scribble clears each one. |
| Drips on glass | `DRIPS`, `dripState`, `dripsOn`, `beads` | Beads at a stroke's low points run on an eased clock with a seeded meander; glint and dark rim are drawn after the fog. |
| Dolly with lens rise | `camAt`, `proj`, `planeT`, `kAt` | The horizon row is its own parameter, so everything outside reads only `hy` and the distance clock. |
| 3D carriage | `carriage`, `rrectPts`, `glassOfWater`, `ripples` | Pane, reveal, sill and tumbler projected per vertex, so the pull-back has parallax. |
| Planar 3D creature from 2D art | `basis`, `wingPt`, `drawWing`, `drawBody`, `drawButterfly` | The doodle's own geometry folds about the body axis; the frame comes from head and dorsal vectors blended rest → flight → perch; face chosen by the wing normal. |
| A view kept as pigment | `bakeTexture`, `TEX`, `TEX_GAIN`, `drawWing` (`look.tex`) | The outside at lift-off, baked once and mapped into the wing cells by an affine; the colour freezes as the wings return flat. |
| Flight keyed where it is seen | `FLIGHT`, `PATH`, `pathAt`, `poseAt` | Keys are screen position and depth, converted through the camera of that moment. |

## films/standby — one take from the bed, 52 s

A DVD player's idle logo bounces round a CRT in a dark bedroom around 2001, nearly hits a corner
three times and then does; the set switches off and the glow stars come up. The room is a
per-pixel raycast feeding the live plates.

| Technique | Where | Why copy it |
|---|---|---|
| Closed-form billiard | `logoXY`, `tri`, `BOUNCES`, `MISSES`, `logoInk` | Position solved backwards from the hit, so the corner lands on a chosen time and near misses fall out of the two wall periods; the shots, ink cycle and score read the same list. |
| Room as a raycast | `renderRoom`, `nearestBox`, `BOXES`, `MATS` | One ray per device pixel through axis-aligned boxes; each hit's material sets its unlit plate values, then light terms cut and ink them, straight into plate alpha. 250–440 ms/frame. |
| Blind stripes from a lamp | `blinds`, `WIN`, `LAMP`, `carAt` | Slat phase where the ray to the lamp crosses the window plane, blurred by the lamp's footprint, shadowed by the boxes; a moving lamp sweeps them. |
| Coloured light on a dark overprint | `renderRoom` (`Ls`, `La`, `keep`) | Direct light cuts the darks and inks equally; bounce light opens more than it inks, so yellow reads as a pale wash instead of olive. |
| A screen with depth | `inPicture`, `inRound`, `glassB`, `sheen`, `lip` | Rounded picture, a recess round the tube lit by the logo as it nears an edge, a window sheen, the logo's bloom; darker once the tube is dead. |
| Camera that reacts | `approach`, `LEANS`, `CREEP`, `frameAt` | A creep plus one smoothstep lean per near miss, in log distance, so velocity stays continuous and each lean follows an event. |
| CRT switch-off | `CRT`, `crtAt`, `drawCollapse` | Vertical squash with the picture inside, a line, a dot, an afterglow; the room light dies with the raster. |
| Lights left in the dark | `drawStars`, `drawLED`, `vfdPath`, `borderInk` | Glow stars, a red standby LED (pink over orange), a blinking 7-segment 12:00, and a wallpaper border only the light reveals. |
| Rim light on a foreground | `DUVET`, `drawDuvet`, `screenE` | Ridges filled past the frame; only crests facing the source catch its ink. |

## films/lumen — resonance form, 28 s

A centre dot opens eight worlds through irises and sweeps, recollects them through one
closing lens, then releases a flower. The template for cue-driven abstract shorts.

| Technique | Where | Why copy it |
|---|---|---|
| Cue list and dispatch | `CUES`, `DRAW`, `render` | Each cue is `{start, dur, kind}`; `render` runs every active cue's `DRAW[kind]`. |
| Overlapping reveals | `FLOW`, `drawWindow` | Each outgoing world stays until the next reveal (`reveal: 'iris'` or `'sweep'`) covers it; no empty beats. |
| One closing lens | `memoryRadius`, `drawRecollection`, `drawMemoryLens` | One continuous radius across four recollections; per-shot radii jumped. |
| Colourway swaps | `SWAPS`, `bakeScene(id, size, swap)` | Remaps plates for the recollection without redrawing scenes. |
| Scene registry | `scene('tide', {...})` with `live(ctx,u)` | Baked plates per world plus one live element. |
| Loop-safe live element | tide's `live` | Envelope value and slope reach zero before a filament wraps; recycling a visible carrier teleports a curve. |
| Release | `BLOOM`, `flowerGeometry`, `petal`, `drawRelease`, `drawNightGarden` | Staggered petal timings in one const that the score also reads. |
| Answer and attraction | `ANSWER_PULSES`, `drawAnswerRipples`, `drawAttraction` | Two voices approach; pulse times shared with the score. |
| Signature | `SCRIPT`, `letterStrokes`, `writeLetters`, `drawSignature` | Handwritten title drawn stroke by stroke with a progress parameter. |

## films/emergence — resonance form, sibling of lumen

Same machinery as lumen with new worlds; adds interference, a branch generator and screen
supercells.

| Technique | Where | Why copy it |
|---|---|---|
| Iris and sweep transitions | `FLOW`, `drawWindow` (`reveal`, `angle`) | Same contract as lumen; the sweep angle is per cue. |
| Branch generator | `arbor`, `arborPaths`, `drawArbor`, `ARBOR`, `NEURON_ARBOR` | One seeded generator grows both dendrites and the release; branches carry spawn times so any age replays purely. |
| Interference | `interference`, `drawAnswer` | Nodal lines drawn analytically from the two voices' positions. |
| Loop-safe fades | `life`, `smooth01`, `fract` | `life(v, edge)` is zero with zero slope at both ends of a wrap (web pluck, bubbles, network dashes). |
| Memory absorption | `MEMORY_ABSORB`, `drawMemory` | One const drives both picture and score. |
| Network ending | `NET`, `NET_EDGES`, `drawNetwork` | The arbor shrinks to one node; pulses travel edges. |
| Screen supercells | `SCREEN` (header comment), `buildScreen` | Non-reduced tangents (3/3, 2/0) keep the angle but add sub-pixel phases, so slow ramps stop banding into plateaus. Compare lumen's reduced `SCREEN`. |
| Knockouts | `carve`, `print`, `shade` with `cut` | A knockout at full coverage clears the screen gaps; highlights return to bare paper. |
| Drawn year digits | `YEAR`, `yearPath` | Small numerals as paths, sunk into or carved from the ground plate. |

## prints/

The print series, including `prints/workings` (whose print kit `tools/new-riso.mjs` copies),
are mapped in [riso-still/examples.md](../riso-still/examples.md).

## studies/

| File | Demonstrates | Look at |
|---|---|---|
| `studies/index.html` | Drawing-craft A/B pairs: silhouette, stroke, ramp, form, texture, depth, exemplars, motion weight and launch, live flame | `STUDIES` (ids and captions), `flame`, `FAMILY` |
| `studies/composition.html` | Frame budget, edge hierarchy, one event at several distances | `STUDIES`, `word` |
| `studies/scene-space.html` | 3D camera, path travel, cuts that preserve action time | `camera`, `pathByLength`, `travel`, `hermite`, `ballistic`, `staticObjects`, `motionObjects`, `SHOTS`; notes in `docs/scene-space.md` |
| `studies/sound.html` | The sound kit; see `riso-score/examples.md` | `Score`, `STUDIES` |

## How to borrow

- Copy routines, not scenes. A scene is tuned to its film's palette, timing and framing;
  the function underneath (`reflectPlates`, `arbor`, `life`) is what transfers.
- Check for collisions before pasting: every file defines `render`, `SCENES`, `INK`,
  `SCREEN`. Rename the borrowed routine or its constants when a name exists.
- Keep seeds keyed: take randomness from `rngFor('<film>:<thing>:<index>')`, never
  `Math.random()`, so the borrowed routine stays pure in `t`.
- Bring the timing contract with the routine: if it reads `S(t)`, `FLOW` or `CUES`, supply
  an equivalent in the new film rather than hard-coding times.
- Rerun `verify.mjs` after the paste; seek purity breaks quietly.
```

## File: README.md
upstream: https://github.com/sevenevesai/riso-windowseat/blob/main/README.md

```text
# riso-windowseat

Procedural risograph films and prints, each a single `index.html` of Canvas 2D and Web Audio:
no libraries, fonts, images or network calls. The sampled scores carry their recordings inside
the file. The repo began as the release of **Window Seat**. Making it, and the two shorts before
it, produced a reusable kit of Claude Code skills, craft docs and a render harness. Every film
and print since was made with that kit.

**[Watch the films](https://seveneves.ai/riso/)** ·
[Download the MP4s](https://github.com/sevenevesai/riso-windowseat/releases/tag/v1.0) ·
[Make your own](#make-your-own)

![Window Seat, dawn from the viaduct](films/window-seat/poster.png)

## Films

All are 1080 × 1080, 30 fps, and each is an MP4 on the
[v1.0 release](https://github.com/sevenevesai/riso-windowseat/releases/tag/v1.0). Every film
except Standby also plays at [seveneves.ai/riso](https://seveneves.ai/riso/). To watch the
source instead, open any `index.html` in a browser and press Play; sound starts off and has its
own toggle.

| Film | Length | |
|---|---|---|
| [Window Seat](films/window-seat/) | 78 s | A night train journey through one window, scored for piano |
| [Roost](films/roost/) | 70 s | One take of a starling murmuration from sunset to roost, scored for strings |
| [Held](films/held/) | 70 s | A kite that flies only while something holds its line, scored for found instruments |
| [Nonpareil](films/nonpareil/) | 70 s | Paper marbling from the first drop to the one print it makes, scored for handpan |
| [Eclosion](films/eclosion/) | 36 s | A monarch leaves its chrysalis, pumps its wings full and flies, in one take, scored for vibraphone, clarinet and horn |
| [Passenger](films/passenger/) | 36 s | A butterfly draws itself in the fog on a train window and comes alive at sunrise, scored procedurally |
| [Standby](films/standby/) | 52 s | A DVD player's idle logo bounces round a bedroom TV around 2001 until it hits the corner, scored as slow 90s lo-fi |
| [Lumen](films/lumen/) | 28 s | A seed that contains a sun; the first short, in the call-and-response [Resonance form](docs/forms/resonance.md) |
| [Emergence](films/emergence/) | 28 s | Lumen's sibling in the same form: how machines learned to listen, as nine worlds |

### Window Seat

A night train journey seen through one fixed window with a glass of water on the sill. Every
pixel and every sound except the piano is procedural.

| Time | Passage |
|---|---|
| 0–19 s | Golden departure from a platform, fields, a red truss bridge, a conifer cutting, a tunnel |
| 19–38 s | A night city with a canal and a level crossing; another train overtakes, passengers in its windows |
| 38–57 s | Fireworks over a far town, reflected in a lake; sleeper hours with star trails; pre-dawn fog |
| 57–78 s | Dawn from a viaduct, rain streaming back along the glass, a lakeside halt under a rainbow |

The score, "A Light Left in the Window", is an original piano piece in 6/8 whose phrasing follows
the picture's timeline. The glass of water leans with every acceleration and is the last thing to
settle.

![Contact sheet of Window Seat's shots](films/window-seat/sheet.jpg)

### Roost

<a href="films/roost/preview.webp" title="Open the larger preview"><img src="films/roost/preview-thumb.webp" width="180" align="right" alt="Roost: the flock over the sun, the falcon strike, starlings pouring past, the roost"></a>
A murmuration over a marsh in one fixed view. Each starling is a 2–3 px ink dot, so the flock
is the halftone: where the sheet turns edge-on, the birds pile into dark printed ribbons. A
falcon stoops through it and the flock pours into the reeds at nightfall. The string score is
timed from the picture.

<br clear="right">

### Held

<a href="films/held/preview.webp" title="Open the larger preview"><img src="films/held/preview-thumb.webp" width="180" align="right" alt="Held: the kite on the hill, the line parting, the church vane, the sloop's catch"></a>
A paper kite's line frays and parts at a hillside stake. Loose, it can only tumble; it falls
across a harbour town, is snagged for a moment by a church weathervane, and over the water its
line catches on a sloop's forestay, so the kite climbs again, held by the boat sailing into
dusk. Its tail and loose line are simulated ropes. The score uses CC0 mbira, harp, glockenspiel,
chimes, strings and flute, with every cue read from the picture's events.

<br clear="right">

### Nonpareil

<a href="films/nonpareil/preview.webp" title="Open the larger preview"><img src="films/nonpareil/preview-thumb.webp" width="180" align="right" alt="Nonpareil: drops landing, the comb crossing, a bullseye pulled into a flower, the sheet peeling back"></a>
Paper marbling seen straight down into the bath. Drops of colour land on the beat and push each
other outward; a rake and a fine comb drag them into the nonpareil pattern, and a flower is
dropped and pulled into the middle. A sheet unrolls across the bath, is peeled back toward the
lens like a turning page, and lands face up and mirrored beside the emptied tray. The marbling
is closed-form geometry, so every frame is exact. The drops are the handpan's notes, over a
slow cello and contrabass line.

<br clear="right">

### Eclosion

<a href="films/eclosion/preview.webp" title="Open the larger preview"><img src="films/eclosion/preview-thumb.webp" width="180" align="right" alt="Eclosion: the case splitting, the butterfly swinging out, the full display, the flight"></a>
One monarch's first morning, in one continuous macro take. A jade chrysalis clears and splits;
the butterfly drops out, hangs from the empty shell and pumps its crumpled wings full in six
slow pulses while its swollen abdomen shrinks. It turns, opens its wings twice and flies, and
the camera returns to the empty case, framed as the chrysalis was in the first second. The
wings are a planar 3D model whose pattern was measured from a specimen photograph, layered by
depth so the body reads right from the side, from behind and in flight. A slow trio in F for
vibraphone, clarinet and horn shares the picture's clock.

<br clear="right">

### Passenger

<a href="films/passenger/preview.webp" title="Open the larger preview"><img src="films/passenger/preview-thumb.webp" width="180" align="right" alt="Passenger: the drawing in the fog, sunrise and ink, lift-off, the wings opening on the glass"></a>
A child of this repo and [alexgreensh/anidoodle](https://github.com/alexgreensh/anidoodle):
Window Seat's window and glass of water, and anidoodle's drawing that makes itself and then comes
alive. Before dawn a butterfly draws itself in the fog on a train window, stroke by stroke in the
order a finger would. Its clear lines are windows, so lamps slide through the drawing and the dawn
fills its wings. The sunrise warms it off the glass and the camera pulls back from the pane to the
seat. It lands on the rim of the glass of water and drinks, and the butterfly-shaped hole it left
stays in the fog. The score is procedural, from the shared kit: every mark of the drawing is a
note, and the opening motif is answered as the wings open.

<br clear="right">

### Standby

<a href="films/standby/preview.webp" title="Open the larger preview"><img src="films/standby/preview-thumb.webp" width="180" align="right" alt="Standby: a near miss at the screen's corner, the hit in pink, the raster collapsing to a dot, headlights sweeping the stars"></a>
A kid's bedroom around 2001, long after bedtime. The DVD player has idled so long that its logo
bounces round the dark CRT, taking a new ink at every edge and lighting the room in it. From the
bed we wait for the logo to land exactly in a corner; it nearly does three times, each miss
closer, and the camera leans in after each. When it lands, the screen flares pink, and the sleep
timer switches the set off: the picture collapses to a line, then a dot. In the dark the glow
stars come up, the DVD/VCR blinks 12:00, and a passing car sweeps the blind stripes across the
wal
```
