Riso Film

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 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) 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.