Cutaway: the method, from one image to a 3D film that takes itself apart
The job description Claude reads before every object, the checklist format with a full example, every prompt from the reference image to the sound, and the lessons that became lines in the brief. No code and no renders. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,47 @@
|
||||
# The checklist
|
||||
|
||||
The job description covers every animal. The checklist covers one picture. Write it before the first line of code: what does this picture stand on, in numbered lines a reader could check against it?
|
||||
|
||||
## Rules for writing one
|
||||
|
||||
- **10 to 12 lines.** Fewer misses features; more turns into a spec nobody grades.
|
||||
- **Order:** silhouette and view first, then the signature feature, then materials, then the accent colour, then density.
|
||||
- **Every vague word gets a number.** "Thin" became "0.15 to 0.25 of the leg's thickness" after thin bristles came back as quills.
|
||||
- **Write "never" next to the default you are fighting.** "Clear glass, never a solid white shell." Without it the glass turns into one more white shell.
|
||||
- **Proportions in numbers, measured off the picture.** Height, head and jaw as shares of the body length.
|
||||
- **The last line is always density:** the dark share against the reference.
|
||||
|
||||
## Template
|
||||
|
||||
```
|
||||
1. Silhouette and view: [the shape, what it stands or floats on, the hero angle]. Proportions measured off the picture: [height / length, head / length, limb or jaw / length].
|
||||
2. The signature feature: [the one thing a viewer remembers: open jaws, a glass head, a raised tail]. [Size in numbers.]
|
||||
3. [The second feature.] NEVER [the default that kills it].
|
||||
4. Plates: separate curved plates in 3 sizes with gaps over the mechanism. Never one smooth shell.
|
||||
5. Eyes: [size, lens, ring].
|
||||
6. [Glass or open section]: what shows through it, in counts.
|
||||
7. Limbs or fins: [how many, their pose, their membranes or bristles, with thickness in numbers].
|
||||
8. Small parts: rivets, hoses, pistons in every gap.
|
||||
9. Green only as accents: [exactly where]. No dots sprinkled over shells.
|
||||
10. At 900 px wide it reads as dense as the approved still.
|
||||
11. Dark share at least 0.8 of the reference's ([the reference's number]).
|
||||
```
|
||||
|
||||
## Example: a robotic piranha, 12 lines
|
||||
|
||||
```
|
||||
1. A deep-bodied piranha: body height 0.57 of its length without the tail fin, head 0.44 of the length, jaws (hinge to front) 0.36 of the length. A big forked tail fin on a narrow stalk. Front 3/4, slightly from above, floating over a soft floor shadow.
|
||||
2. The mouth gapes wide: the opening at the front about as tall as the jaws are long (upper jaw up about 25°, lower down about 35°). Long curved glass fangs in 2 rows along both rims, the front ones about a quarter of the head height, tips glowing green.
|
||||
3. A blunt front: the jaw ends rounded or squared, the lower jaw a little wider and ahead of the upper. NEVER a long low crocodile snout.
|
||||
4. Head armour: separate curved white plates in 3 sizes with gaps, riveted. NEVER one smooth head shell.
|
||||
5. A thick brow plate slanting down over the eye toward the snout.
|
||||
6. The eye: a big glossy black lens with a thin green ring and 2 to 3 dark rings around it, under the brow.
|
||||
7. The mid-body is a CLEAR glass barrel held by 5 to 6 curved white bands, with 2 to 3 big gears (0.3 to 0.4 of the body height) right behind the glass. NEVER a solid white side.
|
||||
8. The tail stalk: 3 to 4 cylindrical segments, white collars, dark joints, thin green rings between them.
|
||||
9. Fins: milky frosted membranes, thin dark rays, serrated edges glowing green; a dorsal fin of about 6 broad panels between spines; the tail fin as tall as the body.
|
||||
10. The throat behind the fangs: a tunnel of rings lit green, visible between the jaws from the hero angle.
|
||||
11. Green only as lines: plate edges, the eye ring, fin edges, coils, the gum line. Zero isolated green dots.
|
||||
12. Dark share at least 0.8 of the reference's.
|
||||
```
|
||||
|
||||
Lines 1 and 3 were added after round 2 came back as a crocodile with jaws at 0.52 of the body length. Round 3, with the numbers, landed at 0.35.
|
||||
@@ -0,0 +1,54 @@
|
||||
# Job description
|
||||
|
||||
Copy this file into your project. Tell Claude to read it before every animal. When you correct Claude, the correction goes into this file, one line per mistake.
|
||||
|
||||
```
|
||||
You build robotic animals from a reference image, in three.js, entirely in code.
|
||||
|
||||
THE LOOK
|
||||
- white shells with clearcoat and an environment map
|
||||
- green as a sparse accent only: tips, rims, edge lines, a bezel, joint rings; never dots sprinkled over a shell
|
||||
- dark mechanism in 2 levels: big parts (gears, rings, actuators) and about 260 small ones (pistons, hoses, screws, wiring); cut windows into the shells so the dark mass shows
|
||||
- glowing parts (coils, rings) sit inside the mechanism or behind clear glass, never on the surface
|
||||
- eyes as glossy black lenses with a thin green bezel and a small pupil
|
||||
- membranes milky and frosted with thin veins
|
||||
- every limb has its own pose and segment lengths, never a row of identical parts
|
||||
- bristles and spikes thin and short: 0.15 to 0.25 of the limb's thickness
|
||||
- one main set of limbs per animal (legs, or wings, or tentacles)
|
||||
- near-white studio, soft floor shadow
|
||||
|
||||
THE ORDER
|
||||
1. Measure the reference first: body height, head length, jaw or limb length, as shares of the body length. Write the numbers down.
|
||||
2. Build every part that will come apart as its own group, with a named anchor point, so the film can open it later.
|
||||
3. Render one still at 1600x900 posed like the reference.
|
||||
4. Stack the reference, your still and an approved still side by side, plus the same stack at 900 px wide. Grade every checklist line yes, partial or no. Grade against the picture, not against what you remember building.
|
||||
5. Grade one more line every round: at 900 px wide, does it look as dense as the approved still?
|
||||
6. Measure: the share of dark pixels (luma under 80) in the animal's bounding box, yours against the reference's. Below 0.8 of it is a no. Measure your proportions the same way as the reference's.
|
||||
7. Stop after round 2 and show me. Nothing gets filmed until I say yes.
|
||||
|
||||
THE CAMERA
|
||||
- frame 0 is the front 3/4 hero view, the animal big and already moving
|
||||
- every teardown gets its own side, height and distance, aimed at the part itself, pushing in while it hangs open: an eye in macro, a tail from behind, a back from above, a jaw from below; never two beats from the same spot
|
||||
- the part being opened stays in view; the rest of the animal may run off the frame
|
||||
- smooth paths only: the camera never copies a wing beat or a footstep
|
||||
- visible wing beats stay slow, 1.5 to 2.5 Hz
|
||||
|
||||
THE FILM
|
||||
- port the approved film of the animal whose body is closest: the same beat times and moves, distances scaled to the animal; change the body only
|
||||
- a part opens in about 1 s, holds with its parts still spinning, closes in 0.5 s; a beat every 2 to 3 s
|
||||
- then a full explode on a turntable, a fast reassembly while it turns, and an exit
|
||||
- the page around it: an invented product name and title, one button per part that a cursor clicks, live cards that move with the parts, labels on the parts while they hang open
|
||||
- everything is a pure function of time t; the script lives in one file the picture and the sound both read
|
||||
|
||||
THE SHORT VERSION
|
||||
- its own script: the opening, one part, the explode, the exit; never pieces of the long film joined together
|
||||
- its own opening and its own exit, different from every other animal's
|
||||
- if the scene runs longer than the target, play it back faster (up to about 1.15x) and stretch the sound by the same factor
|
||||
```
|
||||
|
||||
## Why these lines
|
||||
|
||||
- **"Grade against the picture"** keeps the self-check honest. Claude grades its own memory of the build as "yes" otherwise.
|
||||
- **"Nothing gets filmed until I say yes"** keeps tokens from burning on a film of a toy.
|
||||
- **"The correction goes into this file"** is how animal 5 stops repeating the mistakes of animal 1.
|
||||
- **The camera section** came from a film where every beat sat between 20° and 50° on one side, at one height and one distance. It looked parked.
|
||||
+17
@@ -0,0 +1,17 @@
|
||||
# Lessons
|
||||
|
||||
Every mistake below became one line in the job description. The next animal starts with all of them.
|
||||
|
||||
| What happened | What it looked like | The line it added |
|
||||
|---|---|---|
|
||||
| The tarantula's checklist said "thin bristles" | Quills twice the length they should be | Bristles and spikes are 0.15 to 0.25 of the limb's thickness |
|
||||
| A rule kept the whole octopus in frame | The camera pulled back to a flat view from above, arms tucked in: a toy | Only the part being opened has to stay in view |
|
||||
| A moth, a hydra and a fly graded themselves dense enough | Clean white diagrams. The moth was thrown out after 9 rounds | Density gets measured: dark share at least 0.8 of the reference's |
|
||||
| The piranha passed on density in round 2 | A crocodile: jaws at 0.52 of the body length against 0.37 in the picture | Proportions get measured off the picture before the first line of code |
|
||||
| A flying octopus and a scorpion-squid | Wings and tentacles fighting for the same half second | One main set of limbs per animal |
|
||||
| Glow dots sprinkled over shells to add accents | Polka dots: the look that sank the moth | Green only as lines, never isolated dots |
|
||||
| A film ported from another animal's choreography with an extra rule | Far away, flat, a toy | Port the closest approved film 1:1 and change the body only |
|
||||
| A scarab with no close body | 4 rounds, about 450,000 tokens, still busy and cheap | An animal with no close body gets flagged before it starts |
|
||||
| Every beat filmed from one side | The camera sat between 20° and 50°, at one height and one distance, for 4 beats | Every beat gets its own side, height and distance, aimed at its part |
|
||||
| Short versions made by cutting the long film's busiest moments | Jumps from fragment to fragment | A short version is its own script with its own opening and exit |
|
||||
| 4 animals at once, reviewed after round 6 | One moth alone ate about 430,000 tokens before it was dropped | 2 animals at a time, reviewed after round 2 |
|
||||
+78
@@ -0,0 +1,78 @@
|
||||
# Prompts
|
||||
|
||||
Every prompt in the order you use them. Replace the parts in [brackets].
|
||||
|
||||
## 1. The reference image
|
||||
|
||||
For ChatGPT or any image model:
|
||||
|
||||
```
|
||||
A robotic [hammerhead shark] as a precision machine, studio product shot on a near-white background with a soft floor shadow.
|
||||
White glossy shells with clearcoat, green only on tips, rims, edges and joint rings.
|
||||
Dense dark mechanism showing through cut-outs and clear glass: gears, pistons, hoses, small screws.
|
||||
Eyes as glossy black lenses with a thin green ring. Fins and membranes milky and frosted with thin veins.
|
||||
Front three-quarter view, the whole animal in frame.
|
||||
```
|
||||
|
||||
Pick an animal with many joints and a dense core. Give it one main set of limbs. Smooth bodies (snakes, shells, rays) read as toys however many rounds they get.
|
||||
|
||||
## 2. The still loop
|
||||
|
||||
```
|
||||
Read JOB_DESCRIPTION.md and this checklist. Build the [piranha] and loop:
|
||||
1. Render a still at 1600x900 posed like the reference.
|
||||
2. Stack the reference, your still and the approved still side by side, plus a thumbnail of the same stack 900 px wide.
|
||||
3. Grade every checklist line yes, partial or no, one line each.
|
||||
4. Fix the no's, then the partials.
|
||||
Stop after round 2 and show me the stack and the grades. Wait for my notes before round 3.
|
||||
```
|
||||
|
||||
Then grade it yourself, against the picture and not against your memory of it.
|
||||
|
||||
## 3. Measuring
|
||||
|
||||
```
|
||||
Crop the reference and your still to the animal's bounding box.
|
||||
Density: count the share of dark pixels (luma under 80). Yours has to reach 0.8 of the reference's. Raise it by breaking white surfaces into separate plates with gaps over the mechanism; adding dots does not count.
|
||||
Proportions: measure body height, head length and jaw or limb length as shares of the body length, the same way on both images. Report both numbers side by side.
|
||||
```
|
||||
|
||||
## 4. Round notes
|
||||
|
||||
When you send Claude back for another round, give numbers, not adjectives:
|
||||
|
||||
```
|
||||
Round [3]. Fix these in order, measure each on your still and on the reference, report both:
|
||||
1. [The biggest problem, with the target number: "jaws at 0.36 of the body length, yours are 0.52".]
|
||||
2. [The next one: "green as lines only, zero isolated dots".]
|
||||
3. ...
|
||||
Grade each item yes / partial / no against the reference. Save round[3]_still.png and round[3]_compare.jpg and stop.
|
||||
```
|
||||
|
||||
## 5. The film
|
||||
|
||||
```
|
||||
Take the approved film of the animal whose body is closest to this one and port it 1:1: the same beat times, the same moves, distances scaled to the animal. Change the body only.
|
||||
Map its parts onto the slots: [the eye, the tail, the flank, the jaw].
|
||||
Each part opens in about 1 s, holds with its parts still spinning, and closes in 0.5 s. Give every part its own camera: its own side and height, aimed at the part, pushing in while it hangs open.
|
||||
Then a full explode on a turntable, a fast reassembly while it turns, and an exit.
|
||||
Build a page around it: an invented product name and title, one pill button per part that a cursor clicks, live cards that move with the parts.
|
||||
Before you show me the film, put its frames at 1.5, 4.5 and 12.4 s next to the approved film's. If it looks smaller, flatter or blurrier, it doesn't ship.
|
||||
```
|
||||
|
||||
## 6. The short version
|
||||
|
||||
```
|
||||
Write a 10-second version as its own script: the opening, one part ([the jaw]), the explode, the exit. Do not cut pieces out of the long film.
|
||||
Give it its own opening and exit, different from the other animals'.
|
||||
If the scene needs more than 10 seconds, play it back faster, up to 1.15x, and stretch the sound by the same factor.
|
||||
```
|
||||
|
||||
## 7. Render and sound
|
||||
|
||||
```
|
||||
Render the film frame by frame: render(t) is a pure function of time. Capture at 1600x900 with a device pixel ratio of 2.4, downscale to 1920x1080 at 60 fps with lanczos, H.264, yuv420p, faststart.
|
||||
Score it in code on the same script: a music bed for the whole film, a quiet click per button, a short accent on every part that moves. Master to -14 LUFS.
|
||||
```
|
||||
|
||||
A screen recorder drops frames when the GPU works hard. A film rendered frame by frame cannot.
|
||||
@@ -0,0 +1,46 @@
|
||||
# Cutaway
|
||||
|
||||
A cutaway is a machine drawn with its shell opened, so you see the mechanism inside. This is the method for building one as a live 3D film from a single reference image: Claude Code writes every shell, gear and part as three.js code, checks the result against the picture, and films the object taking itself apart. It works for anything with a dense core: robotic animals, engines, drones, devices.
|
||||
|
||||
This repository holds the method, not the output:
|
||||
|
||||
- the job description Claude reads before every animal;
|
||||
- the checklist format and a full example;
|
||||
- every prompt, step by step;
|
||||
- the corrections that made it work.
|
||||
|
||||
There is no code here and no renders. Claude writes the code on your machine from these files.
|
||||
|
||||
## What you need
|
||||
|
||||
- **Claude Code** on Opus.
|
||||
- **An image model** (ChatGPT works) for the reference picture.
|
||||
- **Node.js 20 or newer**, **ffmpeg** and **Python 3** for the video and the sound. Claude Code installs them if you ask.
|
||||
|
||||
## How it runs
|
||||
|
||||
1. **Generate the reference.** One picture sets the look and nothing else. See [PROMPTS.md](PROMPTS.md), step 1.
|
||||
2. **Add the job description.** Copy [JOB_DESCRIPTION.md](JOB_DESCRIPTION.md) into your project and point Claude at it before every animal.
|
||||
3. **Write a checklist for this picture.** 10 to 12 numbered lines on what this one image stands on. See [CHECKLIST.md](CHECKLIST.md).
|
||||
4. **Run the still loop.** Claude renders a still, stacks it next to the reference and grades every line. It stops after round 2 and waits for you.
|
||||
5. **Measure.** Dark-pixel share against the reference, and the proportions in numbers. Eyeballing lets a tidy diagram through.
|
||||
6. **Save every correction** into the job description. [LESSONS.md](LESSONS.md) lists ours.
|
||||
7. **Film it.** Port the approved film of the animal with the closest body 1:1 and change the body only. Every beat gets its own camera.
|
||||
8. **Write the short version.** A 10-second version is its own script, never a montage of the long one.
|
||||
9. **Render frame by frame** and score the sound on the same script.
|
||||
|
||||
## Files
|
||||
|
||||
| File | What it is |
|
||||
|---|---|
|
||||
| [JOB_DESCRIPTION.md](JOB_DESCRIPTION.md) | The brief Claude reads before every animal: the look, the order of work, the camera, the film |
|
||||
| [CHECKLIST.md](CHECKLIST.md) | How to write a checklist for one picture, a template and a full 12-line example |
|
||||
| [PROMPTS.md](PROMPTS.md) | Every prompt, from the reference image to the sound |
|
||||
| [LESSONS.md](LESSONS.md) | Each mistake, what it looked like, and the line it added to the job description |
|
||||
|
||||
## What it costs
|
||||
|
||||
- A still runs about 400,000 tokens over 3 rounds.
|
||||
- A film runs another 150,000 to 400,000.
|
||||
- Run 2 animals at a time, not 4, and look at both after round 2. A note there still changes the outcome; after round 6 it only costs tokens.
|
||||
- An animal whose body is unlike anything you have filmed costs about twice as much. Pick one close to an approved body, or know the price first.
|
||||
Reference in New Issue
Block a user