Text to motion graphics for Claude Code and Codex: write a brief, get a checked MP4. 30 art forms from claymation and paper cut-out to anime and pixel art, 2D explainers, Shorts, 3D products. Installs brief2motion for websites. MIT.
Python 3dagent-skillsai-videoanimationblenderclaude-codeclaude-skillsclaymationcodexexplainer-videoffmpeggsaphyperframeskinetic-typographymanimmotion-graphicstext-to-videothreejsvideo-generationyoutube-shorts
docs: a 35-page art forms guide with editable source
Varun Pratap Bhardwaja072751baaee
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 250b43c..1c657df 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -11,6 +11,8 @@ All notable changes to brief2mp4. The format follows [Keep a Changelog](https://- `scripts/build_art_forms.py`: generates the index and the 30 pages from `references/art-forms.json` and the demo code, so they cannot drift apart.- Tests: `tests/test_art_forms.py` (data, generated pages, router, and a ban on clocks and unseeded randomness in the demos) and `tests/art_forms/check_looks.mjs`, which draws every look in headless Chrome and checks that it paints, changes over time and gives identical pixels when the same time is drawn twice.+- `docs/art-forms-guide/`: a 35-page companion guide as a PDF, with its editable HTML, CSS and Python source.+### Notes- Tested on macOS with Chrome 157. The demos are checked as browser pictures; no art-form video was rendered through HyperFrames for this change.- The version number and the marketplace entry are unchanged and need a release decision.diff --git a/README.md b/README.mdindex 9a34c0a..33200b6 100644--- a/README.md+++ b/README.md@@ -144,7 +144,7 @@ Say "claymation", "paper cut-out", "anime", "like a blueprint" or "shadow puppet| Geometry, pixels and 3D | isometric, low-poly, voxel, pixel art, 3D product render || Type, data and retro | kinetic typography, infographic, lyric video, VHS and glitch, blueprint, neon sign |-Three rules carry all of them: the picture is a function of time, handmade looks hold their drawings at 8 to 12 changes a second while the video stays at 24 or 30, and every wobble, flicker and misregistration is seeded by the drawing number, so two renders of the same frame match. `python3 plugin/skills/brief2mp4/scripts/art_route.py BRIEF.md` proposes a form from a brief and says why. The demos are browser pictures checked for determinism; they are starting points for a scene, not finished films.+Three rules carry all of them: the picture is a function of time, handmade looks hold their drawings at 8 to 12 changes a second while the video stays at 24 or 30, and every wobble, flicker and misregistration is seeded by the drawing number, so two renders of the same frame match. `python3 plugin/skills/brief2mp4/scripts/art_route.py BRIEF.md` proposes a form from a brief and says why. The demos are browser pictures checked for determinism; they are starting points for a scene, not finished films. The [art forms guide](docs/art-forms-guide/brief2mp4-art-forms.pdf) (PDF, 35 pages) covers every form with a picture, and its HTML, CSS and Python source is in the same folder.**Proof the skill works:** example brief 01, pasted as written, came back as a 12.000 s, 1920x1080, 30 fps file that passed the delivery check. Its [report](examples/01-kinetic-type/SAMPLE-REPORT.md) lists every requirement with its evidence: which still shows which line, the measured headline height (126 px against a 120 px minimum), the text bounds and the loudness at each sound accent.diff --git a/docs/art-forms-guide/.gitignore b/docs/art-forms-guide/.gitignorenew file mode 100644index 0000000..aecb167--- /dev/null+++ b/docs/art-forms-guide/.gitignore@@ -0,0 +1,2 @@+qa/+.venv/diff --git a/docs/art-forms-guide/README.md b/docs/art-forms-guide/README.mdnew file mode 100644index 0000000..9b402f5--- /dev/null+++ b/docs/art-forms-guide/README.md@@ -0,0 +1,21 @@+# The brief2mp4 art forms guide++[`brief2mp4-art-forms.pdf`](brief2mp4-art-forms.pdf) is a companion guide to the art forms in brief2mp4: the three rules behind every look, how to choose one from a brief, a half-page recipe for each of the 30 forms, and the tools by name.++It is built from editable sources in this folder. The art-form pages come from `plugin/skills/brief2mp4/references/art-forms.json`, so the guide cannot drift from the skill.++| File | What it is |+|---|---|+| `build.py` | the prose and the assembly; writes `brief2mp4-art-forms.html` and `guide-prose.txt` |+| `guide.css` | the print stylesheet |+| `render.py` | HTML to PDF with WeasyPrint, then checks page count, contents links, text inside every page and metadata |+| `img/` | one frame per demo, written by `node tests/art_forms/check_looks.mjs --frames <dir>` |+| `fonts/` | Inter and Space Grotesk (SIL Open Font License 1.1) and DejaVu Sans Mono, each with its licence text |++```bash+python3 -m venv .venv && .venv/bin/pip install -r docs/art-forms-guide/requirements.txt pillow+.venv/bin/python docs/art-forms-guide/build.py+.venv/bin/python docs/art-forms-guide/render.py --sheets+```++WeasyPrint needs the Pango libraries: `brew install pango` on macOS, `sudo apt install libpango-1.0-0 libpangoft2-1.0-0` on Debian or Ubuntu.diff --git a/docs/art-forms-guide/brief2mp4-art-forms.html b/docs/art-forms-guide/brief2mp4-art-forms.htmlnew file mode 100644index 0000000..8dc6b93--- /dev/null+++ b/docs/art-forms-guide/brief2mp4-art-forms.html@@ -0,0 +1,31 @@+<!doctype html><html lang="en"><head><meta charset="utf-8"><title>brief2mp4: the art forms guide</title>+<meta name="author" content="Varun Pratap Bhardwaj"><meta name="description" content="30 art forms for animated video, with the rules, timing and build recipe for each.">+<meta name="keywords" content="animation styles, claymation, paper cut-out, cel shading, stop motion, HyperFrames, three.js, Claude Code skill">+<link rel="stylesheet" href="guide.css"></head><body><section class="cover"><div class="eyebrow">Qualixar<span>Companion guide · November 2026</span></div>+<h1>brief<i>2</i>mp4</h1><div class="deck">The art forms guide</div>+<div class="strap">30 looks for animated video, and how to build each one in code that renders the same way twice.<br>Claymation · paper cut-out · shadow puppetry · anime · watercolour · ink · risograph · pixel art · voxel · VHS · neon</div>+<img class="mark" src="../../plugin/assets/icon.png" alt="">+<div class="by">Varun Pratap Bhardwaj · github.com/qualixar/brief2mp4 · MIT licence</div></section><section id="contents"><div class="eyebrow">Contents<span>brief2mp4</span></div><h1>Contents</h1><div class="toc"><a href="#what">A look is a set of rules</a><a href="#rules">Three rules behind every look</a><a href="#choose">Choosing a look from a brief</a><a href="#form-craft-0">Craft and handmade</a><a href="#form-drawn-0">Drawn and painted</a><a href="#form-geometry-0">Geometry, pixels and 3D</a><a href="#form-type-0">Type, data and retro</a><a href="#tools">Tools that exist, by name</a><a href="#sources">Sources and what was verified</a></div><aside><b>How to use this guide</b><p>Read the three rules first. Then find the look you want; each takes half a page. The last pages list the tools by name and say what was and was not verified.</p></aside></section><section id="what"><div class="eyebrow">Orientation<span>brief2mp4 art forms</span></div><h1>A look is a set of rules</h1><p class="lead">Ask for "claymation" or "a paper cut-out" and you are asking for a short list of things: how edges look, how light falls, how often the picture changes. This guide writes those lists down for 30 art forms, and shows how to build each one in code that renders the same way every time.</p><p>It is a companion to brief2mp4, the skill that turns a written brief into a finished, checked MP4. The skill builds video from web pages: HTML, CSS and GSAP in HyperFrames, canvas, SVG and Three.js. Every art form here has a reference page in the skill and a small demo that is tested in a real browser.</p><figure><img src="../../assets/art-forms.jpg" alt=""><figcaption>One frame from each of the 31 demos, drawn by the test that checks them.</figcaption></figure><table><col style="width:24%"><col style="width:76%"><thead><tr><th>Family</th><th>Art forms</th></tr></thead><tbody><tr><td>Craft and handmade</td><td>Claymation, Stop-motion look, Paper cut-out, Felt and fabric craft, Origami, Shadow puppetry, Collage and mixed media, Risograph and halftone print</td></tr><tr><td>Drawn and painted</td><td>Anime and cel shading, 2D flat vector explainer, Whiteboard and doodle, Watercolour, Ink wash (sumi-e), Line art, Rotoscope look, Motion comic, UPA and mid-century modern, Rubber-hose cartoon, Linocut and woodcut print</td></tr><tr><td>Geometry, pixels and 3D</td><td>Isometric, Low-poly 3D, Voxel, Pixel art, 3D product render</td></tr><tr><td>Type, data and retro</td><td>Kinetic typography, Infographic and data animation, Lyric video, VHS and glitch, Blueprint and technical drawing, Neon sign</td></tr></tbody></table><aside><b>What the demos are</b><p>Small pictures that prove a technique: a few seconds, 960 by 540, drawn on a canvas or with Three.js. They are starting points for a scene, not finished films. No art-form video was rendered through HyperFrames for this guide.</p></aside></section><section id="rules"><div class="eyebrow">The method<span>brief2mp4 art forms</span></div><h1>Three rules behind every look</h1><p class="lead">A renderer that works frame by frame asks for frame 212, then frame 213, sometimes out of order and on several workers. Three rules make any look survive that.</p><h2>1. The picture is a function of time</h2><p>No clock, no timers, no <code>Math.random()</code>. Whatever is on screen at second 4.2 must depend on the number 4.2 and nothing else. Randomness comes from a hash of the frame number or of a position, so it is the same on every run.</p><pre><code>export function hash(a, b = 0, c = 0) { // a repeatable number in 0..1 from up to three integers+ let n = (Math.imul(a | 0, 374761393) + Math.imul(b | 0, 668265263) + Math.imul(c | 0, 2147483647)) | 0;+ n = Math.imul(n ^ (n >>> 13), 1274126177);+ return ((n ^ (n >>> 16)) >>> 0) / 4294967295;+}</code></pre><h2>2. Handmade looks hold their drawings</h2><p>Film runs at 24 frames a second, but clay, paper and hand-drawn animation are usually shot "on twos": each pose is held for two frames, so the picture changes about 12 times a second. That stepping is most of what makes them read as handmade. Quantise time before posing anything, and leave the video itself at 24 or 30.</p><pre><code>export const frameOf = (t, fps) => Math.floor(t * fps + 1e-6); // which drawing we are on+export const held = (t, fps) => frameOf(t, fps) / fps; // time, quantised+const ts = held(t, 12); // "on twos"+// in GSAP the same idea for one tween: gsap.to(el, { x: 400, duration: 1, ease: "steps(12)" })</code></pre><p>Clean looks are the opposite: a flat explainer, a low-poly scene, a product render and kinetic type stay smooth at the full frame rate.</p><h2>3. Imperfection is seeded</h2><p>Line boil, paper jitter, lamp flicker, misregistered ink and tape damage all come from one line: a small nudge keyed to the drawing number.</p><pre><code>export const jit = (frame, i, amount) => (hash(frame, i, 7) - 0.5) * 2 * amount;+const f = frameOf(t, 12);+x += jit(f, partIndex, 1.2); // this part sits 1.2 px off, differently on each drawing, identically on each render</code></pre><aside><b>The usual web recipe breaks rule 1</b><p>Most tutorials make a hand-drawn line wobble with a timer that re-rolls an SVG filter every 100 milliseconds. A frame-by-frame renderer has no such timer. Key the change to the frame number instead, and the wobble is part of the frame.</p></aside><h2>How the demos are checked</h2><p>A test draws every look in headless Chrome at three moments. The three pictures must differ, none may be blank, and the middle one, drawn a second time after the others, must match itself pixel for pixel. A second test reads the source and fails if a clock, a timer or <code>Math.random</code> appears anywhere in it.</p></section><section id="choose"><div class="eyebrow">The method<span>brief2mp4 art forms</span></div><h1>Choosing a look from a brief</h1><p class="lead">If the brief names a look, use it. If it does not, the subject and the mood usually point to one.</p><table><col style="width:30%"><col style="width:34%"><col style="width:36%"><thead><tr><th>The brief is about</th><th>Try</th><th>Why</th></tr></thead><tbody><tr><td>children, family, a gentle story</td><td>paper cut-out, claymation, felt</td><td>handmade textures feel warm and safe</td></tr><tr><td>a folk tale, a myth, heritage</td><td>shadow puppetry, linocut, ink wash</td><td>the form carries the tradition; check the iconography with a source</td></tr><tr><td>explaining a product or a process</td><td>flat vector explainer, isometric, whiteboard</td><td>clean shapes keep attention on the idea</td></tr><tr><td>numbers</td><td>infographic</td><td>the chart is the picture; every number needs a source</td></tr><tr><td>a song or a quote</td><td>lyric video, kinetic typography</td><td>the words are the content</td></tr><tr><td>a physical product</td><td>3D product render; claymation for a playful take</td><td>the object is the hero</td></tr><tr><td>nostalgia</td><td>VHS and glitch, pixel art, rubber-hose, UPA mid-century</td><td>each one is a decade</td></tr><tr><td>calm, reflective</td><td>watercolour, ink wash, line art</td><td>slow, sparse, quiet</td></tr><tr><td>loud, independent</td><td>risograph, collage, motion comic</td><td>print energy and hard cuts</td></tr></tbody></table><pre><code>$ python3 plugin/skills/brief2mp4/scripts/art_route.py BRIEF.md+Art form: Shadow puppetry (inferred)+ why: a traditional story: the form carries the tradition ("ramayana")+ cadence: steps 12 times a second+ usual tool: HyperFrames (canvas or SVG)+ note: Use Blender for real light through translucent coloured leather.+ or: Linocut and woodcut print, Ink wash (sumi-e)+ read: references/art-forms/shadow-puppet.md</code></pre><p>The router is a keyword scorer, not a judge. One stray word is never enough ("paper" in "paper plane" does not choose paper cut-out), and when nothing fits it says so. An art form sets the look and the timing; the kind of video (explainer, Short, launch) still sets the beats.</p><h2>Writing the look into the brief</h2><p>A look becomes checkable when the brief says what should be visible. Two lines are enough:</p><pre><code>Look: paper cut-out. Flat layers with a small shadow under each, edges that look cut by hand, paper grain.+Done when: at 4.0 s the frame shows at least three paper layers with shadows; the bird's wings+ change at most 12 times a second; nothing moves between drawings.</code></pre><h2>Assets</h2><p>Most looks here need no pictures at all: shapes, textures and grain are drawn in code. Where a look needs photographs, footage, a character model or music, use only what you own or may reuse. If you have an image model, it can generate textures and cut-out parts; say in the report that they were generated.</p></section><section id="form-craft-0"><div class="eyebrow">Craft and handmade<span>brief2mp4 art forms</span></div><h1>Craft and handmade</h1><p class="lead">Looks that show the hand: real materials, held drawings, small errors.</p><div class="style"><div class="fam">Craft and handmade · 12 changes a second · Three.js inside HyperFrames</div><h2>Claymation</h2><p>Figures of clay or plasticine, posed and photographed one frame at a time. Soft, lumpy, a little uneven, and never perfectly smooth in motion. Plasticine dates from 1897. Art Clokey (Gumby) and Aardman, founded in 1972, made the look famous.</p><div class="cols"><div class="pic"><img src="img/claymation.jpg" alt=""><h3>Timing</h3><p>Shot on doubles: about 12 pose changes a second inside a 24 frames-a-second film. Each held pose sits a hair differently from the last.</p><h3>Assets</h3><p>Geometry in code (spheres, capsules, lathes) for simple characters. Fingerprint or noise detail as a generated bump texture. A real character needs modelling.</p><h3>Sound</h3><p>Close foley on pose changes (soft thuds, squelches), light percussion. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Rounded volumes with small lumps and dents, never a perfect sphere</li><li>Matte, high-roughness surfaces under soft light</li><li>Saturated colour, few of them</li><li>Small asymmetries; a silhouette that changes slightly between poses</li><li>A miniature set: a floor, a backdrop, shallow depth</li></ul><h3>What makes it look wrong</h3><ul><li>Smooth 24 or 30 frames-a-second motion: it reads as CG, not clay</li><li>Glossy plastic highlights</li><li>Perfect symmetry and clean edges</li></ul></div><div><h3>How to build it</h3><ul><li>Three.js: <code>MeshStandardMaterial</code> with roughness about 0.9, metalness 0, and a noise canvas as <code>bumpMap</code></li><li>Push each vertex in or out by a few percent with a seeded hash, then <code>computeVertexNormals()</code></li><li>Pose from stepped time: <code>held(t, 12)</code></li><li>Add a seeded nudge per drawing to position and rotation (about 2% of the size)</li><li>A hemisphere light plus one soft key; no hard specular highlights</li></ul><p>Use Blender when the clay needs real subsurface scattering, soft area-light shadows or sculpted detail.</p></div></div></div><div class="style"><div class="fam">Craft and handmade · 12 changes a second · HyperFrames (canvas or DOM) or Three.js</div><h2>Stop-motion look</h2><p>Any real object moved and photographed a pose at a time. On screen it shows as stepped motion, tiny position errors and light that flickers a little. As old as film: stop tricks appear in the 1890s. Pixilation, cut-out and puppet animation are all forms of it.</p><div class="cols"><div class="pic"><img src="img/stop-motion.jpg" alt=""><h3>Timing</h3><p>On twos (12 changes a second) is the usual cadence; action sometimes on ones, held moments on threes or more.</p><h3>Assets</h3><p>None needed. Everything is procedural.</p><h3>Sound</h3><p>Foley that lands on pose changes. A bed that is not too smooth. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Real materials: wood, card, cloth, plastic</li><li>Position jitter of a pixel or two between drawings</li><li>Lighting that varies slightly frame to frame</li><li>Hard cuts between poses, no in-between blur</li></ul><h3>What makes it look wrong</h3><ul><li>Stepping the camera and background together, so everything strobes</li><li>Easing between held poses, which defeats the look</li><li>Jitter so large the object vibrates</li></ul></div><div><h3>How to build it</h3><ul><li>Quantise time before anything else: <code>const ts = held(t, 12)</code></li><li>GSAP: <code>ease: "steps(12)"</code> on a one-second tween does the same for a tween</li><li>Jitter and flicker keyed to the frame number: <code>jit(frameOf(t, 12), i, 1.2)</code></li><li>Keep the camera and background steady: step the subject, not the world</li></ul></div></div></div></section><section id="form-craft-2"><div class="eyebrow">Craft and handmade<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Craft and handmade · 12 changes a second · HyperFrames (canvas, SVG or DOM)</div><h2>Paper cut-out</h2><p>Flat shapes cut from paper or card, layered, and moved a pose at a time. Parts hinge at joints; nothing bends. Lotte Reiniger's The Adventures of Prince Achmed (1926) is the oldest surviving animated feature. Terry Gilliam's Monty Python animations and the South Park pilot used cut paper.</p><div class="cols"><div class="pic"><img src="img/paper-cutout.jpg" alt=""><h3>Timing</h3><p>Stop-motion cadence, usually on twos. Motion is rotation about joints and sliding, with pops and holds.</p><h3>Assets</h3><p>Shapes drawn in code or as SVG. Photo cut-outs need images you own, or generated ones.</p><h3>Sound</h3><p>Paper rustle, snips, soft ticks on pose changes. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Flat fills with hard, slightly uneven cut edges</li><li>Layers stacked with a small, tight shadow under each</li><li>Rigid parts that rotate about a pivot</li><li>Paper grain over everything</li><li>A limited, slightly muted palette</li></ul><h3>What makes it look wrong</h3><ul><li>Smooth vector motion with no stepping</li><li>Perfect edges</li><li>Large soft shadows, which look like interface cards, not paper</li></ul></div><div><h3>How to build it</h3><ul><li>Each part is its own shape; nudge the corners with a seeded hash so edges look cut by hand</li><li>Canvas: <code>shadowOffsetY</code> 3 to 4 px with <code>shadowBlur</code> 4 to 5 px per layer. DOM: <code>filter: drop-shadow()</code></li><li>Joints: rotate about a pivot (<code>transformOrigin</code> in GSAP, <code>translate</code> then <code>rotate</code> on a canvas)</li><li>Paper grain: a noise texture drawn once and laid over with <code>multiply</code></li><li>SVG route: <code>feTurbulence</code> into <code>feDisplacementMap</code> (scale 2 to 4) roughens an edge</li></ul><p>Use Blender for real folded paper with thickness and light passing through it.</p></div></div></div><div class="style"><div class="fam">Craft and handmade · 12 changes a second · HyperFrames (canvas or SVG)</div><h2>Felt and fabric craft</h2><p>Shapes that look needle-felted or sewn: a fuzzy edge of loose fibres, a matte mottled surface, visible stitches. Needle felting tangles wool fibres with barbed needles to make flat pictures and soft figures.</p><p class="muted small">Sourcing note: The craft is well documented; its use in animation is a practice note, not sourced.</p><div class="cols"><div class="pic"><img src="img/felt.jpg" alt=""><h3>Timing</h3><p>Stop-motion cadence, on twos. Gentle bobbing and nudging.</p><h3>Assets</h3><p>Procedural. A felt texture from an image model helps for close-ups.</p><h3>Sound</h3><p>Soft, warm, acoustic. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>A halo of short fibres along every edge</li><li>Matte, slightly mottled colour</li><li>Stitches: a dashed line just inside the edge</li><li>Chunky, simple forms in wool colours</li></ul><h3>What makes it look wrong</h3><ul><li>Crisp vector edges</li><li>Flat plastic colour</li><li>No fibre fuzz</li></ul></div><div><h3>How to build it</h3><ul><li>Draw the shape, then several hundred short strokes outward from its edge, each angled by a seeded hash</li><li>Stitches: <code>setLineDash([9, 7])</code> on a path just inside the edge (SVG: <code>stroke-dasharray</code>)</li><li>Mottle: a grain texture clipped to the shape with <code>multiply</code></li><li>SVG route: high-frequency <code>feTurbulence</code> (0.8 to 1.2) with displacement scale 3 to 6 on the edge</li></ul><p>Use Blender hair or fur for real fibre fuzz on 3D figures.</p></div></div></div></section><section id="form-craft-4"><div class="eyebrow">Craft and handmade<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Craft and handmade · smooth · HyperFrames (canvas or SVG), or Three.js</div><h2>Origami</h2><p>Paper folded from a flat sheet: sharp creases, flat facets, each fold a clean move followed by a pause. Japanese paper folding. Modern computational origami works from crease patterns.</p><div class="cols"><div class="pic"><img src="img/origami.jpg" alt=""><h3>Timing</h3><p>Folds are eased moves of about 0.8 seconds with a short hold after each. Smooth, not stepped.</p><h3>Assets</h3><p>Geometry in code. A faint paper grain.</p><h3>Sound</h3><p>Light paper crinkle on each fold, soft piano or music box. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Sharp mountain and valley creases</li><li>Flat facets, each shaded as one plane</li><li>Paper coloured on one side, white on the other</li><li>Soft, even light so the creases read</li></ul><h3>What makes it look wrong</h3><ul><li>Faces passing through each other</li><li>Folding with no hold, so the eye cannot follow</li><li>Light that hides the creases</li></ul></div><div><h3>How to build it</h3><ul><li>2D: a fold is a point travelling across the crease; draw the moving flap from the crease to that point</li><li>Shade the flap by its angle, and swap to the paper's other colour past 90 degrees</li><li>3D: flat-shaded polygons, child groups rotating about the crease axis</li><li>An orthographic camera gives a diagram-clean view</li></ul><p>Use Blender when the paper has to bend or show thickness.</p></div></div></div><div class="style"><div class="fam">Craft and handmade · 12 changes a second · HyperFrames (canvas or SVG)</div><h2>Shadow puppetry</h2><p>Flat figures held between a lamp and a cloth screen: dark silhouettes with punched patterns on a warm, glowing field. An old tradition across Asia. Ravana Chhaya of Odisha uses uncoloured deerskin puppets with no joints; wayang kulit of Java and Bali was recognised by UNESCO in 2003. Lotte Reiniger brought silhouettes to film.</p><div class="cols"><div class="pic"><img src="img/shadow-puppet.jpg" alt=""><h3>Timing</h3><p>Live puppets move continuously on rods; film versions are stop-motion, so use twos. Stiff, deliberate moves; no squash and stretch.</p><h3>Assets</h3><p>Simple figures in code. Ornate traditional figures need drawing or tracing with care.</p><h3>Sound</h3><p>Narrator, singers and percussion in the tradition: cymbals and drums for Ravana Chhaya, gamelan for wayang.</p></div><div><h3>What makes it read as this</h3><ul><li>Black silhouettes on a warm lit screen, never on white</li><li>Interior detail made of perforations: rows of holes and cut patterns</li><li>A lamp that flickers</li><li>The shadow softens and grows as the puppet moves away from the screen</li><li>Rods visible below the figures</li></ul><h3>What makes it look wrong</h3><ul><li>Black on white, which loses the lamp</li><li>Smooth modern vector motion</li><li>Careless drawings of sacred figures: check the iconography with a source</li></ul></div><div><h3>How to build it</h3><ul><li>One path per puppet filled with the even-odd rule, so holes are part of the figure</li><li>Screen: a radial gradient from warm yellow to deep brown</li><li>Flicker: scale the lamp brightness by a seeded value per drawing</li><li>Distance from the screen: <code>filter: blur()</code> growing with distance, and lower opacity</li><li>Ravana Chhaya style: no joints, move and tilt the whole puppet. Wayang style: hinge the arms</li></ul><p>Use Blender for real light through translucent coloured leather.</p></div></div></div></section><section id="form-craft-6"><div class="eyebrow">Craft and handmade<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Craft and handmade · 8 changes a second · HyperFrames (canvas or DOM)</div><h2>Collage and mixed media</h2><p>Pieces of different papers, photographs and print stuck together: mismatched scale and texture, torn edges, hard shadows. From the French coller, to glue. Braque and Picasso brought it into modern art around 1912; Dada followed with photomontage.</p><div class="cols"><div class="pic"><img src="img/collage.jpg" alt=""><h3>Timing</h3><p>On twos or threes. Pieces pop into place on the beat with a small rotation, then hold.</p><h3>Assets</h3><p>Paper textures in code. Photo fragments need images you own, or generated ones.</p><h3>Sound</h3><p>Bright percussive music, staccato effects on each pop. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Torn or cut edges</li><li>Mixed materials: flat colour, halftone photograph, tape</li><li>Overlap with a hard, offset shadow</li><li>Mismatched scale on purpose</li><li>One palette holding it together</li></ul><h3>What makes it look wrong</h3><ul><li>Everything neatly aligned</li><li>No shadows</li><li>Too many unrelated colours and typefaces</li></ul></div><div><h3>How to build it</h3><ul><li>Torn edge: walk the outline of a rectangle and nudge every point with a seeded hash</li><li>Hard shadow: <code>shadowBlur: 0</code> with an offset of 5 to 6 px</li><li>Halftone a photo: dots on a staggered grid sized by brightness</li><li>Entrance: scale from 1.25 to 1 with a quarter-turn of rotation over a quarter of a second</li></ul></div></div></div><div class="style"><div class="fam">Craft and handmade · 8 changes a second · HyperFrames (canvas or DOM)</div><h2>Risograph and halftone print</h2><p>The look of a cheap stencil print: two to four bright inks laid over each other, visible grain, dot screens, and layers that never quite line up. The Risograph duplicator dates from 1980: one ink per drum, so each colour is a separate pass. Halftone dots go back to the 1860s.</p><div class="cols"><div class="pic"><img src="img/risograph.jpg" alt=""><h3>Timing</h3><p>Print is still. Animate by re-rolling the misregistration and swapping the grain 8 to 12 times a second.</p><h3>Assets</h3><p>All procedural. A chunky sans or slab typeface.</p><h3>Sound</h3><p>Lo-fi, tape hiss. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Two to four spot colours, often pink, blue and yellow</li><li>Inks overprint to make new colours (multiply)</li><li>Each layer sits a pixel or two off register</li><li>Grain and dot screens; no smooth gradients</li><li>Off-white paper</li></ul><h3>What makes it look wrong</h3><ul><li>Gradients</li><li>Perfect registration</li><li>More than four colours</li></ul></div><div><h3>How to build it</h3><ul><li>Each ink is its own layer drawn with <code>mix-blend-mode: multiply</code> (canvas: <code>globalCompositeOperation</code>)</li><li>Offset each layer by a seeded amount per drawing: <code>jit(frameOf(t, 8), layer, 3)</code></li><li>Tone as dots: a staggered grid of circles whose radius follows the tone</li><li>Grain: several pre-made noise tiles, cycled by frame number</li><li>Three.js <code>HalftonePass</code> exists for 3D scenes; SVG <code>feColorMatrix</code> separates a photo into one ink</li></ul></div></div></div></section><section id="form-drawn-0"><div class="eyebrow">Drawn and painted<span>brief2mp4 art forms</span></div><h1>Drawn and painted</h1><p class="lead">Looks made of line and paint, from cel animation to ink on paper.</p><div class="style"><div class="fam">Drawn and painted · 12 changes a second · Three.js inside HyperFrames</div><h2>Anime and cel shading</h2><p>Light broken into two or three flat tones with a hard edge between them, and an ink outline around every form. Named after the celluloid sheets of hand-drawn animation. In 3D it became toon shading, as in Jet Set Radio and The Wind Waker.</p><div class="cols"><div class="pic"><img src="img/cel-shaded.jpg" alt=""><h3>Timing</h3><p>On twos as the baseline, ones for key action, threes and holds for dialogue.</p><h3>Assets</h3><p>The gradient map is three bytes. Characters need modelling or generated models.</p><h3>Sound</h3><p>Whoosh and impact effects on key poses. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Two or three tone bands with hard edges</li><li>Shadows tinted with colour, not black</li><li>A clean outline</li><li>Flat, detailed backgrounds behind simpler characters</li><li>Limited animation: holds, then sudden moves</li></ul><h3>What makes it look wrong</h3><ul><li>Smooth interpolation at 24 frames a second</li><li>More than three bands</li><li>Shadows that are only a darker grey</li></ul></div><div><h3>How to build it</h3><ul><li>Three.js <code>MeshToonMaterial</code> with a <code>gradientMap</code>: a three-texel <code>DataTexture</code> with <code>NearestFilter</code>, so light snaps to bands</li><li>Outline by inverted hull: a second copy of each mesh, slightly larger, drawn back faces only in black</li><li><code>OutlineEffect</code> and <code>SobelOperatorShader</code> in the three.js examples are the two other routes</li><li>Step the pose time: <code>held(t, 12)</code></li><li>2D: flat SVG shapes, a thick outline, <code>steps()</code> timing</li></ul><p>Use Blender for Freestyle line art and shader-to-RGB ramps on real characters.</p></div></div></div><div class="style"><div class="fam">Drawn and painted · smooth · HyperFrames (DOM, SVG)</div><h2>2D flat vector explainer</h2><p>The plain explainer look: flat fills, a few colours, simple shapes and icons, smooth eased motion. Flat design comes from Swiss style and modernism; in animation its ancestor is the stylised, limited look of the UPA studio.</p><div class="cols"><div class="pic"><img src="img/flat-explainer.jpg" alt=""><h3>Timing</h3><p>Smooth ease-out moves of 0.4 to 0.8 seconds, staggered, with holds long enough to read.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>Soft interface blips, a light bed, voice-led pacing. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Flat fills, three to five colours, one accent</li><li>Geometric shapes with one stroke width</li><li>Plenty of space; one idea per frame</li><li>Clean sans type</li></ul><h3>What makes it look wrong</h3><ul><li>A grid of identical cards</li><li>Gradients and shadows creeping in</li><li>Too much on screen at once</li></ul></div><div><h3>How to build it</h3><ul><li>HTML or SVG with GSAP: this is what HyperFrames is best at</li><li>Stagger related items 0.15 to 0.25 seconds apart</li><li>Draw check marks and connectors on with <code>stroke-dashoffset</code></li><li>Move a highlight instead of cutting</li></ul></div></div></div></section><section id="form-drawn-2"><div class="eyebrow">Drawn and painted<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Drawn and painted · 10 changes a second · HyperFrames (canvas or SVG)</div><h2>Whiteboard and doodle</h2><p>Marker lines that draw themselves on a white board, in the order someone would draw them. The chalkboard is the same recipe, inverted. Also called video scribing. A 2016 study found little evidence that it teaches better than other formats, so use it for its tone, not as a learning trick.</p><div class="cols"><div class="pic"><img src="img/whiteboard.jpg" alt=""><h3>Timing</h3><p>Each element draws on over 0.3 to 1.5 seconds, paced to the narration. The line boils at about 10 changes a second.</p><h3>Assets</h3><p>All in code. A marker or chalk typeface if the system has one.</p><h3>Sound</h3><p>Marker squeak, voice-led. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Black marker lines with a slight wobble</li><li>Strokes appear in drawing order</li><li>One or two accent colours</li><li>Chalk variant: a dark board, dusty broken strokes, a little smudge</li></ul><h3>What makes it look wrong</h3><ul><li>Perfect vector lines</li><li>A hand that covers the drawing</li><li>Paragraphs of text</li></ul></div><div><h3>How to build it</h3><ul><li>Draw-on: a polyline drawn up to a fraction of its length (SVG: <code>stroke-dashoffset</code>)</li><li>Boil: nudge every point by a seeded amount keyed to <code>frameOf(t, 10)</code></li><li>Chalk: three thin passes of the same stroke with different dash patterns at half opacity, over a speckled board</li><li>rough.js (MIT) generates sketchy shapes and hatching to animate afterwards</li></ul></div></div></div><div class="style"><div class="fam">Drawn and painted · 12 changes a second · HyperFrames (canvas or SVG)</div><h2>Watercolour</h2><p>Transparent washes on textured paper: colour that spreads, pools darker at its edge, and lets the paper show through. Pigment in water on paper. Wet-on-wet blends softly; wet-on-dry gives crisp edges.</p><p class="muted small">Sourcing note: The edge-darkening rule is a practice note; the technique sources cover the filter, not the look.</p><div class="cols"><div class="pic"><img src="img/watercolour.jpg" alt=""><h3>Timing</h3><p>Slow. A wash grows over 1 to 3 seconds with an ease-out. Hold drawings at 12 a second for a hand-painted feel.</p><h3>Assets</h3><p>Procedural. A scanned paper texture improves close-ups.</p><h3>Sound</h3><p>Slow, gentle, acoustic. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Transparent colour; overlaps make new colours</li><li>Darker pigment at the edge of each wash</li><li>Irregular, soft outlines</li><li>Paper grain visible everywhere</li><li>Unpainted paper as the highlight</li></ul><h3>What makes it look wrong</h3><ul><li>Opaque flat colour</li><li>A uniform blur, which looks out of focus, not painted</li><li>No paper texture</li></ul></div><div><h3>How to build it</h3><ul><li>Each wash: an irregular closed outline, clipped, filled with a radial gradient that is darkest near the rim</li><li>Layer washes with <code>multiply</code></li><li>Paper grain over everything with <code>multiply</code></li><li>SVG route: low-frequency <code>feTurbulence</code> (0.01 to 0.03) into <code>feDisplacementMap</code> (scale 10 to 25) for bleeding edges</li><li>3D: a Kuwahara filter as a custom pass gives a painterly result; three.js ships none</li></ul></div></div></div></section><section id="form-drawn-4"><div class="eyebrow">Drawn and painted<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Drawn and painted · 12 changes a second · HyperFrames (canvas or SVG)</div><h2>Ink wash (sumi-e)</h2><p>Black ink in every shade from deep black to pale grey, laid down in tapered brush strokes on rice paper, with a great deal left empty. Chinese ink wash painting from the Tang dynasty, carried to Japan by Zen monks. Shanghai Animation Film Studio made ink-wash films from 1960.</p><div class="cols"><div class="pic"><img src="img/ink-wash.jpg" alt=""><h3>Timing</h3><p>Slow and fluid. A stroke accelerates and lifts. On twos.</p><h3>Assets</h3><p>Procedural. Rice-paper grain.</p><h3>Sound</h3><p>Sparse: flute, single plucked notes, silence. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>One ink, many dilutions</li><li>Strokes that taper from thick to a point</li><li>Empty paper as part of the picture</li><li>One small red seal</li><li>Soft grey washes behind sharp strokes</li></ul><h3>What makes it look wrong</h3><ul><li>Pure black on pure white</li><li>Uniform stroke width</li><li>Filling the frame</li></ul></div><div><h3>How to build it</h3><ul><li>A stroke is a row of overlapping dots whose radius tapers along its length, drawn up to a fraction</li><li>Vary each dot's opacity with a seeded hash for a dry-brush break</li><li>Washes: soft radial gradients with <code>multiply</code></li><li>SVG route: variable-width filled paths revealed by a mask</li></ul></div></div></div><div class="style"><div class="fam">Drawn and painted · 10 changes a second · HyperFrames (SVG or canvas)</div><h2>Line art</h2><p>One weight of line on a plain ground, no shading: the drawing draws itself, then quivers slightly as if redrawn each frame. Drawing with line alone, where tone comes only from hatching or stippling.</p><div class="cols"><div class="pic"><img src="img/line-art.jpg" alt=""><h3>Timing</h3><p>Draw-on over 1 to 2 seconds, then a boil at 8 to 12 changes a second.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>A pencil or pen sound under the draw-on. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>A constant or tapered stroke with round ends</li><li>No fills, or one flat tone</li><li>Plenty of empty space</li><li>One accent colour at most</li></ul><h3>What makes it look wrong</h3><ul><li>Jitter so strong the line turns to noise</li><li>Filters that re-run on a large area every frame and slow the render</li></ul></div><div><h3>How to build it</h3><ul><li>Draw-on with <code>stroke-dashoffset</code> (canvas: a polyline to a fraction of its length)</li><li>Boil: a seeded nudge of 1 to 2 px per point, keyed to the frame number</li><li>SVG route: <code>feTurbulence</code> with <code>seed</code> set from the frame number, into <code>feDisplacementMap</code> (scale 1.5 to 3)</li><li><code>vector-effect: non-scaling-stroke</code> keeps the weight when scaled</li></ul></div></div></div></section><section id="form-drawn-6"><div class="eyebrow">Drawn and painted<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Drawn and painted · 12 changes a second · HyperFrames (canvas over video)</div><h2>Rotoscope look</h2><p>Real movement traced by hand: lifelike motion, flat colour fields that drift, and an outline that shimmers. Max Fleischer built the rotoscope. A Scanner Darkly, Waking Life and the a-ha video for Take On Me are the well-known examples.</p><div class="cols"><div class="pic"><img src="img/rotoscope.jpg" alt=""><h3>Timing</h3><p>Every frame or on twos. The boil is keyed to the drawing.</p><h3>Assets</h3><p>Footage you own, or a figure built in code.</p><h3>Sound</h3><p>The original scene audio, or music-led. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Motion with the timing of live action</li><li>Flat or posterised colour fields</li><li>Outlines that change slightly every drawing</li><li>Colour that sits a little off the line</li></ul><h3>What makes it look wrong</h3><ul><li>Edge noise that flickers out of control</li><li>Losing the subject in the treatment</li><li>Tracing footage you have no right to use</li></ul></div><div><h3>How to build it</h3><ul><li>From footage: draw each video frame to a canvas, posterise it, find edges (three.js has <code>SobelOperatorShader</code>), then nudge the edges per drawing</li><li>From code: a figure built from joints, drawn twice: thick flat colour offset by a seeded amount, then a thin outline with its own nudge</li><li>Re-encode source video with a keyframe on every frame so seeking is exact</li></ul><p>Dedicated tools do true painterly rotoscoping better than a browser.</p></div></div></div><div class="style"><div class="fam">Drawn and painted · smooth · HyperFrames (DOM or canvas)</div><h2>Motion comic</h2><p>Comic panels brought to life: layers inside a panel slide at different speeds under a slow camera move, then a hard cut to the next panel. Watchmen: Motion Comic (2008) is the usual first example.</p><p class="muted small">Sourcing note: Pan-and-zoom staging is a practice note; the source describes the format, not the technique.</p><div class="cols"><div class="pic"><img src="img/motion-comic.jpg" alt=""><h3>Timing</h3><p>Slow pushes and pans of 2 to 4 seconds, hard cuts between panels, a pop for a burst.</p><h3>Assets</h3><p>Drawn panels in layers. Artwork needs an illustrator or generated images cut into layers.</p><h3>Sound</h3><p>Voice, music and effects carry it. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Ink outlines, flat colour, halftone shading</li><li>A panel border</li><li>Foreground, figure and background on separate layers</li><li>Bursts and lettering as graphic elements</li></ul><h3>What makes it look wrong</h3><ul><li>A slow zoom on one flat image, which reads as a slideshow</li><li>No separation between figure and background</li></ul></div><div><h3>How to build it</h3><ul><li>Layers in a clipped panel; move far layers less than near ones</li><li>A slow scale from 1 to about 1.07 on the whole panel</li><li>Halftone shading: dots that shrink across the tone</li><li>Cut to the next panel by switching the scene at a time, not by cross-fading</li></ul></div></div></div></section><section id="form-drawn-8"><div class="eyebrow">Drawn and painted<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Drawn and painted · 8 changes a second · HyperFrames (canvas, SVG)</div><h2>UPA and mid-century modern</h2><p>Flat, stylised design from 1950s cartoons: geometric characters, abstract backgrounds, colour printed slightly off its outline, and very few drawings. United Productions of America turned away from Disney realism and made limited animation a style. Gerald McBoing-Boing won an Academy Award in 1950.</p><div class="cols"><div class="pic"><img src="img/upa-midcentury.jpg" alt=""><h3>Timing</h3><p>Limited animation: a pose is held, then pops to the next. Eight or fewer changes a second.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>Jazz combo, sound effects as music. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Characters built from triangles, circles and lines</li><li>Flat colour blocks that do not meet their outlines</li><li>Abstract backgrounds: a few shapes, no perspective</li><li>A warm, muted palette</li></ul><h3>What makes it look wrong</h3><ul><li>Smooth, fluid motion</li><li>Gradients and realistic light</li></ul></div><div><h3>How to build it</h3><ul><li>Flat shapes; draw the outline 6 to 9 px away from the fill</li><li>Two or three poses, switched on a frame count with no in-betweens</li><li>Paper grain with <code>multiply</code></li></ul></div></div></div><div class="style"><div class="fam">Drawn and painted · 12 changes a second · HyperFrames (canvas, SVG)</div><h2>Rubber-hose cartoon</h2><p>The 1920s cartoon: limbs like hoses with no elbows or knees, round bodies that bounce to the music, black and white film. Credited to Bill Nolan on Felix the Cat. The Fleischer studio kept it longest; Cuphead revived it.</p><div class="cols"><div class="pic"><img src="img/rubber-hose.jpg" alt=""><h3>Timing</h3><p>Bouncy loops locked to the music, on twos, with squash and stretch.</p><h3>Assets</h3><p>All in code. Original characters only.</p><h3>Sound</h3><p>Hot jazz, slide whistles, effects on every bounce. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Curved tubular limbs</li><li>Round forms</li><li>Black and white or sepia, high contrast</li><li>Film grain, scratches and a frame that weaves slightly</li><li>Everything moves to the beat</li></ul><h3>What makes it look wrong</h3><ul><li>Stiff jointed limbs</li><li>Clean modern gradients</li><li>Copying characters that are still under copyright</li></ul></div><div><h3>How to build it</h3><ul><li>A limb is a quadratic curve between two points; move the control point to bend it</li><li>Squash and stretch: scale the body on one axis by the inverse of the other</li><li>Grain: cycle a few noise tiles by frame; gate weave: shift the whole picture by a seeded pixel or two</li><li>Sepia with <code>feColorMatrix</code> if wanted</li></ul></div></div></div></section><section id="form-drawn-10"><div class="eyebrow">Drawn and painted<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Drawn and painted · 8 changes a second · HyperFrames (canvas, SVG)</div><h2>Linocut and woodcut print</h2><p>A relief print: bold flat shapes in one to three inks, with white gouge marks where the block was carved. Carved in linoleum or wood; the uncut surface prints. Each colour is a separate block.</p><p class="muted small">Sourcing note: The source covers the technique; the visual rules are practice notes.</p><div class="cols"><div class="pic"><img src="img/linocut.jpg" alt=""><h3>Timing</h3><p>Each colour arrives as a pull, top to bottom, then holds. On twos or slower.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>A roller, a press, paper lifting. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Bold shapes, no fine detail</li><li>Short white cut marks inside the ink, all leaning one way</li><li>One to three inks, laid slightly off register</li><li>Paper showing at the edges</li></ul><h3>What makes it look wrong</h3><ul><li>Gradients</li><li>Thin delicate lines</li><li>Too many colours</li></ul></div><div><h3>How to build it</h3><ul><li>Draw each block to its own canvas, then cut marks out of it: short strokes with <code>destination-out</code></li><li>Print blocks over each other with <code>multiply</code>, the second one offset a few pixels</li><li>Reveal a block by widening a clip from the top</li><li>SVG route: <code>feTurbulence</code> through a hard threshold makes rough voids</li></ul></div></div></div></section><section id="form-geometry-0"><div class="eyebrow">Geometry, pixels and 3D<span>brief2mp4 art forms</span></div><h1>Geometry, pixels and 3D</h1><p class="lead">Looks built from blocks, facets and pixels, and the clean studio shot.</p><div class="style"><div class="fam">Geometry, pixels and 3D · smooth · HyperFrames (canvas, SVG) or Three.js</div><h2>Isometric</h2><p>A parallel projection seen from above at an angle: no perspective, three visible faces per block, a tidy model world. A technical drawing projection. Games use a 2:1 pixel slope, about 26.6 degrees, which is strictly dimetric.</p><div class="cols"><div class="pic"><img src="img/isometric.jpg" alt=""><h3>Timing</h3><p>The camera does not orbit. Objects drop, stack and slide along the three axes, staggered by grid position.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>Soft clicks as pieces land. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>No perspective: parallel lines stay parallel</li><li>Three tones per object: top lightest, one side mid, one side darkest</li><li>One light direction for everything</li><li>A grid floor</li></ul><h3>What makes it look wrong</h3><ul><li>A perspective camera by accident</li><li>Shadows that disagree with the light</li><li>Uneven block heights</li></ul></div><div><h3>How to build it</h3><ul><li>2D: <code>x = (gx - gy) * s</code>, <code>y = (gx + gy) * s / 2 - gz * s</code>; draw the two side faces, then the top</li><li>Sort by <code>gx + gy</code>, then by height, so nearer cubes cover farther ones</li><li>Three.js: an <code>OrthographicCamera</code> placed at equal x, y and z looking at the origin</li><li>CSS: <code>rotateX(60deg) rotateZ(-45deg)</code> on a flat layer</li></ul><p>Use Blender for bevelled, ambient-occluded isometric scenes.</p></div></div></div><div class="style"><div class="fam">Geometry, pixels and 3D · smooth · Three.js inside HyperFrames</div><h2>Low-poly 3D</h2><p>Meshes with few polygons, each face lit as one flat facet. A hardware limit that became a style. From the era of early 3D consoles; chosen on purpose since about 2013.</p><div class="cols"><div class="pic"><img src="img/low-poly.jpg" alt=""><h3>Timing</h3><p>Clean, so smooth: slow eased orbits and dollies at the full frame rate.</p><h3>Assets</h3><p>Geometry in code for landscapes and props. Characters need modelling.</p><h3>Sound</h3><p>Calm, spacious. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Visible facets, flat shaded</li><li>A limited, saturated palette</li><li>Simple lighting and a gradient or flat sky</li><li>Chunky silhouettes</li></ul><h3>What makes it look wrong</h3><ul><li>Smooth normals, which erase the facets</li><li>Detailed textures that fight the flat colour</li></ul></div><div><h3>How to build it</h3><ul><li>Low segment counts and <code>flatShading: true</code> on <code>MeshStandardMaterial</code></li><li>Displace a plane's vertices with a seeded hash for terrain, then <code>computeVertexNormals()</code></li><li>A hemisphere light plus one directional key; fog in the sky colour for depth</li><li>Camera position from <code>t</code> directly</li></ul><p>Use Blender for modelling and baked light.</p></div></div></div></section><section id="form-geometry-2"><div class="eyebrow">Geometry, pixels and 3D<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Geometry, pixels and 3D · 12 changes a second · Three.js inside HyperFrames</div><h2>Voxel</h2><p>Everything built from cubes of one size on a grid, like a three-dimensional pixel picture. A voxel is a value on a 3D grid. Minecraft made the look familiar.</p><div class="cols"><div class="pic"><img src="img/voxel.jpg" alt=""><h3>Timing</h3><p>On twos. Things appear cube by cube or layer by layer; moves snap to the grid.</p><h3>Assets</h3><p>Models as arrays in code, or made with a voxel editor.</p><h3>Sound</h3><p>Blocky, percussive, chiptune. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>One cube size, integer positions</li><li>Each face one flat tone</li><li>A small palette</li><li>Small floating scenes</li></ul><h3>What makes it look wrong</h3><ul><li>Cubes at non-integer positions</li><li>Faces flickering where cubes touch at full size</li></ul></div><div><h3>How to build it</h3><ul><li>One <code>InstancedMesh</code> of a box for all the cubes: one draw call</li><li>Set each cube's matrix from stepped time; hide a cube by scaling it to nothing</li><li>Cubes slightly under size (0.96) so the seams read</li><li><code>MeshLambertMaterial</code> and a hemisphere light</li></ul></div></div></div><div class="style"><div class="fam">Geometry, pixels and 3D · 8 changes a second · HyperFrames (canvas)</div><h2>Pixel art</h2><p>A tiny picture placed pixel by pixel and scaled up with hard edges: a few colours, no blur, sprites that step. From early video games; the term dates from 1982.</p><div class="cols"><div class="pic"><img src="img/pixel-art.jpg" alt=""><h3>Timing</h3><p>Walk cycles of 4 to 8 frames at about 8 a second. Scrolling moves in whole pixels.</p><h3>Assets</h3><p>Sprites as data in code, or drawn in a pixel editor.</p><h3>Sound</h3><p>Chiptune. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>A small canvas scaled by a whole number</li><li>A limited palette, often 8 to 32 colours</li><li>No anti-aliasing, no soft gradients</li><li>Sprites animate in a few frames</li></ul><h3>What makes it look wrong</h3><ul><li>Scaling by a fraction</li><li>Mixed pixel sizes on one screen</li><li>Smooth vector edges or too many colours</li></ul></div><div><h3>How to build it</h3><ul><li>Draw on a small canvas (160 by 90), then <code>drawImage</code> it up with <code>imageSmoothingEnabled = false</code></li><li>CSS: <code>image-rendering: pixelated</code> on an upscaled canvas</li><li>Sprites as arrays of palette indexes</li><li>Three.js: <code>RenderPixelatedPass</code> renders a 3D scene to low resolution with nearest filtering</li></ul></div></div></div></section><section id="form-geometry-4"><div class="eyebrow">Geometry, pixels and 3D<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Geometry, pixels and 3D · smooth · Three.js, the 3D pack, or Blender</div><h2>3D product render</h2><p>A studio shot of an object: a seamless backdrop, soft key, fill and rim lights, controlled reflections, a slow turn. Product photography lighting, done in 3D.</p><p class="muted small">Sourcing note: The lighting source is about photography; applying it to rendering is a practice note.</p><div class="cols"><div class="pic"><img src="img/product-render.jpg" alt=""><h3>Timing</h3><p>Smooth and slow at the full frame rate. The opposite of the handmade looks.</p><h3>Assets</h3><p>A model of the product: built in code, made with the 3D pack, or supplied.</p><h3>Sound</h3><p>Minimal: a low bed and one accent on the reveal. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>A seamless backdrop</li><li>Key light to one side and above, a softer fill opposite, a rim light behind</li><li>A contact shadow under the object</li><li>True materials: gloss, metal, glass</li><li>One slow move</li></ul><h3>What makes it look wrong</h3><ul><li>No reflections, so it looks like plastic</li><li>One harsh light</li><li>An object floating with no shadow</li></ul></div><div><h3>How to build it</h3><ul><li><code>MeshPhysicalMaterial</code> with <code>clearcoat</code> for lacquer, <code>metalness: 1</code> for metal</li><li>Three directional lights in the key, fill and rim positions, plus a hemisphere light</li><li>Contact shadow: a plane with a radial-gradient texture, <code>depthWrite: false</code></li><li>Rotation from <code>t</code> directly; ease the camera, not the turntable</li></ul><p>Use Blender when the brief asks for photoreal glass, caustics or depth of field.</p></div></div></div></section><section id="form-type-0"><div class="eyebrow">Type, data and retro<span>brief2mp4 art forms</span></div><h1>Type, data and retro</h1><p class="lead">Looks where words, numbers or the recording medium are the picture.</p><div class="style"><div class="fam">Type, data and retro · smooth · HyperFrames (DOM)</div><h2>Kinetic typography</h2><p>Moving words as the whole picture: scale, weight and timing carry the meaning. Saul Bass's title sequences for North by Northwest (1959) and Psycho (1960) made it a form.</p><div class="cols"><div class="pic"><img src="img/kinetic-type.jpg" alt=""><h3>Timing</h3><p>Each word lands in 0.3 to 0.5 seconds with a small overshoot, then the line holds long enough to read.</p><h3>Assets</h3><p>A typeface with enough weights. No pictures.</p><h3>Sound</h3><p>Cut to the voice or the beat. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Type is the image; nothing competes with it</li><li>Strong contrast of size and weight</li><li>Words arrive in reading order, on the beat</li><li>One idea per frame</li></ul><h3>What makes it look wrong</h3><ul><li>Words faster than they can be read</li><li>Effects that add no meaning</li><li>Everything moving at once</li></ul></div><div><h3>How to build it</h3><ul><li>HyperFrames: split text into inline-block spans and stagger with GSAP</li><li>Canvas: <code>fillText</code> with a transform per word</li><li>Timing from the narration: one start time per word</li><li>Hold for (words / 3) + 0.5 seconds before the next line</li></ul></div></div></div><div class="style"><div class="fam">Type, data and retro · smooth · HyperFrames (SVG, canvas)</div><h2>Infographic and data animation</h2><p>A chart that builds in a sensible order: axes, then the data from an honest baseline, then the exact values. From Playfair's first charts in 1786 to animated infographics in music videos in 2002.</p><div class="cols"><div class="pic"><img src="img/infographic.jpg" alt=""><h3>Timing</h3><p>Axes in about half a second, each series over 0.8 to 1.5 seconds with an ease-out, then a hold to read.</p><h3>Assets</h3><p>The data, with its source.</p><h3>Sound</h3><p>A tick or tone per value, a bed that stays out of the way. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>One chart type that fits the data</li><li>Direct labels, not a legend</li><li>An honest axis: bars start at zero</li><li>One colour for the point being made</li></ul><h3>What makes it look wrong</h3><ul><li>Numbers that were not checked</li><li>3D bars</li><li>An axis cut off to exaggerate a difference</li></ul></div><div><h3>How to build it</h3><ul><li>Drive the chart from one time value; never use a chart library's own transitions</li><li>Bars grow from the baseline; counters show the rounded value as it grows and end on the exact figure</li><li>SVG or canvas with scale maths; D3 scales are enough</li><li>Every number needs a source in the brief</li></ul></div></div></div></section><section id="form-type-2"><div class="eyebrow">Type, data and retro<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Type, data and retro · smooth · HyperFrames (DOM, canvas)</div><h2>Lyric video</h2><p>The words of a song as the main image, each line timed to the vocal and the active word lit. Lyric text appears in music videos from the 1980s; the format took off on video sites in the 2010s.</p><div class="cols"><div class="pic"><img src="img/lyric-video.jpg" alt=""><h3>Timing</h3><p>Locked to the music. A word changes exactly on its beat; a few frames late is visible.</p><h3>Assets</h3><p>The audio, with the right to use it, and its word timings.</p><h3>Sound</h3><p>The song.</p></div><div><h3>What makes it read as this</h3><ul><li>Three to eight words on screen</li><li>The word being sung is brighter or larger</li><li>A background that never fights the text</li><li>One typographic system for the whole song</li></ul><h3>What makes it look wrong</h3><ul><li>Timing that drifts</li><li>Text over a busy background</li><li>Music you have no licence for</li></ul></div><div><h3>How to build it</h3><ul><li>Word start times from forced alignment or a beat grid</li><li>Compute the active line and word from <code>t</code></li><li>A pulse from the beat phase: <code>1 - (beat % 1)</code> drives scale and background</li><li>Measure words first so the line is centred</li></ul></div></div></div><div class="style"><div class="fam">Type, data and retro · 30 changes a second · HyperFrames (canvas) or Three.js post-processing</div><h2>VHS and glitch</h2><p>The damage of old tape and broken data: colour that bleeds sideways, scan lines, a band of noise at the bottom, sudden torn slices. VHS records colour at far lower resolution than brightness, which is why colour smears. Glitch art uses such errors on purpose.</p><div class="cols"><div class="pic"><img src="img/vhs-glitch.jpg" alt=""><h3>Timing</h3><p>Full frame rate, with bursts of a fifth of a second. Seeds come from the frame number so every render matches.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>Tape hiss, hum, a click on each burst. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>Colour offset from brightness by a few pixels and softer</li><li>Scan lines</li><li>A tracking band of noise near the bottom</li><li>A date stamp in a blocky face</li><li>Glitch: slices displaced sideways, in short bursts</li></ul><h3>What makes it look wrong</h3><ul><li>Constant glitching, which tires the eye</li><li>Glitching text the viewer has to read</li><li>Unseeded randomness, so two renders differ</li></ul></div><div><h3>How to build it</h3><ul><li>Draw the clean frame to its own canvas first, then the damage on top</li><li>Redraw it in thin horizontal strips with a per-strip offset; large offsets only during a burst</li><li>Chroma bleed: a blurred copy drawn again a few pixels to the side with <code>screen</code></li><li>Scan lines: a dark row every third pixel</li><li>Three.js: <code>FilmPass</code>, <code>RGBShiftShader</code> and <code>GlitchPass</code> exist; <code>GlitchPass</code> picks its own random timing, so check it repeats before relying on it</li></ul></div></div></div></section><section id="form-type-4"><div class="eyebrow">Type, data and retro<span>brief2mp4 art forms</span></div><div class="style"><div class="fam">Type, data and retro · smooth · HyperFrames (SVG, canvas)</div><h2>Blueprint and technical drawing</h2><p>White lines on blue: a grid, an object drawn in outline, centre lines, dimensions and a title block. The blueprint is a cyanotype copy of an engineering drawing, introduced in 1842: white lines on blue.</p><div class="cols"><div class="pic"><img src="img/blueprint.jpg" alt=""><h3>Timing</h3><p>Steady: lines draw on, then dimensions and labels fade in. No bounce.</p><h3>Assets</h3><p>All in code.</p><h3>Sound</h3><p>A pen plotter, a pencil. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>White or pale lines on a deep blue</li><li>A faint grid</li><li>Dashed centre lines, dimension lines with end ticks</li><li>A title block in a monospace face</li></ul><h3>What makes it look wrong</h3><ul><li>A neon blue</li><li>Labels that say nothing</li><li>Perspective in the drawing</li></ul></div><div><h3>How to build it</h3><ul><li>Grid: thin lines every 30 px at low opacity (CSS: <code>repeating-linear-gradient</code>)</li><li>Draw-on with <code>stroke-dashoffset</code> or a partial polyline</li><li>Dashed centre lines with <code>setLineDash</code></li><li>Dimension lines: a line, two end ticks and a centred label</li></ul></div></div></div><div class="style"><div class="fam">Type, data and retro · 24 changes a second · HyperFrames (canvas, SVG)</div><h2>Neon sign</h2><p>Glass tubes bent into letters and lit: a bright core, a coloured glow, a dark wall, tubes that light one by one and sometimes flicker. Glass tubing filled with gas and lit by electrodes; sections can be switched in sequence.</p><div class="cols"><div class="pic"><img src="img/neon-sign.jpg" alt=""><h3>Timing</h3><p>Tubes come on in order with a short stutter each; now and then one dims for a frame.</p><h3>Assets</h3><p>Letter paths in code. A brick or plaster texture can be drawn.</p><h3>Sound</h3><p>A low electrical hum, a tick as each tube lights. Practice note.</p></div><div><h3>What makes it read as this</h3><ul><li>One continuous line per letter, one width</li><li>A white-hot core inside a coloured halo</li><li>A dark wall behind</li><li>Letters light in sequence</li></ul><h3>What makes it look wrong</h3><ul><li>A glow so wide the word cannot be read</li><li>Filled letters instead of a single tube</li><li>Flicker that differs between renders</li></ul></div><div><h3>How to build it</h3><ul><li>Each tube is drawn three times: a wide faint stroke, a medium one, a thin white core, all with <code>shadowBlur</code></li><li>Add them with the <code>lighter</code> blend (CSS: <code>mix-blend-mode: plus-lighter</code> or <code>screen</code>)</li><li>Flicker from <code>hash(frame, tube)</code>, never from a random call</li><li>Three.js: <code>UnrealBloomPass</code> for bloom on emissive geometry</li></ul></div></div></div></section><section id="tools"><div class="eyebrow">Reference<span>brief2mp4 art forms</span></div><h1>Tools that exist, by name</h1><table><col style="width:18%"><col style="width:40%"><col style="width:42%"><thead><tr><th>Where</th><th>What</th><th>Used for</th></tr></thead><tbody><tr><td>SVG filter</td><td><code>feTurbulence</code></td><td>noise: grain, the source for every rough edge</td></tr><tr><td>SVG filter</td><td><code>feDisplacementMap</code></td><td>bend a shape by that noise: cut edges, line boil, ink bleed</td></tr><tr><td>SVG filter</td><td><code>feMorphology</code></td><td>thicken or thin: outlines</td></tr><tr><td>SVG filter</td><td><code>feColorMatrix</code>, <code>feComponentTransfer</code></td><td>recolour, threshold, separate one ink, sepia</td></tr><tr><td>CSS</td><td><code>steps()</code></td><td>held drawings in a CSS animation</td></tr><tr><td>CSS</td><td><code>mix-blend-mode: multiply</code></td><td>ink printed over ink, paper grain over everything</td></tr><tr><td>CSS</td><td><code>mix-blend-mode: screen</code>, <code>plus-lighter</code></td><td>glow that adds up: neon, chroma bleed</td></tr><tr><td>CSS</td><td><code>image-rendering: pixelated</code></td><td>pixel art scaled with hard edges</td></tr><tr><td>Canvas</td><td><code>globalCompositeOperation</code></td><td>the same blends on a canvas, and <code>destination-out</code> to cut marks out of a shape</td></tr><tr><td>Canvas</td><td><code>fill("evenodd")</code></td><td>holes that are part of a figure: shadow puppets</td></tr><tr><td>GSAP</td><td><code>ease: "steps(n)"</code></td><td>held drawings in a tween</td></tr><tr><td>Three.js</td><td><code>MeshToonMaterial</code> with a <code>gradientMap</code></td><td>light in hard bands: cel shading</td></tr><tr><td>Three.js</td><td>a second mesh, larger, back faces only</td><td>an outline (the inverted hull); <code>OutlineEffect</code> packages it</td></tr><tr><td>Three.js</td><td><code>flatShading: true</code></td><td>low-poly facets</td></tr><tr><td>Three.js</td><td><code>InstancedMesh</code></td><td>thousands of voxels in one draw call</td></tr><tr><td>Three.js examples</td><td><code>HalftonePass</code>, <code>RenderPixelatedPass</code>, <code>FilmPass</code>, <code>RGBShiftShader</code>, <code>GlitchPass</code>, <code>UnrealBloomPass</code></td><td>post-processing for print, pixel, tape and glow looks</td></tr></tbody></table><p>Three.js ships no watercolour pass and no VHS pass: both are built from the pieces above. Its <code>GlitchPass</code> chooses its own random timing, so check that it repeats before relying on it in a render.</p><h2>When Blender is the better tool</h2><ul><li>Claymation: Use Blender when the clay needs real subsurface scattering, soft area-light shadows or sculpted detail.</li><li>Paper cut-out: Use Blender for real folded paper with thickness and light passing through it.</li><li>Felt and fabric craft: Use Blender hair or fur for real fibre fuzz on 3D figures.</li><li>Origami: Use Blender when the paper has to bend or show thickness.</li><li>Shadow puppetry: Use Blender for real light through translucent coloured leather.</li><li>Anime and cel shading: Use Blender for Freestyle line art and shader-to-RGB ramps on real characters.</li><li>Rotoscope look: Dedicated tools do true painterly rotoscoping better than a browser.</li><li>Isometric: Use Blender for bevelled, ambient-occluded isometric scenes.</li><li>Low-poly 3D: Use Blender for modelling and baked light.</li><li>3D product render: Use Blender when the brief asks for photoreal glass, caustics or depth of field.</li></ul><h2>Wiring a look into a composition</h2><pre><code>const clock = { t: 0 };+const tl = gsap.timeline({ paused: true });+tl.to(clock, { t: DURATION, duration: DURATION, ease: "none", onUpdate: () => draw(clock.t) }, 0);+window.__timelines = window.__timelines || {};+window.__timelines["main"] = tl;+draw(0);</code></pre><p>GSAP owns the clock and the look only draws. Vendor GSAP and Three.js into the project so a render never touches the network.</p></section><section id="sources"><div class="eyebrow">Reference<span>brief2mp4 art forms</span></div><h1>Sources and what was verified</h1><p class="lead">What this guide rests on, and where its limits are.</p><h2>Verified by running it</h2><ul><li>All 31 demos pass the browser test: each paints, changes over time and repeats exactly.</li><li>The source of the demos contains no clock, timer or unseeded random call; a test enforces it.</li><li>The router and the generated reference pages have unit tests.</li></ul><h2>Not verified</h2><ul><li>No art-form video was rendered through HyperFrames. The demos follow its rules and were tested as browser pictures.</li><li>Tested on macOS with Chrome 157 only.</li><li>Frame-rate conventions come from encyclopaedia articles, not from studio production notes.</li><li>Lines marked "practice note" in the reference pages (most sound and pacing advice, some visual rules) are working advice, not sourced facts.</li><li>Entries with a sourcing note are thinner than the rest: Felt and fabric craft, Watercolour, Motion comic, Linocut and woodcut print, 3D product render.</li></ul><h2>Published sources</h2><p class="src">https://en.wikipedia.org/wiki/Clay_animation<br>https://en.wikipedia.org/wiki/Stop_motion<br>https://gsap.com/docs/v3/Eases/SteppedEase/<br>https://en.wikipedia.org/wiki/Cutout_animation<br>https://en.wikipedia.org/wiki/Lotte_Reiniger<br>https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feDisplacementMap<br>https://en.wikipedia.org/wiki/Needle_felting<br>https://en.wikipedia.org/wiki/Origami<br>https://github.com/amandaghassaei/OrigamiSimulator<br>https://en.wikipedia.org/wiki/Shadow_play<br>https://en.wikipedia.org/wiki/Ravana_Chhaya<br>https://en.wikipedia.org/wiki/Collage<br>https://en.wikipedia.org/wiki/Risograph<br>https://en.wikipedia.org/wiki/Halftone<br>https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode<br>https://en.wikipedia.org/wiki/Cel_shading<br>https://en.wikipedia.org/wiki/Limited_animation<br>https://github.com/mrdoob/three.js<br>https://en.wikipedia.org/wiki/Flat_design<br>https://en.wikipedia.org/wiki/United_Productions_of_America<br>https://en.wikipedia.org/wiki/Whiteboard_animation<br>https://github.com/rough-stuff/rough<br>https://en.wikipedia.org/wiki/Watercolor_painting<br>https://blog.maximeheckel.com/posts/on-crafting-painterly-shaders<br>https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feTurbulence<br>https://en.wikipedia.org/wiki/Ink_wash_painting<br>https://en.wikipedia.org/wiki/Shanghai_Animation_Film_Studio<br>https://en.wikipedia.org/wiki/Line_art<br>https://camillovisini.com/coding/simulating-hand-drawn-motion-with-svg-filters<br>https://en.wikipedia.org/wiki/Rotoscoping<br>https://en.wikipedia.org/wiki/Motion_comic<br>https://en.wikipedia.org/wiki/Rubber_hose_animation<br>https://en.wikipedia.org/wiki/Linocut<br>https://en.wikipedia.org/wiki/Isometric_video_game_graphics<br>https://en.wikipedia.org/wiki/Low_poly<br>https://en.wikipedia.org/wiki/Voxel<br>https://github.com/danielesteban/cubitos<br>https://en.wikipedia.org/wiki/Pixel_art<br>https://developer.mozilla.org/en-US/docs/Web/CSS/image-rendering<br>https://en.wikipedia.org/wiki/Three-point_lighting<br>https://en.wikipedia.org/wiki/Kinetic_typography<br>https://en.wikipedia.org/wiki/Infographic<br>https://en.wikipedia.org/wiki/Lyric_video<br>https://en.wikipedia.org/wiki/VHS<br>https://en.wikipedia.org/wiki/Glitch_art<br>https://en.wikipedia.org/wiki/Blueprint<br>https://en.wikipedia.org/wiki/Neon_sign</p><p>The repositories studied for techniques, with their licences, are listed in the changelog entry and in the project notes. No code from another project is copied into brief2mp4 for this work. Facts were checked on 17 November 2026.</p></section></body></html>\ No newline at end of filediff --git a/docs/art-forms-guide/brief2mp4-art-forms.pdf b/docs/art-forms-guide/brief2mp4-art-forms.pdfnew file mode 100644index 0000000..b32d647Binary files /dev/null and b/docs/art-forms-guide/brief2mp4-art-forms.pdf differdiff --git a/docs/art-forms-guide/build.py b/docs/art-forms-guide/build.pynew file mode 100644index 0000000..9e461ee--- /dev/null+++ b/docs/art-forms-guide/build.py@@ -0,0 +1,211 @@+#!/usr/bin/env python3+"""build.py: assemble the brief2mp4 art-forms guide as one HTML file (brief2mp4-art-forms.html) and a plain-text+copy of its prose (guide-prose.txt). render.py turns the HTML into the PDF.++Every art-form page is generated from plugin/skills/brief2mp4/references/art-forms.json, so the guide cannot drift+from the skill. Edit the prose here, the look in guide.css.++ python3 docs/art-forms-guide/build.py+"""+import html+import json+import re+from pathlib import Path++HERE = Path(__file__).resolve().parent+REPO = HERE.parent.parent+SKILL = REPO / 'plugin' / 'skills' / 'brief2mp4'+DATA = json.loads((SKILL / 'references' / 'art-forms.json').read_text())+FORMS = DATA['forms']+E = html.escape+++def inline(t):+ t = E(t)+ t = re.sub(r'`([^`]+)`', r'<code>\1</code>', t)+ return re.sub(r'\*\*([^*]+)\*\*', r'<b>\1</b>', t)+++def p(*paras):+ return ''.join('<p>%s</p>' % inline(x) for x in paras)+++def ul(items):+ return '<ul>' + ''.join('<li>%s</li>' % inline(x) for x in items) + '</ul>'+++def table(head, rows, widths):+ return ('<table>' + ''.join('<col style="width:%s">' % w for w in widths) + '<thead><tr>' + ''.join('<th>%s</th>' % inline(c) for c in head)+ + '</tr></thead><tbody>' + ''.join('<tr>' + ''.join('<td>%s</td>' % inline(c) for c in r) + '</tr>' for r in rows) + '</tbody></table>')+++def code(t):+ return '<pre><code>%s</code></pre>' % E(t.strip('\n'))+++def note(title, text):+ return '<aside><b>%s</b>%s</aside>' % (inline(title), p(text))+++def cadence(f):+ return '%d changes a second' % f['fps'] if f['fps'] else 'smooth'+++SECTIONS = []+++def section(sid, title, eyebrow, body, toc=True):+ SECTIONS.append((sid, title, eyebrow, body, toc))+++section('what', 'A look is a set of rules', 'Orientation', '<p class="lead">%s</p>' % inline(+ 'Ask for "claymation" or "a paper cut-out" and you are asking for a short list of things: how edges look, how light falls, how often the picture changes. '+ 'This guide writes those lists down for %d art forms, and shows how to build each one in code that renders the same way every time.' % len(FORMS)) + p(+ 'It is a companion to brief2mp4, the skill that turns a written brief into a finished, checked MP4. The skill builds video from web pages: HTML, CSS and GSAP in HyperFrames, '+ 'canvas, SVG and Three.js. Every art form here has a reference page in the skill and a small demo that is tested in a real browser.') + '<figure><img src="../../assets/art-forms.jpg" alt=""><figcaption>One frame from each of the 31 demos, drawn by the test that checks them.</figcaption></figure>' + table(+ ['Family', 'Art forms'], [[DATA['families'][k], ', '.join(f['name'] for f in FORMS if f['family'] == k)] for k in DATA['families']], ['24%', '76%']) + note(+ 'What the demos are', 'Small pictures that prove a technique: a few seconds, 960 by 540, drawn on a canvas or with Three.js. They are starting points for a scene, not finished films. '+ 'No art-form video was rendered through HyperFrames for this guide.'))++section('rules', 'Three rules behind every look', 'The method', '<p class="lead">%s</p>' % inline(+ 'A renderer that works frame by frame asks for frame 212, then frame 213, sometimes out of order and on several workers. Three rules make any look survive that.') + '<h2>1. The picture is a function of time</h2>' + p(+ 'No clock, no timers, no `Math.random()`. Whatever is on screen at second 4.2 must depend on the number 4.2 and nothing else. Randomness comes from a hash of the frame number or of a position, so it is the same on every run.') + code('''+export function hash(a, b = 0, c = 0) { // a repeatable number in 0..1 from up to three integers+ let n = (Math.imul(a | 0, 374761393) + Math.imul(b | 0, 668265263) + Math.imul(c | 0, 2147483647)) | 0;+ n = Math.imul(n ^ (n >>> 13), 1274126177);+ return ((n ^ (n >>> 16)) >>> 0) / 4294967295;+}''') + '<h2>2. Handmade looks hold their drawings</h2>' + p(+ 'Film runs at 24 frames a second, but clay, paper and hand-drawn animation are usually shot "on twos": each pose is held for two frames, so the picture changes about 12 times a second. '+ 'That stepping is most of what makes them read as handmade. Quantise time before posing anything, and leave the video itself at 24 or 30.') + code('''+export const frameOf = (t, fps) => Math.floor(t * fps + 1e-6); // which drawing we are on+export const held = (t, fps) => frameOf(t, fps) / fps; // time, quantised+const ts = held(t, 12); // "on twos"+// in GSAP the same idea for one tween: gsap.to(el, { x: 400, duration: 1, ease: "steps(12)" })''') + p(+ 'Clean looks are the opposite: a flat explainer, a low-poly scene, a product render and kinetic type stay smooth at the full frame rate.') + '<h2>3. Imperfection is seeded</h2>' + p(+ 'Line boil, paper jitter, lamp flicker, misregistered ink and tape damage all come from one line: a small nudge keyed to the drawing number.') + code('''+export const jit = (frame, i, amount) => (hash(frame, i, 7) - 0.5) * 2 * amount;+const f = frameOf(t, 12);+x += jit(f, partIndex, 1.2); // this part sits 1.2 px off, differently on each drawing, identically on each render''') + note(+ 'The usual web recipe breaks rule 1', 'Most tutorials make a hand-drawn line wobble with a timer that re-rolls an SVG filter every 100 milliseconds. A frame-by-frame renderer has no such timer. '+ 'Key the change to the frame number instead, and the wobble is part of the frame.') + '<h2>How the demos are checked</h2>' + p(+ 'A test draws every look in headless Chrome at three moments. The three pictures must differ, none may be blank, and the middle one, drawn a second time after the others, must match itself pixel for pixel. '+ 'A second test reads the source and fails if a clock, a timer or `Math.random` appears anywhere in it.'))++section('choose', 'Choosing a look from a brief', 'The method', '<p class="lead">%s</p>' % inline(+ 'If the brief names a look, use it. If it does not, the subject and the mood usually point to one.') + table(['The brief is about', 'Try', 'Why'], [+ ['children, family, a gentle story', 'paper cut-out, claymation, felt', 'handmade textures feel warm and safe'],+ ['a folk tale, a myth, heritage', 'shadow puppetry, linocut, ink wash', 'the form carries the tradition; check the iconography with a source'],+ ['explaining a product or a process', 'flat vector explainer, isometric, whiteboard', 'clean shapes keep attention on the idea'],+ ['numbers', 'infographic', 'the chart is the picture; every number needs a source'],+ ['a song or a quote', 'lyric video, kinetic typography', 'the words are the content'],+ ['a physical product', '3D product render; claymation for a playful take', 'the object is the hero'],+ ['nostalgia', 'VHS and glitch, pixel art, rubber-hose, UPA mid-century', 'each one is a decade'],+ ['calm, reflective', 'watercolour, ink wash, line art', 'slow, sparse, quiet'],+ ['loud, independent', 'risograph, collage, motion comic', 'print energy and hard cuts'],+ ], ['30%', '34%', '36%']) + code('''+$ python3 plugin/skills/brief2mp4/scripts/art_route.py BRIEF.md+Art form: Shadow puppetry (inferred)+ why: a traditional story: the form carries the tradition ("ramayana")+ cadence: steps 12 times a second+ usual tool: HyperFrames (canvas or SVG)+ note: Use Blender for real light through translucent coloured leather.+ or: Linocut and woodcut print, Ink wash (sumi-e)+ read: references/art-forms/shadow-puppet.md''') + p(+ 'The router is a keyword scorer, not a judge. One stray word is never enough ("paper" in "paper plane" does not choose paper cut-out), and when nothing fits it says so. '+ 'An art form sets the look and the timing; the kind of video (explainer, Short, launch) still sets the beats.') + '<h2>Writing the look into the brief</h2>' + p(+ 'A look becomes checkable when the brief says what should be visible. Two lines are enough:') + code('''+Look: paper cut-out. Flat layers with a small shadow under each, edges that look cut by hand, paper grain.+Done when: at 4.0 s the frame shows at least three paper layers with shadows; the bird's wings+ change at most 12 times a second; nothing moves between drawings.''') + '<h2>Assets</h2>' + p(+ 'Most looks here need no pictures at all: shapes, textures and grain are drawn in code. Where a look needs photographs, footage, a character model or music, use only what you own or may reuse. '+ 'If you have an image model, it can generate textures and cut-out parts; say in the report that they were generated.'))+++def form_block(f):+ img = '<img src="img/%s.jpg" alt="">' % f['looks'][0]+ left = '<div class="pic">%s<h3>Timing</h3><p>%s</p><h3>Assets</h3><p>%s</p><h3>Sound</h3><p>%s</p></div>' % (img, inline(f['timing']), inline(f['assets']), inline(f['sound']))+ mid = '<div><h3>What makes it read as this</h3>%s<h3>What makes it look wrong</h3>%s</div>' % (ul(f['rules']), ul(f['pitfalls']))+ right = '<div><h3>How to build it</h3>%s%s</div>' % (ul(f['build']), ('<p>%s</p>' % inline(f['blender'])) if f['blender'] else '')+ thin = ('<p class="muted small">Sourcing note: %s</p>' % inline(f['thin'])) if f['thin'] else ''+ return ('<div class="style"><div class="fam">%s · %s · %s</div><h2>%s</h2><p>%s %s</p>%s<div class="cols">%s%s%s</div></div>'+ % (E(DATA['families'][f['family']]), E(cadence(f)), E(f['route']), E(f['name']), inline(f['what']), inline(f['origin']), thin, left, mid, right))+++LEADS = {'craft': 'Looks that show the hand: real materials, held drawings, small errors.',+ 'drawn': 'Looks made of line and paint, from cel animation to ink on paper.',+ 'geometry': 'Looks built from blocks, facets and pixels, and the clean studio shot.',+ 'type': 'Looks where words, numbers or the recording medium are the picture.'}+for fam, title in DATA['families'].items():+ group = [f for f in FORMS if f['family'] == fam]+ for i in range(0, len(group), 2): # two forms to a page+ body = ('<p class="lead">%s</p>' % inline(LEADS[fam]) if i == 0 else '') + ''.join(form_block(f) for f in group[i:i + 2])+ section('form-%s-%d' % (fam, i), title, title, body, toc=(i == 0))++section('tools', 'Tools that exist, by name', 'Reference', table(['Where', 'What', 'Used for'], [+ ['SVG filter', '`feTurbulence`', 'noise: grain, the source for every rough edge'],+ ['SVG filter', '`feDisplacementMap`', 'bend a shape by that noise: cut edges, line boil, ink bleed'],+ ['SVG filter', '`feMorphology`', 'thicken or thin: outlines'],+ ['SVG filter', '`feColorMatrix`, `feComponentTransfer`', 'recolour, threshold, separate one ink, sepia'],+ ['CSS', '`steps()`', 'held drawings in a CSS animation'],+ ['CSS', '`mix-blend-mode: multiply`', 'ink printed over ink, paper grain over everything'],+ ['CSS', '`mix-blend-mode: screen`, `plus-lighter`', 'glow that adds up: neon, chroma bleed'],+ ['CSS', '`image-rendering: pixelated`', 'pixel art scaled with hard edges'],+ ['Canvas', '`globalCompositeOperation`', 'the same blends on a canvas, and `destination-out` to cut marks out of a shape'],+ ['Canvas', '`fill("evenodd")`', 'holes that are part of a figure: shadow puppets'],+ ['GSAP', '`ease: "steps(n)"`', 'held drawings in a tween'],+ ['Three.js', '`MeshToonMaterial` with a `gradientMap`', 'light in hard bands: cel shading'],+ ['Three.js', 'a second mesh, larger, back faces only', 'an outline (the inverted hull); `OutlineEffect` packages it'],+ ['Three.js', '`flatShading: true`', 'low-poly facets'],+ ['Three.js', '`InstancedMesh`', 'thousands of voxels in one draw call'],+ ['Three.js examples', '`HalftonePass`, `RenderPixelatedPass`, `FilmPass`, `RGBShiftShader`, `GlitchPass`, `UnrealBloomPass`', 'post-processing for print, pixel, tape and glow looks'],+], ['18%', '40%', '42%']) + p(+ 'Three.js ships no watercolour pass and no VHS pass: both are built from the pieces above. Its `GlitchPass` chooses its own random timing, so check that it repeats before relying on it in a render.') + '<h2>When Blender is the better tool</h2>' + ul(+ [f['name'] + ': ' + f['blender'] for f in FORMS if f['blender']]) + '<h2>Wiring a look into a composition</h2>' + code('''+const clock = { t: 0 };+const tl = gsap.timeline({ paused: true });+tl.to(clock, { t: DURATION, duration: DURATION, ease: "none", onUpdate: () => draw(clock.t) }, 0);+window.__timelines = window.__timelines || {};+window.__timelines["main"] = tl;+draw(0);''') + p('GSAP owns the clock and the look only draws. Vendor GSAP and Three.js into the project so a render never touches the network.'))++seen, srcs = set(), []+for f in FORMS:+ for u in f['sources']:+ if u not in seen:+ seen.add(u)+ srcs.append(u)+section('sources', 'Sources and what was verified', 'Reference', '<p class="lead">%s</p>' % inline('What this guide rests on, and where its limits are.') + '<h2>Verified by running it</h2>' + ul([+ 'All 31 demos pass the browser test: each paints, changes over time and repeats exactly.',+ 'The source of the demos contains no clock, timer or unseeded random call; a test enforces it.',+ 'The router and the generated reference pages have unit tests.',+]) + '<h2>Not verified</h2>' + ul([+ 'No art-form video was rendered through HyperFrames. The demos follow its rules and were tested as browser pictures.',+ 'Tested on macOS with Chrome 157 only.',+ 'Frame-rate conventions come from encyclopaedia articles, not from studio production notes.',+ 'Lines marked "practice note" in the reference pages (most sound and pacing advice, some visual rules) are working advice, not sourced facts.',+ 'Entries with a sourcing note are thinner than the rest: ' + ', '.join(f['name'] for f in FORMS if f['thin']) + '.',+]) + '<h2>Published sources</h2><p class="src">' + '<br>'.join(E(u) for u in srcs) + '</p>' + p(+ 'The repositories studied for techniques, with their licences, are listed in the changelog entry and in the project notes. No code from another project is copied into brief2mp4 for this work. Facts were checked on 17 November 2026.'))++toc = ''.join('<a href="#%s">%s</a>' % (sid, E(t)) for sid, t, _, _, in_toc in SECTIONS if in_toc)+cover = '''<section class="cover"><div class="eyebrow">Qualixar<span>Companion guide · November 2026</span></div>+<h1>brief<i>2</i>mp4</h1><div class="deck">The art forms guide</div>+<div class="strap">%d looks for animated video, and how to build each one in code that renders the same way twice.<br>Claymation · paper cut-out · shadow puppetry · anime · watercolour · ink · risograph · pixel art · voxel · VHS · neon</div>+<img class="mark" src="../../plugin/assets/icon.png" alt="">+<div class="by">Varun Pratap Bhardwaj · github.com/qualixar/brief2mp4 · MIT licence</div></section>''' % len(FORMS)+parts = [cover, '<section id="contents"><div class="eyebrow">Contents<span>brief2mp4</span></div><h1>Contents</h1><div class="toc">%s</div>%s</section>' % (toc, note(+ 'How to use this guide', 'Read the three rules first. Then find the look you want; each takes half a page. The last pages list the tools by name and say what was and was not verified.'))]+for sid, title, eyebrow, body, _ in SECTIONS:+ head = '<h1>%s</h1>' % E(title) if not sid.startswith('form-') or body.startswith('<p class="lead">') else ''+ parts.append('<section id="%s"><div class="eyebrow">%s<span>brief2mp4 art forms</span></div>%s%s</section>' % (sid, E(eyebrow), head, body))+doc = '''<!doctype html><html lang="en"><head><meta charset="utf-8"><title>brief2mp4: the art forms guide</title>+<meta name="author" content="Varun Pratap Bhardwaj"><meta name="description" content="%d art forms for animated video, with the rules, timing and build recipe for each.">+<meta name="keywords" content="animation styles, claymation, paper cut-out, cel shading, stop motion, HyperFrames, three.js, Claude Code skill">+<link rel="stylesheet" href="guide.css"></head><body>%s</body></html>''' % (len(FORMS), ''.join(parts))+(HERE / 'brief2mp4-art-forms.html').write_text(doc)+text = re.sub(r'<pre>.*?</pre>', ' ', doc, flags=re.S)+text = re.sub(r'<p class="src">.*?</p>', ' ', text, flags=re.S)+text = re.sub(r'</(p|h1|h2|h3|li|td|th|figcaption|div|a|section)>', '\n', text)+text = html.unescape(re.sub(r'<[^>]+>', '', text))+(HERE / 'guide-prose.txt').write_text('\n'.join(line.strip() for line in text.splitlines() if line.strip()) + '\n')+print('%d sections, %d words of prose' % (len(SECTIONS) + 2, len(text.split())))diff --git a/docs/art-forms-guide/fonts/DejaVuSansMono.ttf b/docs/art-forms-guide/fonts/DejaVuSansMono.ttfnew file mode 100644index 0000000..278cd78Binary files /dev/null and b/docs/art-forms-guide/fonts/DejaVuSansMono.ttf differdiff --git a/docs/art-forms-guide/fonts/LICENSE-dejavu.txt b/docs/art-forms-guide/fonts/LICENSE-dejavu.txtnew file mode 100644index 0000000..254e2cc--- /dev/null+++ b/docs/art-forms-guide/fonts/LICENSE-dejavu.txt@@ -0,0 +1,99 @@+Fonts are (c) Bitstream (see below). DejaVu changes are in public domain.+Glyphs imported from Arev fonts are (c) Tavmjong Bah (see below)++Bitstream Vera Fonts Copyright+------------------------------++Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is+a trademark of Bitstream, Inc.++Permission is hereby granted, free of charge, to any person obtaining a copy+of the fonts accompanying this license ("Fonts") and associated+documentation files (the "Font Software"), to reproduce and distribute the+Font Software, including without limitation the rights to use, copy, merge,+publish, distribute, and/or sell copies of the Font Software, and to permit+persons to whom the Font Software is furnished to do so, subject to the+following conditions:++The above copyright and trademark notices and this permission notice shall+be included in all copies of one or more of the Font Software typefaces.++The Font Software may be modified, altered, or added to, and in particular+the designs of glyphs or characters in the Fonts may be modified and+additional glyphs or characters may be added to the Fonts, only if the fonts+are renamed to names not containing either the words "Bitstream" or the word+"Vera".++This License becomes null and void to the extent applicable to Fonts or Font+Software that has been modified and is distributed under the "Bitstream+Vera" names.++The Font Software may be sold as part of a larger software package but no+copy of one or more of the Font Software typefaces may be sold by itself.++THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS+OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,+TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME+FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING+ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF+THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE+FONT SOFTWARE.++Except as contained in this notice, the names of Gnome, the Gnome+Foundation, and Bitstream Inc., shall not be used in advertising or+otherwise to promote the sale, use or other dealings in this Font Software+without prior written authorization from the Gnome Foundation or Bitstream+Inc., respectively. For further information, contact: fonts at gnome dot+org.++Arev Fonts Copyright+------------------------------++Copyright (c) 2006 by Tavmjong Bah. All Rights Reserved.++Permission is hereby granted, free of charge, to any person obtaining+a copy of the fonts accompanying this license ("Fonts") and+associated documentation files (the "Font Software"), to reproduce+and distribute the modifications to the Bitstream Vera Font Software,+including without limitation the rights to use, copy, merge, publish,+distribute, and/or sell copies of the Font Software, and to permit+persons to whom the Font Software is furnished to do so, subject to+the following conditions:++The above copyright and trademark notices and this permission notice+shall be included in all copies of one or more of the Font Software+typefaces.++The Font Software may be modified, altered, or added to, and in+particular the designs of glyphs or characters in the Fonts may be+modified and additional glyphs or characters may be added to the+Fonts, only if the fonts are renamed to names not containing either+the words "Tavmjong Bah" or the word "Arev".++This License becomes null and void to the extent applicable to Fonts+or Font Software that has been modified and is distributed under the+"Tavmjong Bah Arev" names.++The Font Software may be sold as part of a larger software package but+no copy of one or more of the Font Software typefaces may be sold by+itself.++THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL+TAVMJONG BAH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM+OTHER DEALINGS IN THE FONT SOFTWARE.++Except as contained in this notice, the name of Tavmjong Bah shall not+be used in advertising or otherwise to promote the sale, use or other+dealings in this Font Software without prior written authorization+from Tavmjong Bah. For further information, contact: tavmjong @ free+. fr.++$Id: LICENSE 2133 2007-11-28 02:46:28Z lechimp $diff --git a/docs/art-forms-guide/fonts/LICENSE-inter.txt b/docs/art-forms-guide/fonts/LICENSE-inter.txtnew file mode 100644index 0000000..40589da--- /dev/null+++ b/docs/art-forms-guide/fonts/LICENSE-inter.txt@@ -0,0 +1,93 @@+Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter) Inter-Italic[opsz,wght].ttf: Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter)++This Font Software is licensed under the SIL Open Font License, Version 1.1.+This license is copied below, and is also available with a FAQ at:+http://scripts.sil.org/OFL+++-----------------------------------------------------------+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007+-----------------------------------------------------------++PREAMBLE+The goals of the Open Font License (OFL) are to stimulate worldwide+development of collaborative font projects, to support the font creation+efforts of academic and linguistic communities, and to provide a free and+open framework in which fonts may be shared and improved in partnership+with others.++The OFL allows the licensed fonts to be used, studied, modified and+redistributed freely as long as they are not sold by themselves. The+fonts, including any derivative works, can be bundled, embedded,+redistributed and/or sold with any software provided that any reserved+names are not used by derivative works. The fonts and derivatives,+however, cannot be released under any other type of license. The+requirement for fonts to remain under this license does not apply+to any document created using the fonts or their derivatives.++DEFINITIONS+"Font Software" refers to the set of files released by the Copyright+Holder(s) under this license and clearly marked as such. This may+include source files, build scripts and documentation.++"Reserved Font Name" refers to any names specified as such after the+copyright statement(s).++"Original Version" refers to the collection of Font Software components as+distributed by the Copyright Holder(s).++"Modified Version" refers to any derivative made by adding to, deleting,+or substituting -- in part or in whole -- any of the components of the+Original Version, by changing formats or by porting the Font Software to a+new environment.++"Author" refers to any designer, engineer, programmer, technical+writer or other person who contributed to the Font Software.++PERMISSION & CONDITIONS+Permission is hereby granted, free of charge, to any person obtaining+a copy of the Font Software, to use, study, copy, merge, embed, modify,+redistribute, and sell modified and unmodified copies of the Font+Software, subject to the following conditions:++1) Neither the Font Software nor any of its individual components,+in Original or Modified Versions, may be sold by itself.++2) Original or Modified Versions of the Font Software may be bundled,+redistributed and/or sold with any software, provided that each copy+contains the above copyright notice and this license. These can be+included either as stand-alone text files, human-readable headers or+in the appropriate machine-readable metadata fields within text or+binary files as long as those fields can be easily viewed by the user.++3) No Modified Version of the Font Software may use the Reserved Font+Name(s) unless explicit written permission is granted by the corresponding+Copyright Holder. This restriction only applies to the primary font name as+presented to the users.++4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font+Software shall not be used to promote, endorse or advertise any+Modified Version, except to acknowledge the contribution(s) of the+Copyright Holder(s) and the Author(s) or with their explicit written+permission.++5) The Font Software, modified or unmodified, in part or in whole,+must be distributed entirely under this license, and must not be+distributed under any other license. The requirement for fonts to+remain under this license does not apply to any document created+using the Font Software.++TERMINATION+This license becomes null and void if any of the above conditions are+not met.++DISCLAIMER+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM+OTHER DEALINGS IN THE FONT SOFTWARE.diff --git a/docs/art-forms-guide/fonts/LICENSE-space-grotesk.txt b/docs/art-forms-guide/fonts/LICENSE-space-grotesk.txtnew file mode 100644index 0000000..d5666d7--- /dev/null+++ b/docs/art-forms-guide/fonts/LICENSE-space-grotesk.txt@@ -0,0 +1,93 @@+Copyright 2020 The Space Grotesk Project Authors (https://github.com/floriankarsten/space-grotesk)++This Font Software is licensed under the SIL Open Font License, Version 1.1.+This license is copied below, and is also available with a FAQ at:+http://scripts.sil.org/OFL+++-----------------------------------------------------------+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007+-----------------------------------------------------------++PREAMBLE+The goals of the Open Font License (OFL) are to stimulate worldwide+development of collaborative font projects, to support the font creation+efforts of academic and linguistic communities, and to provide a free and+open framework in which fonts may be shared and improved in partnership+with others.++The OFL allows the licensed fonts to be used, studied, modified and+redistributed freely as long as they are not sold by themselves. The+fonts, including any derivative works, can be bundled, embedded,+redistributed and/or sold with any software provided that any reserved+names are not used by derivative works. The fonts and derivatives,+however, cannot be released under any other type of license. The+requirement for fonts to remain under this license does not apply+to any document created using the fonts or their derivatives.++DEFINITIONS+"Font Software" refers to the set of files released by the Copyright+Holder(s) under this license and clearly marked as such. This may+include source files, build scripts and documentation.++"Reserved Font Name" refers to any names specified as such after the+copyright statement(s).++"Original Version" refers to the collection of Font Software components as+distributed by the Copyright Holder(s).++"Modified Version" refers to any derivative made by adding to, deleting,+or substituting -- in part or in whole -- any of the components of the+Original Version, by changing formats or by porting the Font Software to a+new environment.++"Author" refers to any designer, engineer, programmer, technical+writer or other person who contributed to the Font Software.++PERMISSION & CONDITIONS+Permission is hereby granted, free of charge, to any person obtaining+a copy of the Font Software, to use, study, copy, merge, embed, modify,+redistribute, and sell modified and unmodified copies of the Font+Software, subject to the following conditions:++1) Neither the Font Software nor any of its individual components,+in Original or Modified Versions, may be sold by itself.++2) Original or Modified Versions of the Font Software may be bundled,+redistributed and/or sold with any software, provided that each copy+contains the above copyright notice and this license. These can be+included either as stand-alone text files, human-readable headers or+in the appropriate machine-readable metadata fields within text or+binary files as long as those fields can be easily viewed by the user.++3) No Modified Version of the Font Software may use the Reserved Font+Name(s) unless explicit written permission is granted by the corresponding+Copyright Holder. This restriction only applies to the primary font name as+presented to the users.++4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font+Software shall not be used to promote, endorse or advertise any+Modified Version, except to acknowledge the contribution(s) of the+Copyright Holder(s) and the Author(s) or with their explicit written+permission.++5) The Font Software, modified or unmodified, in part or in whole,+must be distributed entirely under this license, and must not be+distributed under any other license. The requirement for fonts to+remain under this license does not apply to any document created+using the Font Software.++TERMINATION+This license becomes null and void if any of the above conditions are+not met.++DISCLAIMER+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM+OTHER DEALINGS IN THE FONT SOFTWARE.diff --git a/docs/art-forms-guide/fonts/inter-400.woff2 b/docs/art-forms-guide/fonts/inter-400.woff2new file mode 100644index 0000000..f15b025Binary files /dev/null and b/docs/art-forms-guide/fonts/inter-400.woff2 differdiff --git a/docs/art-forms-guide/fonts/inter-700.woff2 b/docs/art-forms-guide/fonts/inter-700.woff2new file mode 100644index 0000000..a68fb10Binary files /dev/null and b/docs/art-forms-guide/fonts/inter-700.woff2 differdiff --git a/docs/art-forms-guide/fonts/space-grotesk-700.woff2 b/docs/art-forms-guide/fonts/space-grotesk-700.woff2new file mode 100644index 0000000..44604a0Binary files /dev/null and b/docs/art-forms-guide/fonts/space-grotesk-700.woff2 differdiff --git a/docs/art-forms-guide/guide-prose.txt b/docs/art-forms-guide/guide-prose.txtnew file mode 100644index 0000000..46786c9--- /dev/null+++ b/docs/art-forms-guide/guide-prose.txt@@ -0,0 +1,907 @@+brief2mp4: the art forms guide+QualixarCompanion guide · November 2026+brief2mp4+The art forms guide+30 looks for animated video, and how to build each one in code that renders the same way twice.Claymation · paper cut-out · shadow puppetry · anime · watercolour · ink · risograph · pixel art · voxel · VHS · neon+Varun Pratap Bhardwaj · github.com/qualixar/brief2mp4 · MIT licence+Contentsbrief2mp4+Contents+A look is a set of rules+Three rules behind every look+Choosing a look from a brief+Craft and handmade+Drawn and painted+Geometry, pixels and 3D+Type, data and retro+Tools that exist, by name+Sources and what was verified+How to use this guideRead the three rules first. Then find the look you want; each takes half a page. The last pages list the tools by name and say what was and was not verified.+Orientationbrief2mp4 art forms+A look is a set of rules+Ask for "claymation" or "a paper cut-out" and you are asking for a short list of things: how edges look, how light falls, how often the picture changes. This guide writes those lists down for 30 art forms, and shows how to build each one in code that renders the same way every time.+It is a companion to brief2mp4, the skill that turns a written brief into a finished, checked MP4. The skill builds video from web pages: HTML, CSS and GSAP in HyperFrames, canvas, SVG and Three.js. Every art form here has a reference page in the skill and a small demo that is tested in a real browser.+One frame from each of the 31 demos, drawn by the test that checks them.+Family+Art forms+Craft and handmade+Claymation, Stop-motion look, Paper cut-out, Felt and fabric craft, Origami, Shadow puppetry, Collage and mixed media, Risograph and halftone print+Drawn and painted+Anime and cel shading, 2D flat vector explainer, Whiteboard and doodle, Watercolour, Ink wash (sumi-e), Line art, Rotoscope look, Motion comic, UPA and mid-century modern, Rubber-hose cartoon, Linocut and woodcut print+Geometry, pixels and 3D+Isometric, Low-poly 3D, Voxel, Pixel art, 3D product render+Type, data and retro+Kinetic typography, Infographic and data animation, Lyric video, VHS and glitch, Blueprint and technical drawing, Neon sign+What the demos areSmall pictures that prove a technique: a few seconds, 960 by 540, drawn on a canvas or with Three.js. They are starting points for a scene, not finished films. No art-form video was rendered through HyperFrames for this guide.+The methodbrief2mp4 art forms+Three rules behind every look+A renderer that works frame by frame asks for frame 212, then frame 213, sometimes out of order and on several workers. Three rules make any look survive that.+1. The picture is a function of time+No clock, no timers, no Math.random(). Whatever is on screen at second 4.2 must depend on the number 4.2 and nothing else. Randomness comes from a hash of the frame number or of a position, so it is the same on every run.+2. Handmade looks hold their drawings+Film runs at 24 frames a second, but clay, paper and hand-drawn animation are usually shot "on twos": each pose is held for two frames, so the picture changes about 12 times a second. That stepping is most of what makes them read as handmade. Quantise time before posing anything, and leave the video itself at 24 or 30.+Clean looks are the opposite: a flat explainer, a low-poly scene, a product render and kinetic type stay smooth at the full frame rate.+3. Imperfection is seeded+Line boil, paper jitter, lamp flicker, misregistered ink and tape damage all come from one line: a small nudge keyed to the drawing number.+The usual web recipe breaks rule 1Most tutorials make a hand-drawn line wobble with a timer that re-rolls an SVG filter every 100 milliseconds. A frame-by-frame renderer has no such timer. Key the change to the frame number instead, and the wobble is part of the frame.+How the demos are checked+A test draws every look in headless Chrome at three moments. The three pictures must differ, none may be blank, and the middle one, drawn a second time after the others, must match itself pixel for pixel. A second test reads the source and fails if a clock, a timer or Math.random appears anywhere in it.+The methodbrief2mp4 art forms+Choosing a look from a brief+If the brief names a look, use it. If it does not, the subject and the mood usually point to one.+The brief is about+Try+Why+children, family, a gentle story+paper cut-out, claymation, felt+handmade textures feel warm and safe+a folk tale, a myth, heritage+shadow puppetry, linocut, ink wash+the form carries the tradition; check the iconography with a source+explaining a product or a process+flat vector explainer, isometric, whiteboard+clean shapes keep attention on the idea+numbers+infographic+the chart is the picture; every number needs a source+a song or a quote+lyric video, kinetic typography+the words are the content+a physical product+3D product render; claymation for a playful take+the object is the hero+nostalgia+VHS and glitch, pixel art, rubber-hose, UPA mid-century+each one is a decade+calm, reflective+watercolour, ink wash, line art+slow, sparse, quiet+loud, independent+risograph, collage, motion comic+print energy and hard cuts+The router is a keyword scorer, not a judge. One stray word is never enough ("paper" in "paper plane" does not choose paper cut-out), and when nothing fits it says so. An art form sets the look and the timing; the kind of video (explainer, Short, launch) still sets the beats.+Writing the look into the brief+A look becomes checkable when the brief says what should be visible. Two lines are enough:+Assets+Most looks here need no pictures at all: shapes, textures and grain are drawn in code. Where a look needs photographs, footage, a character model or music, use only what you own or may reuse. If you have an image model, it can generate textures and cut-out parts; say in the report that they were generated.+Craft and handmadebrief2mp4 art forms+Craft and handmade+Looks that show the hand: real materials, held drawings, small errors.+Craft and handmade · 12 changes a second · Three.js inside HyperFrames+Claymation+Figures of clay or plasticine, posed and photographed one frame at a time. Soft, lumpy, a little uneven, and never perfectly smooth in motion. Plasticine dates from 1897. Art Clokey (Gumby) and Aardman, founded in 1972, made the look famous.+Timing+Shot on doubles: about 12 pose changes a second inside a 24 frames-a-second film. Each held pose sits a hair differently from the last.+Assets+Geometry in code (spheres, capsules, lathes) for simple characters. Fingerprint or noise detail as a generated bump texture. A real character needs modelling.+Sound+Close foley on pose changes (soft thuds, squelches), light percussion. Practice note.+What makes it read as this+Rounded volumes with small lumps and dents, never a perfect sphere+Matte, high-roughness surfaces under soft light+Saturated colour, few of them+Small asymmetries; a silhouette that changes slightly between poses+A miniature set: a floor, a backdrop, shallow depth+What makes it look wrong+Smooth 24 or 30 frames-a-second motion: it reads as CG, not clay+Glossy plastic highlights+Perfect symmetry and clean edges+How to build it+Three.js: MeshStandardMaterial with roughness about 0.9, metalness 0, and a noise canvas as bumpMap+Push each vertex in or out by a few percent with a seeded hash, then computeVertexNormals()+Pose from stepped time: held(t, 12)+Add a seeded nudge per drawing to position and rotation (about 2% of the size)+A hemisphere light plus one soft key; no hard specular highlights+Use Blender when the clay needs real subsurface scattering, soft area-light shadows or sculpted detail.+Craft and handmade · 12 changes a second · HyperFrames (canvas or DOM) or Three.js+Stop-motion look+Any real object moved and photographed a pose at a time. On screen it shows as stepped motion, tiny position errors and light that flickers a little. As old as film: stop tricks appear in the 1890s. Pixilation, cut-out and puppet animation are all forms of it.+Timing+On twos (12 changes a second) is the usual cadence; action sometimes on ones, held moments on threes or more.+Assets+None needed. Everything is procedural.+Sound+Foley that lands on pose changes. A bed that is not too smooth. Practice note.+What makes it read as this+Real materials: wood, card, cloth, plastic+Position jitter of a pixel or two between drawings+Lighting that varies slightly frame to frame+Hard cuts between poses, no in-between blur+What makes it look wrong+Stepping the camera and background together, so everything strobes+Easing between held poses, which defeats the look+Jitter so large the object vibrates+How to build it+Quantise time before anything else: const ts = held(t, 12)+GSAP: ease: "steps(12)" on a one-second tween does the same for a tween+Jitter and flicker keyed to the frame number: jit(frameOf(t, 12), i, 1.2)+Keep the camera and background steady: step the subject, not the world+Craft and handmadebrief2mp4 art forms+Craft and handmade · 12 changes a second · HyperFrames (canvas, SVG or DOM)+Paper cut-out+Flat shapes cut from paper or card, layered, and moved a pose at a time. Parts hinge at joints; nothing bends. Lotte Reiniger's The Adventures of Prince Achmed (1926) is the oldest surviving animated feature. Terry Gilliam's Monty Python animations and the South Park pilot used cut paper.+Timing+Stop-motion cadence, usually on twos. Motion is rotation about joints and sliding, with pops and holds.+Assets+Shapes drawn in code or as SVG. Photo cut-outs need images you own, or generated ones.+Sound+Paper rustle, snips, soft ticks on pose changes. Practice note.+What makes it read as this+Flat fills with hard, slightly uneven cut edges+Layers stacked with a small, tight shadow under each+Rigid parts that rotate about a pivot+Paper grain over everything+A limited, slightly muted palette+What makes it look wrong+Smooth vector motion with no stepping+Perfect edges+Large soft shadows, which look like interface cards, not paper+How to build it+Each part is its own shape; nudge the corners with a seeded hash so edges look cut by hand+Canvas: shadowOffsetY 3 to 4 px with shadowBlur 4 to 5 px per layer. DOM: filter: drop-shadow()+Joints: rotate about a pivot (transformOrigin in GSAP, translate then rotate on a canvas)+Paper grain: a noise texture drawn once and laid over with multiply+SVG route: feTurbulence into feDisplacementMap (scale 2 to 4) roughens an edge+Use Blender for real folded paper with thickness and light passing through it.+Craft and handmade · 12 changes a second · HyperFrames (canvas or SVG)+Felt and fabric craft+Shapes that look needle-felted or sewn: a fuzzy edge of loose fibres, a matte mottled surface, visible stitches. Needle felting tangles wool fibres with barbed needles to make flat pictures and soft figures.+Sourcing note: The craft is well documented; its use in animation is a practice note, not sourced.+Timing+Stop-motion cadence, on twos. Gentle bobbing and nudging.+Assets+Procedural. A felt texture from an image model helps for close-ups.+Sound+Soft, warm, acoustic. Practice note.+What makes it read as this+A halo of short fibres along every edge+Matte, slightly mottled colour+Stitches: a dashed line just inside the edge+Chunky, simple forms in wool colours+What makes it look wrong+Crisp vector edges+Flat plastic colour+No fibre fuzz+How to build it+Draw the shape, then several hundred short strokes outward from its edge, each angled by a seeded hash+Stitches: setLineDash([9, 7]) on a path just inside the edge (SVG: stroke-dasharray)+Mottle: a grain texture clipped to the shape with multiply+SVG route: high-frequency feTurbulence (0.8 to 1.2) with displacement scale 3 to 6 on the edge+Use Blender hair or fur for real fibre fuzz on 3D figures.+Craft and handmadebrief2mp4 art forms+Craft and handmade · smooth · HyperFrames (canvas or SVG), or Three.js+Origami+Paper folded from a flat sheet: sharp creases, flat facets, each fold a clean move followed by a pause. Japanese paper folding. Modern computational origami works from crease patterns.+Timing+Folds are eased moves of about 0.8 seconds with a short hold after each. Smooth, not stepped.+Assets+Geometry in code. A faint paper grain.+Sound+Light paper crinkle on each fold, soft piano or music box. Practice note.+What makes it read as this+Sharp mountain and valley creases+Flat facets, each shaded as one plane+Paper coloured on one side, white on the other+Soft, even light so the creases read+What makes it look wrong+Faces passing through each other+Folding with no hold, so the eye cannot follow+Light that hides the creases+How to build it+2D: a fold is a point travelling across the crease; draw the moving flap from the crease to that point+Shade the flap by its angle, and swap to the paper's other colour past 90 degrees+3D: flat-shaded polygons, child groups rotating about the crease axis+An orthographic camera gives a diagram-clean view+Use Blender when the paper has to bend or show thickness.+Craft and handmade · 12 changes a second · HyperFrames (canvas or SVG)+Shadow puppetry+Flat figures held between a lamp and a cloth screen: dark silhouettes with punched patterns on a warm, glowing field. An old tradition across Asia. Ravana Chhaya of Odisha uses uncoloured deerskin puppets with no joints; wayang kulit of Java and Bali was recognised by UNESCO in 2003. Lotte Reiniger brought silhouettes to film.+Timing+Live puppets move continuously on rods; film versions are stop-motion, so use twos. Stiff, deliberate moves; no squash and stretch.+Assets+Simple figures in code. Ornate traditional figures need drawing or tracing with care.+Sound+Narrator, singers and percussion in the tradition: cymbals and drums for Ravana Chhaya, gamelan for wayang.+What makes it read as this+Black silhouettes on a warm lit screen, never on white+Interior detail made of perforations: rows of holes and cut patterns+A lamp that flickers+The shadow softens and grows as the puppet moves away from the screen+Rods visible below the figures+What makes it look wrong+Black on white, which loses the lamp+Smooth modern vector motion+Careless drawings of sacred figures: check the iconography with a source+How to build it+One path per puppet filled with the even-odd rule, so holes are part of the figure+Screen: a radial gradient from warm yellow to deep brown+Flicker: scale the lamp brightness by a seeded value per drawing+Distance from the screen: filter: blur() growing with distance, and lower opacity+Ravana Chhaya style: no joints, move and tilt the whole puppet. Wayang style: hinge the arms+Use Blender for real light through translucent coloured leather.+Craft and handmadebrief2mp4 art forms+Craft and handmade · 8 changes a second · HyperFrames (canvas or DOM)+Collage and mixed media+Pieces of different papers, photographs and print stuck together: mismatched scale and texture, torn edges, hard shadows. From the French coller, to glue. Braque and Picasso brought it into modern art around 1912; Dada followed with photomontage.+Timing+On twos or threes. Pieces pop into place on the beat with a small rotation, then hold.+Assets+Paper textures in code. Photo fragments need images you own, or generated ones.+Sound+Bright percussive music, staccato effects on each pop. Practice note.+What makes it read as this+Torn or cut edges+Mixed materials: flat colour, halftone photograph, tape+Overlap with a hard, offset shadow+Mismatched scale on purpose+One palette holding it together+What makes it look wrong+Everything neatly aligned+No shadows+Too many unrelated colours and typefaces+How to build it+Torn edge: walk the outline of a rectangle and nudge every point with a seeded hash+Hard shadow: shadowBlur: 0 with an offset of 5 to 6 px+Halftone a photo: dots on a staggered grid sized by brightness+Entrance: scale from 1.25 to 1 with a quarter-turn of rotation over a quarter of a second+Craft and handmade · 8 changes a second · HyperFrames (canvas or DOM)+Risograph and halftone print+The look of a cheap stencil print: two to four bright inks laid over each other, visible grain, dot screens, and layers that never quite line up. The Risograph duplicator dates from 1980: one ink per drum, so each colour is a separate pass. Halftone dots go back to the 1860s.+Timing+Print is still. Animate by re-rolling the misregistration and swapping the grain 8 to 12 times a second.+Assets+All procedural. A chunky sans or slab typeface.+Sound+Lo-fi, tape hiss. Practice note.+What makes it read as this+Two to four spot colours, often pink, blue and yellow+Inks overprint to make new colours (multiply)+Each layer sits a pixel or two off register+Grain and dot screens; no smooth gradients+Off-white paper+What makes it look wrong+Gradients+Perfect registration+More than four colours+How to build it+Each ink is its own layer drawn with mix-blend-mode: multiply (canvas: globalCompositeOperation)+Offset each layer by a seeded amount per drawing: jit(frameOf(t, 8), layer, 3)+Tone as dots: a staggered grid of circles whose radius follows the tone+Grain: several pre-made noise tiles, cycled by frame number+Three.js HalftonePass exists for 3D scenes; SVG feColorMatrix separates a photo into one ink+Drawn and paintedbrief2mp4 art forms+Drawn and painted+Looks made of line and paint, from cel animation to ink on paper.+Drawn and painted · 12 changes a second · Three.js inside HyperFrames+Anime and cel shading+Light broken into two or three flat tones with a hard edge between them, and an ink outline around every form. Named after the celluloid sheets of hand-drawn animation. In 3D it became toon shading, as in Jet Set Radio and The Wind Waker.+Timing+On twos as the baseline, ones for key action, threes and holds for dialogue.+Assets+The gradient map is three bytes. Characters need modelling or generated models.+Sound+Whoosh and impact effects on key poses. Practice note.+What makes it read as this+Two or three tone bands with hard edges+Shadows tinted with colour, not black+A clean outline+Flat, detailed backgrounds behind simpler characters+Limited animation: holds, then sudden moves+What makes it look wrong+Smooth interpolation at 24 frames a second+More than three bands+Shadows that are only a darker grey+How to build it+Three.js MeshToonMaterial with a gradientMap: a three-texel DataTexture with NearestFilter, so light snaps to bands+Outline by inverted hull: a second copy of each mesh, slightly larger, drawn back faces only in black+OutlineEffect and SobelOperatorShader in the three.js examples are the two other routes+Step the pose time: held(t, 12)+2D: flat SVG shapes, a thick outline, steps() timing+Use Blender for Freestyle line art and shader-to-RGB ramps on real characters.+Drawn and painted · smooth · HyperFrames (DOM, SVG)+2D flat vector explainer+The plain explainer look: flat fills, a few colours, simple shapes and icons, smooth eased motion. Flat design comes from Swiss style and modernism; in animation its ancestor is the stylised, limited look of the UPA studio.+Timing+Smooth ease-out moves of 0.4 to 0.8 seconds, staggered, with holds long enough to read.+Assets+All in code.+Sound+Soft interface blips, a light bed, voice-led pacing. Practice note.+What makes it read as this+Flat fills, three to five colours, one accent+Geometric shapes with one stroke width+Plenty of space; one idea per frame+Clean sans type+What makes it look wrong+A grid of identical cards+Gradients and shadows creeping in+Too much on screen at once+How to build it+HTML or SVG with GSAP: this is what HyperFrames is best at+Stagger related items 0.15 to 0.25 seconds apart+Draw check marks and connectors on with stroke-dashoffset+Move a highlight instead of cutting+Drawn and paintedbrief2mp4 art forms+Drawn and painted · 10 changes a second · HyperFrames (canvas or SVG)+Whiteboard and doodle+Marker lines that draw themselves on a white board, in the order someone would draw them. The chalkboard is the same recipe, inverted. Also called video scribing. A 2016 study found little evidence that it teaches better than other formats, so use it for its tone, not as a learning trick.+Timing+Each element draws on over 0.3 to 1.5 seconds, paced to the narration. The line boils at about 10 changes a second.+Assets+All in code. A marker or chalk typeface if the system has one.+Sound+Marker squeak, voice-led. Practice note.+What makes it read as this+Black marker lines with a slight wobble+Strokes appear in drawing order+One or two accent colours+Chalk variant: a dark board, dusty broken strokes, a little smudge+What makes it look wrong+Perfect vector lines+A hand that covers the drawing+Paragraphs of text+How to build it+Draw-on: a polyline drawn up to a fraction of its length (SVG: stroke-dashoffset)+Boil: nudge every point by a seeded amount keyed to frameOf(t, 10)+Chalk: three thin passes of the same stroke with different dash patterns at half opacity, over a speckled board+rough.js (MIT) generates sketchy shapes and hatching to animate afterwards+Drawn and painted · 12 changes a second · HyperFrames (canvas or SVG)+Watercolour+Transparent washes on textured paper: colour that spreads, pools darker at its edge, and lets the paper show through. Pigment in water on paper. Wet-on-wet blends softly; wet-on-dry gives crisp edges.+Sourcing note: The edge-darkening rule is a practice note; the technique sources cover the filter, not the look.+Timing+Slow. A wash grows over 1 to 3 seconds with an ease-out. Hold drawings at 12 a second for a hand-painted feel.+Assets+Procedural. A scanned paper texture improves close-ups.+Sound+Slow, gentle, acoustic. Practice note.+What makes it read as this+Transparent colour; overlaps make new colours+Darker pigment at the edge of each wash+Irregular, soft outlines+Paper grain visible everywhere+Unpainted paper as the highlight+What makes it look wrong+Opaque flat colour+A uniform blur, which looks out of focus, not painted+No paper texture+How to build it+Each wash: an irregular closed outline, clipped, filled with a radial gradient that is darkest near the rim+Layer washes with multiply+Paper grain over everything with multiply+SVG route: low-frequency feTurbulence (0.01 to 0.03) into feDisplacementMap (scale 10 to 25) for bleeding edges+3D: a Kuwahara filter as a custom pass gives a painterly result; three.js ships none+Drawn and paintedbrief2mp4 art forms+Drawn and painted · 12 changes a second · HyperFrames (canvas or SVG)+Ink wash (sumi-e)+Black ink in every shade from deep black to pale grey, laid down in tapered brush strokes on rice paper, with a great deal left empty. Chinese ink wash painting from the Tang dynasty, carried to Japan by Zen monks. Shanghai Animation Film Studio made ink-wash films from 1960.+Timing+Slow and fluid. A stroke accelerates and lifts. On twos.+Assets+Procedural. Rice-paper grain.+Sound+Sparse: flute, single plucked notes, silence. Practice note.+What makes it read as this+One ink, many dilutions+Strokes that taper from thick to a point+Empty paper as part of the picture+One small red seal+Soft grey washes behind sharp strokes+What makes it look wrong+Pure black on pure white+Uniform stroke width+Filling the frame+How to build it+A stroke is a row of overlapping dots whose radius tapers along its length, drawn up to a fraction+Vary each dot's opacity with a seeded hash for a dry-brush break+Washes: soft radial gradients with multiply+SVG route: variable-width filled paths revealed by a mask+Drawn and painted · 10 changes a second · HyperFrames (SVG or canvas)+Line art+One weight of line on a plain ground, no shading: the drawing draws itself, then quivers slightly as if redrawn each frame. Drawing with line alone, where tone comes only from hatching or stippling.+Timing+Draw-on over 1 to 2 seconds, then a boil at 8 to 12 changes a second.+Assets+All in code.+Sound+A pencil or pen sound under the draw-on. Practice note.+What makes it read as this+A constant or tapered stroke with round ends+No fills, or one flat tone+Plenty of empty space+One accent colour at most+What makes it look wrong+Jitter so strong the line turns to noise+Filters that re-run on a large area every frame and slow the render+How to build it+Draw-on with stroke-dashoffset (canvas: a polyline to a fraction of its length)+Boil: a seeded nudge of 1 to 2 px per point, keyed to the frame number+SVG route: feTurbulence with seed set from the frame number, into feDisplacementMap (scale 1.5 to 3)+vector-effect: non-scaling-stroke keeps the weight when scaled+Drawn and paintedbrief2mp4 art forms+Drawn and painted · 12 changes a second · HyperFrames (canvas over video)+Rotoscope look+Real movement traced by hand: lifelike motion, flat colour fields that drift, and an outline that shimmers. Max Fleischer built the rotoscope. A Scanner Darkly, Waking Life and the a-ha video for Take On Me are the well-known examples.+Timing+Every frame or on twos. The boil is keyed to the drawing.+Assets+Footage you own, or a figure built in code.+Sound+The original scene audio, or music-led. Practice note.+What makes it read as this+Motion with the timing of live action+Flat or posterised colour fields+Outlines that change slightly every drawing+Colour that sits a little off the line+What makes it look wrong+Edge noise that flickers out of control+Losing the subject in the treatment+Tracing footage you have no right to use+How to build it+From footage: draw each video frame to a canvas, posterise it, find edges (three.js has SobelOperatorShader), then nudge the edges per drawing+From code: a figure built from joints, drawn twice: thick flat colour offset by a seeded amount, then a thin outline with its own nudge+Re-encode source video with a keyframe on every frame so seeking is exact+Dedicated tools do true painterly rotoscoping better than a browser.+Drawn and painted · smooth · HyperFrames (DOM or canvas)+Motion comic+Comic panels brought to life: layers inside a panel slide at different speeds under a slow camera move, then a hard cut to the next panel. Watchmen: Motion Comic (2008) is the usual first example.+Sourcing note: Pan-and-zoom staging is a practice note; the source describes the format, not the technique.+Timing+Slow pushes and pans of 2 to 4 seconds, hard cuts between panels, a pop for a burst.+Assets+Drawn panels in layers. Artwork needs an illustrator or generated images cut into layers.+Sound+Voice, music and effects carry it. Practice note.+What makes it read as this+Ink outlines, flat colour, halftone shading+A panel border+Foreground, figure and background on separate layers+Bursts and lettering as graphic elements+What makes it look wrong+A slow zoom on one flat image, which reads as a slideshow+No separation between figure and background+How to build it+Layers in a clipped panel; move far layers less than near ones+A slow scale from 1 to about 1.07 on the whole panel+Halftone shading: dots that shrink across the tone+Cut to the next panel by switching the scene at a time, not by cross-fading+Drawn and paintedbrief2mp4 art forms+Drawn and painted · 8 changes a second · HyperFrames (canvas, SVG)+UPA and mid-century modern+Flat, stylised design from 1950s cartoons: geometric characters, abstract backgrounds, colour printed slightly off its outline, and very few drawings. United Productions of America turned away from Disney realism and made limited animation a style. Gerald McBoing-Boing won an Academy Award in 1950.+Timing+Limited animation: a pose is held, then pops to the next. Eight or fewer changes a second.+Assets+All in code.+Sound+Jazz combo, sound effects as music. Practice note.+What makes it read as this+Characters built from triangles, circles and lines+Flat colour blocks that do not meet their outlines+Abstract backgrounds: a few shapes, no perspective+A warm, muted palette+What makes it look wrong+Smooth, fluid motion+Gradients and realistic light+How to build it+Flat shapes; draw the outline 6 to 9 px away from the fill+Two or three poses, switched on a frame count with no in-betweens+Paper grain with multiply+Drawn and painted · 12 changes a second · HyperFrames (canvas, SVG)+Rubber-hose cartoon+The 1920s cartoon: limbs like hoses with no elbows or knees, round bodies that bounce to the music, black and white film. Credited to Bill Nolan on Felix the Cat. The Fleischer studio kept it longest; Cuphead revived it.+Timing+Bouncy loops locked to the music, on twos, with squash and stretch.+Assets+All in code. Original characters only.+Sound+Hot jazz, slide whistles, effects on every bounce. Practice note.+What makes it read as this+Curved tubular limbs+Round forms+Black and white or sepia, high contrast+Film grain, scratches and a frame that weaves slightly+Everything moves to the beat+What makes it look wrong+Stiff jointed limbs+Clean modern gradients+Copying characters that are still under copyright+How to build it+A limb is a quadratic curve between two points; move the control point to bend it+Squash and stretch: scale the body on one axis by the inverse of the other+Grain: cycle a few noise tiles by frame; gate weave: shift the whole picture by a seeded pixel or two+Sepia with feColorMatrix if wanted+Drawn and paintedbrief2mp4 art forms+Drawn and painted · 8 changes a second · HyperFrames (canvas, SVG)+Linocut and woodcut print+A relief print: bold flat shapes in one to three inks, with white gouge marks where the block was carved. Carved in linoleum or wood; the uncut surface prints. Each colour is a separate block.+Sourcing note: The source covers the technique; the visual rules are practice notes.+Timing+Each colour arrives as a pull, top to bottom, then holds. On twos or slower.+Assets+All in code.+Sound+A roller, a press, paper lifting. Practice note.+What makes it read as this+Bold shapes, no fine detail+Short white cut marks inside the ink, all leaning one way+One to three inks, laid slightly off register+Paper showing at the edges+What makes it look wrong+Gradients+Thin delicate lines+Too many colours+How to build it+Draw each block to its own canvas, then cut marks out of it: short strokes with destination-out+Print blocks over each other with multiply, the second one offset a few pixels+Reveal a block by widening a clip from the top+SVG route: feTurbulence through a hard threshold makes rough voids+Geometry, pixels and 3Dbrief2mp4 art forms+Geometry, pixels and 3D+Looks built from blocks, facets and pixels, and the clean studio shot.+Geometry, pixels and 3D · smooth · HyperFrames (canvas, SVG) or Three.js+Isometric+A parallel projection seen from above at an angle: no perspective, three visible faces per block, a tidy model world. A technical drawing projection. Games use a 2:1 pixel slope, about 26.6 degrees, which is strictly dimetric.+Timing+The camera does not orbit. Objects drop, stack and slide along the three axes, staggered by grid position.+Assets+All in code.+Sound+Soft clicks as pieces land. Practice note.+What makes it read as this+No perspective: parallel lines stay parallel+Three tones per object: top lightest, one side mid, one side darkest+One light direction for everything+A grid floor+What makes it look wrong+A perspective camera by accident+Shadows that disagree with the light+Uneven block heights+How to build it+2D: x = (gx - gy) * s, y = (gx + gy) * s / 2 - gz * s; draw the two side faces, then the top+Sort by gx + gy, then by height, so nearer cubes cover farther ones+Three.js: an OrthographicCamera placed at equal x, y and z looking at the origin+CSS: rotateX(60deg) rotateZ(-45deg) on a flat layer+Use Blender for bevelled, ambient-occluded isometric scenes.+Geometry, pixels and 3D · smooth · Three.js inside HyperFrames+Low-poly 3D+Meshes with few polygons, each face lit as one flat facet. A hardware limit that became a style. From the era of early 3D consoles; chosen on purpose since about 2013.+Timing+Clean, so smooth: slow eased orbits and dollies at the full frame rate.+Assets+Geometry in code for landscapes and props. Characters need modelling.+Sound+Calm, spacious. Practice note.+What makes it read as this+Visible facets, flat shaded+A limited, saturated palette+Simple lighting and a gradient or flat sky+Chunky silhouettes+What makes it look wrong+Smooth normals, which erase the facets+Detailed textures that fight the flat colour+How to build it+Low segment counts and flatShading: true on MeshStandardMaterial+Displace a plane's vertices with a seeded hash for terrain, then computeVertexNormals()+A hemisphere light plus one directional key; fog in the sky colour for depth+Camera position from t directly+Use Blender for modelling and baked light.+Geometry, pixels and 3Dbrief2mp4 art forms+Geometry, pixels and 3D · 12 changes a second · Three.js inside HyperFrames+Voxel+Everything built from cubes of one size on a grid, like a three-dimensional pixel picture. A voxel is a value on a 3D grid. Minecraft made the look familiar.+Timing+On twos. Things appear cube by cube or layer by layer; moves snap to the grid.+Assets+Models as arrays in code, or made with a voxel editor.+Sound+Blocky, percussive, chiptune. Practice note.+What makes it read as this+One cube size, integer positions+Each face one flat tone+A small palette+Small floating scenes+What makes it look wrong+Cubes at non-integer positions+Faces flickering where cubes touch at full size+How to build it+One InstancedMesh of a box for all the cubes: one draw call+Set each cube's matrix from stepped time; hide a cube by scaling it to nothing+Cubes slightly under size (0.96) so the seams read+MeshLambertMaterial and a hemisphere light+Geometry, pixels and 3D · 8 changes a second · HyperFrames (canvas)+Pixel art+A tiny picture placed pixel by pixel and scaled up with hard edges: a few colours, no blur, sprites that step. From early video games; the term dates from 1982.+Timing+Walk cycles of 4 to 8 frames at about 8 a second. Scrolling moves in whole pixels.+Assets+Sprites as data in code, or drawn in a pixel editor.+Sound+Chiptune. Practice note.+What makes it read as this+A small canvas scaled by a whole number+A limited palette, often 8 to 32 colours+No anti-aliasing, no soft gradients+Sprites animate in a few frames+What makes it look wrong+Scaling by a fraction+Mixed pixel sizes on one screen+Smooth vector edges or too many colours+How to build it+Draw on a small canvas (160 by 90), then drawImage it up with imageSmoothingEnabled = false+CSS: image-rendering: pixelated on an upscaled canvas+Sprites as arrays of palette indexes+Three.js: RenderPixelatedPass renders a 3D scene to low resolution with nearest filtering+Geometry, pixels and 3Dbrief2mp4 art forms+Geometry, pixels and 3D · smooth · Three.js, the 3D pack, or Blender+3D product render+A studio shot of an object: a seamless backdrop, soft key, fill and rim lights, controlled reflections, a slow turn. Product photography lighting, done in 3D.+Sourcing note: The lighting source is about photography; applying it to rendering is a practice note.+Timing+Smooth and slow at the full frame rate. The opposite of the handmade looks.+Assets+A model of the product: built in code, made with the 3D pack, or supplied.+Sound+Minimal: a low bed and one accent on the reveal. Practice note.+What makes it read as this+A seamless backdrop+Key light to one side and above, a softer fill opposite, a rim light behind+A contact shadow under the object+True materials: gloss, metal, glass+One slow move+What makes it look wrong+No reflections, so it looks like plastic+One harsh light+An object floating with no shadow+How to build it+MeshPhysicalMaterial with clearcoat for lacquer, metalness: 1 for metal+Three directional lights in the key, fill and rim positions, plus a hemisphere light+Contact shadow: a plane with a radial-gradient texture, depthWrite: false+Rotation from t directly; ease the camera, not the turntable+Use Blender when the brief asks for photoreal glass, caustics or depth of field.+Type, data and retrobrief2mp4 art forms+Type, data and retro+Looks where words, numbers or the recording medium are the picture.+Type, data and retro · smooth · HyperFrames (DOM)+Kinetic typography+Moving words as the whole picture: scale, weight and timing carry the meaning. Saul Bass's title sequences for North by Northwest (1959) and Psycho (1960) made it a form.+Timing+Each word lands in 0.3 to 0.5 seconds with a small overshoot, then the line holds long enough to read.+Assets+A typeface with enough weights. No pictures.+Sound+Cut to the voice or the beat. Practice note.+What makes it read as this+Type is the image; nothing competes with it+Strong contrast of size and weight+Words arrive in reading order, on the beat+One idea per frame+What makes it look wrong+Words faster than they can be read+Effects that add no meaning+Everything moving at once+How to build it+HyperFrames: split text into inline-block spans and stagger with GSAP+Canvas: fillText with a transform per word+Timing from the narration: one start time per word+Hold for (words / 3) + 0.5 seconds before the next line+Type, data and retro · smooth · HyperFrames (SVG, canvas)+Infographic and data animation+A chart that builds in a sensible order: axes, then the data from an honest baseline, then the exact values. From Playfair's first charts in 1786 to animated infographics in music videos in 2002.+Timing+Axes in about half a second, each series over 0.8 to 1.5 seconds with an ease-out, then a hold to read.+Assets+The data, with its source.+Sound+A tick or tone per value, a bed that stays out of the way. Practice note.+What makes it read as this+One chart type that fits the data+Direct labels, not a legend+An honest axis: bars start at zero+One colour for the point being made+What makes it look wrong+Numbers that were not checked+3D bars+An axis cut off to exaggerate a difference+How to build it+Drive the chart from one time value; never use a chart library's own transitions+Bars grow from the baseline; counters show the rounded value as it grows and end on the exact figure+SVG or canvas with scale maths; D3 scales are enough+Every number needs a source in the brief+Type, data and retrobrief2mp4 art forms+Type, data and retro · smooth · HyperFrames (DOM, canvas)+Lyric video+The words of a song as the main image, each line timed to the vocal and the active word lit. Lyric text appears in music videos from the 1980s; the format took off on video sites in the 2010s.+Timing+Locked to the music. A word changes exactly on its beat; a few frames late is visible.+Assets+The audio, with the right to use it, and its word timings.+Sound+The song.+What makes it read as this+Three to eight words on screen+The word being sung is brighter or larger+A background that never fights the text+One typographic system for the whole song+What makes it look wrong+Timing that drifts+Text over a busy background+Music you have no licence for+How to build it+Word start times from forced alignment or a beat grid+Compute the active line and word from t+A pulse from the beat phase: 1 - (beat % 1) drives scale and background+Measure words first so the line is centred+Type, data and retro · 30 changes a second · HyperFrames (canvas) or Three.js post-processing+VHS and glitch+The damage of old tape and broken data: colour that bleeds sideways, scan lines, a band of noise at the bottom, sudden torn slices. VHS records colour at far lower resolution than brightness, which is why colour smears. Glitch art uses such errors on purpose.+Timing+Full frame rate, with bursts of a fifth of a second. Seeds come from the frame number so every render matches.+Assets+All in code.+Sound+Tape hiss, hum, a click on each burst. Practice note.+What makes it read as this+Colour offset from brightness by a few pixels and softer+Scan lines+A tracking band of noise near the bottom+A date stamp in a blocky face+Glitch: slices displaced sideways, in short bursts+What makes it look wrong+Constant glitching, which tires the eye+Glitching text the viewer has to read+Unseeded randomness, so two renders differ+How to build it+Draw the clean frame to its own canvas first, then the damage on top+Redraw it in thin horizontal strips with a per-strip offset; large offsets only during a burst+Chroma bleed: a blurred copy drawn again a few pixels to the side with screen+Scan lines: a dark row every third pixel+Three.js: FilmPass, RGBShiftShader and GlitchPass exist; GlitchPass picks its own random timing, so check it repeats before relying on it+Type, data and retrobrief2mp4 art forms+Type, data and retro · smooth · HyperFrames (SVG, canvas)+Blueprint and technical drawing+White lines on blue: a grid, an object drawn in outline, centre lines, dimensions and a title block. The blueprint is a cyanotype copy of an engineering drawing, introduced in 1842: white lines on blue.+Timing+Steady: lines draw on, then dimensions and labels fade in. No bounce.+Assets+All in code.+Sound+A pen plotter, a pencil. Practice note.+What makes it read as this+White or pale lines on a deep blue+A faint grid+Dashed centre lines, dimension lines with end ticks+A title block in a monospace face+What makes it look wrong+A neon blue+Labels that say nothing+Perspective in the drawing+How to build it+Grid: thin lines every 30 px at low opacity (CSS: repeating-linear-gradient)+Draw-on with stroke-dashoffset or a partial polyline+Dashed centre lines with setLineDash+Dimension lines: a line, two end ticks and a centred label+Type, data and retro · 24 changes a second · HyperFrames (canvas, SVG)+Neon sign+Glass tubes bent into letters and lit: a bright core, a coloured glow, a dark wall, tubes that light one by one and sometimes flicker. Glass tubing filled with gas and lit by electrodes; sections can be switched in sequence.+Timing+Tubes come on in order with a short stutter each; now and then one dims for a frame.+Assets+Letter paths in code. A brick or plaster texture can be drawn.+Sound+A low electrical hum, a tick as each tube lights. Practice note.+What makes it read as this+One continuous line per letter, one width+A white-hot core inside a coloured halo+A dark wall behind+Letters light in sequence+What makes it look wrong+A glow so wide the word cannot be read+Filled letters instead of a single tube+Flicker that differs between renders+How to build it+Each tube is drawn three times: a wide faint stroke, a medium one, a thin white core, all with shadowBlur+Add them with the lighter blend (CSS: mix-blend-mode: plus-lighter or screen)+Flicker from hash(frame, tube), never from a random call+Three.js: UnrealBloomPass for bloom on emissive geometry+Referencebrief2mp4 art forms+Tools that exist, by name+Where+What+Used for+SVG filter+feTurbulence+noise: grain, the source for every rough edge+SVG filter+feDisplacementMap+bend a shape by that noise: cut edges, line boil, ink bleed+SVG filter+feMorphology+thicken or thin: outlines+SVG filter+feColorMatrix, feComponentTransfer+recolour, threshold, separate one ink, sepia+CSS+steps()+held drawings in a CSS animation+CSS+mix-blend-mode: multiply+ink printed over ink, paper grain over everything+CSS+mix-blend-mode: screen, plus-lighter+glow that adds up: neon, chroma bleed+CSS+image-rendering: pixelated+pixel art scaled with hard edges+Canvas+globalCompositeOperation+the same blends on a canvas, and destination-out to cut marks out of a shape+Canvas+fill("evenodd")+holes that are part of a figure: shadow puppets+GSAP+ease: "steps(n)"+held drawings in a tween+Three.js+MeshToonMaterial with a gradientMap+light in hard bands: cel shading+Three.js+a second mesh, larger, back faces only+an outline (the inverted hull); OutlineEffect packages it+Three.js+flatShading: true+low-poly facets+Three.js+InstancedMesh+thousands of voxels in one draw call+Three.js examples+HalftonePass, RenderPixelatedPass, FilmPass, RGBShiftShader, GlitchPass, UnrealBloomPass+post-processing for print, pixel, tape and glow looks+Three.js ships no watercolour pass and no VHS pass: both are built from the pieces above. Its GlitchPass chooses its own random timing, so check that it repeats before relying on it in a render.+When Blender is the better tool+Claymation: Use Blender when the clay needs real subsurface scattering, soft area-light shadows or sculpted detail.+Paper cut-out: Use Blender for real folded paper with thickness and light passing through it.+Felt and fabric craft: Use Blender hair or fur for real fibre fuzz on 3D figures.+Origami: Use Blender when the paper has to bend or show thickness.+Shadow puppetry: Use Blender for real light through translucent coloured leather.+Anime and cel shading: Use Blender for Freestyle line art and shader-to-RGB ramps on real characters.+Rotoscope look: Dedicated tools do true painterly rotoscoping better than a browser.+Isometric: Use Blender for bevelled, ambient-occluded isometric scenes.+Low-poly 3D: Use Blender for modelling and baked light.+3D product render: Use Blender when the brief asks for photoreal glass, caustics or depth of field.+Wiring a look into a composition+GSAP owns the clock and the look only draws. Vendor GSAP and Three.js into the project so a render never touches the network.+Referencebrief2mp4 art forms+Sources and what was verified+What this guide rests on, and where its limits are.+Verified by running it+All 31 demos pass the browser test: each paints, changes over time and repeats exactly.+The source of the demos contains no clock, timer or unseeded random call; a test enforces it.+The router and the generated reference pages have unit tests.+Not verified+No art-form video was rendered through HyperFrames. The demos follow its rules and were tested as browser pictures.+Tested on macOS with Chrome 157 only.+Frame-rate conventions come from encyclopaedia articles, not from studio production notes.+Lines marked "practice note" in the reference pages (most sound and pacing advice, some visual rules) are working advice, not sourced facts.+Entries with a sourcing note are thinner than the rest: Felt and fabric craft, Watercolour, Motion comic, Linocut and woodcut print, 3D product render.+Published sources+The repositories studied for techniques, with their licences, are listed in the changelog entry and in the project notes. No code from another project is copied into brief2mp4 for this work. Facts were checked on 17 November 2026.diff --git a/docs/art-forms-guide/guide.css b/docs/art-forms-guide/guide.cssnew file mode 100644index 0000000..b31ed95--- /dev/null+++ b/docs/art-forms-guide/guide.css@@ -0,0 +1,62 @@+/* brief2motion guide: print stylesheet for WeasyPrint. A4, the brief2mp4 family look. */+@font-face { font-family: Inter; src: url('fonts/inter-400.woff2'); font-weight: 400; }+@font-face { font-family: Inter; src: url('fonts/inter-700.woff2'); font-weight: 700; }+@font-face { font-family: Space; src: url('fonts/space-grotesk-700.woff2'); font-weight: 700; }+@font-face { font-family: Mono; src: url('fonts/DejaVuSansMono.ttf'); }+@page { size: A4; margin: 16mm 16mm 18mm; background: #F2EDE4;+ @bottom-left { content: 'QUALIXAR / BRIEF2MP4 / THE ART FORMS GUIDE'; font: 7pt Inter; color: #756F65; letter-spacing: .4pt; }+ @bottom-right { content: counter(page); font: 700 9pt Inter; color: #16130F; } }+@page :first { background: #16130F; @bottom-left { content: none; } @bottom-right { content: none; } }+* { box-sizing: border-box; }+body { margin: 0; color: #16130F; font: 400 9.8pt/1.5 Inter, sans-serif; }+a { color: inherit; text-decoration: none; }+p { margin: 0 0 2.8mm; orphans: 3; widows: 3; }+h1 { font: 700 25pt/1.06 Space, Inter, sans-serif; letter-spacing: -.7pt; margin: 3mm 0 4mm; max-width: 165mm; bookmark-level: 1; }+h2 { font: 700 13.5pt/1.2 Space, Inter, sans-serif; margin: 5.5mm 0 2.2mm; break-after: avoid; bookmark-level: 2; }+h3 { font: 700 10pt/1.3 Inter, sans-serif; margin: 3.5mm 0 1.2mm; break-after: avoid; bookmark-level: none; }+b, strong { font-weight: 700; }+section { break-before: page; }+section.cover { break-before: auto; color: #F2EDE4; height: 262mm; position: relative; }+.eyebrow { font: 700 7pt Inter; letter-spacing: 1.3pt; text-transform: uppercase; color: #FF5A1F; border-top: 1pt solid #16130F; padding-top: 2.2mm; margin-bottom: 1mm; }+.eyebrow span { float: right; color: #756F65; letter-spacing: .5pt; }+.cover .eyebrow { border-color: #F2EDE4; } .cover .eyebrow span { color: #C9C1B5; }+.cover h1 { font-size: 60pt; letter-spacing: -2.2pt; margin-top: 16mm; color: #F2EDE4; }+.cover h1 i { font-style: normal; color: #FF5A1F; }+.cover .deck { font: 700 23pt/1.14 Space; max-width: 150mm; margin-top: 4mm; }+.cover .strap { font-size: 11pt; color: #C9C1B5; max-width: 150mm; margin-top: 6mm; }+.cover img.mark { width: 46mm; margin-top: 16mm; }+.cover .by { position: absolute; bottom: 0; left: 0; right: 0; font-size: 8.5pt; color: #C9C1B5; border-top: .5pt solid #5c564c; padding-top: 3mm; }+.lead { font-size: 11.5pt; line-height: 1.45; max-width: 160mm; margin-bottom: 4mm; }+pre { font: 7.6pt/1.5 Mono, monospace; white-space: pre-wrap; overflow-wrap: anywhere; background: #16130F; color: #F2EDE4; padding: 3.5mm; border-radius: 1.6mm; margin: 2.5mm 0 3.5mm; break-inside: avoid; }+code { font: 8.3pt Mono, monospace; color: #385E8A; overflow-wrap: anywhere; }+pre code { color: inherit; font-size: inherit; }+table { border-collapse: collapse; width: 100%; font-size: 8.6pt; line-height: 1.38; margin: 2.5mm 0 4mm; }+thead { display: table-header-group; }+th { text-align: left; color: #756F65; font-size: 7.3pt; text-transform: uppercase; letter-spacing: .3pt; border-bottom: 1.2pt solid #16130F; padding: 1.8mm 2mm 1.8mm 0; }+td { vertical-align: top; border-bottom: .5pt solid #C9C1B5; padding: 2mm 2.5mm 2mm 0; }+tr { break-inside: avoid; }+ul, ol { padding-left: 4.5mm; margin: 1.5mm 0 3.5mm; }+li { margin-bottom: 1.3mm; padding-left: .8mm; }+figure { margin: 3mm 0 4mm; break-inside: avoid; }+figure img { width: 100%; display: block; border: .5pt solid #C9C1B5; }+figcaption { font-size: 7.8pt; line-height: 1.4; color: #756F65; margin-top: 1.6mm; }+.two { display: flex; gap: 5mm; } .two > * { flex: 1; min-width: 0; }+.three { display: flex; gap: 4mm; } .three > * { flex: 1; min-width: 0; }+aside { border-left: 2.5pt solid #FF5A1F; background: #E9E2D6; padding: 3mm 4mm; margin: 3.5mm 0; break-inside: avoid; }+aside b { font-size: 8.8pt; } aside p { margin: 1.4mm 0 0; font-size: 9.2pt; }+.toc a { display: block; border-bottom: .5pt solid #C9C1B5; padding: 1.9mm 0; font-size: 10pt; }+.toc a::after { content: target-counter(attr(href), page); float: right; font: 700 10.5pt Space; color: #FF5A1F; }+.style { break-inside: avoid; border-top: 1pt solid #16130F; padding-top: 2.2mm; margin-bottom: 3.5mm; }+.style h2 { margin-top: 0; }+.style .fam { font: 700 7pt Inter; letter-spacing: 1pt; text-transform: uppercase; color: #756F65; }+.style img { width: 100%; border: .5pt solid #C9C1B5; border-radius: 1.2mm; }+.style .cols { display: flex; gap: 5mm; margin-top: 2mm; } .style .cols > div { flex: 1; min-width: 0; font-size: 8.4pt; line-height: 1.38; }+.style .cols > div.pic { flex: 1.15; }+.style h3 { font-size: 7.6pt; text-transform: uppercase; letter-spacing: .4pt; color: #756F65; margin: 2mm 0 .8mm; }+.style ul { margin: 0 0 1.5mm; padding-left: 3.6mm; } .style li { margin-bottom: .6mm; }+.style p { margin-bottom: 1.2mm; }+.metric { font: 700 26pt/1.05 Space; color: #FF5A1F; }+.metrics { display: flex; gap: 5mm; border-top: 1pt solid #C9C1B5; padding-top: 3.5mm; margin: 4mm 0; }+.metrics > div { flex: 1; } .metrics p { font-size: 8.3pt; margin-top: 1.5mm; }+.small { font-size: 8.6pt; } .muted { color: #756F65; }+.src { font-size: 7.4pt; color: #756F65; overflow-wrap: anywhere; }diff --git a/docs/art-forms-guide/img/blueprint.jpg b/docs/art-forms-guide/img/blueprint.jpgnew file mode 100644index 0000000..cd0f5c9Binary files /dev/null and b/docs/art-forms-guide/img/blueprint.jpg differdiff --git a/docs/art-forms-guide/img/cel-shaded.jpg b/docs/art-forms-guide/img/cel-shaded.jpgnew file mode 100644index 0000000..f29ada2Binary files /dev/null and b/docs/art-forms-guide/img/cel-shaded.jpg differdiff --git a/docs/art-forms-guide/img/chalkboard.jpg b/docs/art-forms-guide/img/chalkboard.jpgnew file mode 100644index 0000000..faa49caBinary files /dev/null and b/docs/art-forms-guide/img/chalkboard.jpg differdiff --git a/docs/art-forms-guide/img/claymation.jpg b/docs/art-forms-guide/img/claymation.jpgnew file mode 100644index 0000000..58e9a6aBinary files /dev/null and b/docs/art-forms-guide/img/claymation.jpg differdiff --git a/docs/art-forms-guide/img/collage.jpg b/docs/art-forms-guide/img/collage.jpgnew file mode 100644index 0000000..3bd5f40Binary files /dev/null and b/docs/art-forms-guide/img/collage.jpg differdiff --git a/docs/art-forms-guide/img/felt.jpg b/docs/art-forms-guide/img/felt.jpgnew file mode 100644index 0000000..3d0b238Binary files /dev/null and b/docs/art-forms-guide/img/felt.jpg differdiff --git a/docs/art-forms-guide/img/flat-explainer.jpg b/docs/art-forms-guide/img/flat-explainer.jpgnew file mode 100644index 0000000..9ef9d2dBinary files /dev/null and b/docs/art-forms-guide/img/flat-explainer.jpg differdiff --git a/docs/art-forms-guide/img/infographic.jpg b/docs/art-forms-guide/img/infographic.jpgnew file mode 100644index 0000000..2005b5cBinary files /dev/null and b/docs/art-forms-guide/img/infographic.jpg differdiff --git a/docs/art-forms-guide/img/ink-wash.jpg b/docs/art-forms-guide/img/ink-wash.jpgnew file mode 100644index 0000000..f65a356Binary files /dev/null and b/docs/art-forms-guide/img/ink-wash.jpg differdiff --git a/docs/art-forms-guide/img/isometric.jpg b/docs/art-forms-guide/img/isometric.jpgnew file mode 100644index 0000000..86d7ad0Binary files /dev/null and b/docs/art-forms-guide/img/isometric.jpg differdiff --git a/docs/art-forms-guide/img/kinetic-type.jpg b/docs/art-forms-guide/img/kinetic-type.jpgnew file mode 100644index 0000000..a89000eBinary files /dev/null and b/docs/art-forms-guide/img/kinetic-type.jpg differdiff --git a/docs/art-forms-guide/img/line-art.jpg b/docs/art-forms-guide/img/line-art.jpgnew file mode 100644index 0000000..103a4cdBinary files /dev/null and b/docs/art-forms-guide/img/line-art.jpg differdiff --git a/docs/art-forms-guide/img/linocut.jpg b/docs/art-forms-guide/img/linocut.jpgnew file mode 100644index 0000000..a5ebc46Binary files /dev/null and b/docs/art-forms-guide/img/linocut.jpg differdiff --git a/docs/art-forms-guide/img/low-poly.jpg b/docs/art-forms-guide/img/low-poly.jpgnew file mode 100644index 0000000..e0e2688Binary files /dev/null and b/docs/art-forms-guide/img/low-poly.jpg differdiff --git a/docs/art-forms-guide/img/lyric-video.jpg b/docs/art-forms-guide/img/lyric-video.jpgnew file mode 100644index 0000000..8eb9d9aBinary files /dev/null and b/docs/art-forms-guide/img/lyric-video.jpg differdiff --git a/docs/art-forms-guide/img/motion-comic.jpg b/docs/art-forms-guide/img/motion-comic.jpgnew file mode 100644index 0000000..ebf1307Binary files /dev/null and b/docs/art-forms-guide/img/motion-comic.jpg differdiff --git a/docs/art-forms-guide/img/neon-sign.jpg b/docs/art-forms-guide/img/neon-sign.jpgnew file mode 100644index 0000000..63433d8Binary files /dev/null and b/docs/art-forms-guide/img/neon-sign.jpg differdiff --git a/docs/art-forms-guide/img/origami.jpg b/docs/art-forms-guide/img/origami.jpgnew file mode 100644index 0000000..d36eba7Binary files /dev/null and b/docs/art-forms-guide/img/origami.jpg differdiff --git a/docs/art-forms-guide/img/paper-cutout.jpg b/docs/art-forms-guide/img/paper-cutout.jpgnew file mode 100644index 0000000..430109eBinary files /dev/null and b/docs/art-forms-guide/img/paper-cutout.jpg differdiff --git a/docs/art-forms-guide/img/pixel-art.jpg b/docs/art-forms-guide/img/pixel-art.jpgnew file mode 100644index 0000000..d6fc53cBinary files /dev/null and b/docs/art-forms-guide/img/pixel-art.jpg differdiff --git a/docs/art-forms-guide/img/product-render.jpg b/docs/art-forms-guide/img/product-render.jpgnew file mode 100644index 0000000..d29e8d6Binary files /dev/null and b/docs/art-forms-guide/img/product-render.jpg differdiff --git a/docs/art-forms-guide/img/risograph.jpg b/docs/art-forms-guide/img/risograph.jpgnew file mode 100644index 0000000..2dba9a7Binary files /dev/null and b/docs/art-forms-guide/img/risograph.jpg differdiff --git a/docs/art-forms-guide/img/rotoscope.jpg b/docs/art-forms-guide/img/rotoscope.jpgnew file mode 100644index 0000000..cc29663Binary files /dev/null and b/docs/art-forms-guide/img/rotoscope.jpg differdiff --git a/docs/art-forms-guide/img/rubber-hose.jpg b/docs/art-forms-guide/img/rubber-hose.jpgnew file mode 100644index 0000000..1da5fa8Binary files /dev/null and b/docs/art-forms-guide/img/rubber-hose.jpg differdiff --git a/docs/art-forms-guide/img/shadow-puppet.jpg b/docs/art-forms-guide/img/shadow-puppet.jpgnew file mode 100644index 0000000..be0ed3aBinary files /dev/null and b/docs/art-forms-guide/img/shadow-puppet.jpg differdiff --git a/docs/art-forms-guide/img/stop-motion.jpg b/docs/art-forms-guide/img/stop-motion.jpgnew file mode 100644index 0000000..2efbb5cBinary files /dev/null and b/docs/art-forms-guide/img/stop-motion.jpg differdiff --git a/docs/art-forms-guide/img/upa-midcentury.jpg b/docs/art-forms-guide/img/upa-midcentury.jpgnew file mode 100644index 0000000..297e633Binary files /dev/null and b/docs/art-forms-guide/img/upa-midcentury.jpg differdiff --git a/docs/art-forms-guide/img/vhs-glitch.jpg b/docs/art-forms-guide/img/vhs-glitch.jpgnew file mode 100644index 0000000..9d7449fBinary files /dev/null and b/docs/art-forms-guide/img/vhs-glitch.jpg differdiff --git a/docs/art-forms-guide/img/voxel.jpg b/docs/art-forms-guide/img/voxel.jpgnew file mode 100644index 0000000..5ec3a32Binary files /dev/null and b/docs/art-forms-guide/img/voxel.jpg differdiff --git a/docs/art-forms-guide/img/watercolour.jpg b/docs/art-forms-guide/img/watercolour.jpgnew file mode 100644index 0000000..ab40191Binary files /dev/null and b/docs/art-forms-guide/img/watercolour.jpg differdiff --git a/docs/art-forms-guide/img/whiteboard.jpg b/docs/art-forms-guide/img/whiteboard.jpgnew file mode 100644index 0000000..73762bcBinary files /dev/null and b/docs/art-forms-guide/img/whiteboard.jpg differdiff --git a/docs/art-forms-guide/render.py b/docs/art-forms-guide/render.pynew file mode 100644index 0000000..1f0c15d--- /dev/null+++ b/docs/art-forms-guide/render.py@@ -0,0 +1,52 @@+#!/usr/bin/env python3+"""render.py: turn brief2mp4-art-forms.html into brief2mp4-art-forms.pdf with WeasyPrint, then check it.++ python3 docs/guide/render.py++Checks after rendering: the page count, that every contents entry points at a real page, that no text runs off a+page, and the document metadata. Writes qa/contact-NN.jpg sheets to look through (not kept in the repository).+"""+import os+import sys+from pathlib import Path++os.environ.setdefault('DYLD_FALLBACK_LIBRARY_PATH', '/opt/homebrew/lib') # where Homebrew puts Pango on Apple silicon+from weasyprint import HTML # noqa: E402+import pymupdf # noqa: E402++HERE = Path(__file__).resolve().parent+PDF = HERE / 'brief2mp4-art-forms.pdf'+HTML(filename=str(HERE / 'brief2mp4-art-forms.html')).write_pdf(str(PDF), pdf_tags=True)++doc = pymupdf.open(PDF)+problems = []+for n, page in enumerate(doc, 1):+ for block in page.get_text('dict')['blocks']:+ for line in block.get('lines', []):+ r = pymupdf.Rect(line['bbox'])+ if r.x1 > page.rect.width + 0.5 or r.y1 > page.rect.height + 0.5 or r.x0 < -0.5:+ problems.append(f'page {n}: text outside the page: {"".join(s["text"] for s in line["spans"])[:60]!r}')+links = [l for l in doc[1].get_links() if l['kind'] in (pymupdf.LINK_GOTO, pymupdf.LINK_NAMED)]+if len(links) < 6:+ problems.append(f'contents page has only {len(links)} links')+if doc.metadata.get('author') != 'Varun Pratap Bhardwaj':+ problems.append('author metadata is missing')+qa = HERE / 'qa'+qa.mkdir(exist_ok=True)+if '--sheets' in sys.argv:+ from PIL import Image+ thumbs = []+ for page in doc:+ pix = page.get_pixmap(matrix=pymupdf.Matrix(0.42, 0.42), alpha=False)+ thumbs.append(Image.frombytes('RGB', [pix.width, pix.height], pix.samples))+ for start in range(0, len(thumbs), 15):+ batch = thumbs[start:start + 15]+ w, h = batch[0].size+ sheet = Image.new('RGB', (5 * (w + 8) + 8, 3 * (h + 8) + 8), '#8a8a8a')+ for i, im in enumerate(batch):+ sheet.paste(im, (8 + (i % 5) * (w + 8), 8 + (i // 5) * (h + 8)))+ sheet.save(qa / f'contact-{start + 1:02d}.jpg', quality=82)+print(f'{PDF.name}: {len(doc)} pages, {PDF.stat().st_size // 1024} KB')+for line in problems:+ print('PROBLEM', line)+sys.exit(1 if problems else 0)diff --git a/docs/art-forms-guide/requirements.txt b/docs/art-forms-guide/requirements.txtnew file mode 100644index 0000000..55ace05--- /dev/null+++ b/docs/art-forms-guide/requirements.txt@@ -0,0 +1,2 @@+weasyprint==70.0+pymupdf==2.1diff --git a/tests/art_forms/check_looks.mjs b/tests/art_forms/check_looks.mjsindex 3669a7f..226ee2b 100644--- a/tests/art_forms/check_looks.mjs+++ b/tests/art_forms/check_looks.mjs@@ -2,7 +2,8 @@// tests/art_forms/check_looks.mjs: prove every art-form look in looks.js draws, moves and repeats exactly.// node tests/art_forms/check_looks.mjs check all, print PASS or FAIL per look// node tests/art_forms/check_looks.mjs --sheet out.jpg also write a contact sheet (one frame per look)-// node tests/art_forms/check_looks.mjs riso felt only these+// node tests/art_forms/check_looks.mjs --frames dir also write one PNG per look+// node tests/art_forms/check_looks.mjs risograph felt only these// For each look, in headless Chrome: draw t = 0.4, 1.5 and 2.3 s; the three pictures must differ (it animates) and// must not be blank; then draw 1.5 s again, which must match the first 1.5 s pixel for pixel (it is a pure function// of time and keeps no state). One browser, one look at a time. Needs Chrome and, for the five 3D looks, the network@@ -19,7 +20,9 @@ const DIR = path.resolve(HERE, '..', '..', 'plugin', 'skills', 'brief2mp4', 'artconst DEPS = process.env.BRIEF2MP4_DEPS || path.join(os.homedir(), '.cache', 'brief2mp4', 'deps');const PW = '1.65.1';const args = process.argv.slice(2), si = args.indexOf('--sheet'), sheet = si >= 0 ? args[si + 1] : null;-const only = args.filter((a, i) => !a.startsWith('--') && i !== si + 1);+const fi = args.indexOf('--frames'), framesDir = fi >= 0 ? args[fi + 1] : null; // --frames <dir>: one PNG per look, at 2.2 s+const only = args.filter((a, i) => !a.startsWith('--') && !(si >= 0 && i === si + 1) && !(fi >= 0 && i === fi + 1));+if (framesDir) fs.mkdirSync(framesDir, { recursive: true });async function playwright() {const entry = path.join(DEPS, 'node_modules', 'playwright-core', 'index.mjs');@@ -70,7 +73,7 @@ for (const id of ids) {const moves = new Set([a.hash, b.hash, c.hash]).size === 3, repeats = b.hash === b2.hash, painted = Math.max(a.painted, b.painted, c.painted) > 0.005;ok = moves && repeats && painted && errors.length === 0;detail = `moves=${moves}, same t twice matches=${repeats}, painted ${(Math.max(a.painted, b.painted, c.painted) * 100).toFixed(0)}%${errors.length ? `, errors: ${errors[0].slice(0, 140)}` : ''}`;- if (sheet) { await page.evaluate((x) => window.__draw(x.t), { t: 2.2 }); thumbs.push({ id, png: (await page.locator(`#c-${id}`).screenshot()).toString('base64') }); }+ if (sheet || framesDir) { await page.evaluate((x) => window.__draw(x.t), { t: 2.2 }); const png = await page.locator(`#c-${id}`).screenshot(); if (sheet) thumbs.push({ id, png: png.toString('base64') }); if (framesDir) fs.writeFileSync(path.join(framesDir, `${id}.png`), png); }} catch (e) { detail = String(e.message || e).split('\n')[0]; }results.push({ id, ok, detail }); console.log(`${ok ? 'PASS' : 'FAIL'} ${id} (${detail})`);await page.close();