Cutaway skill: build, film and score a 3D object that takes itself apart from one picture

The skill (SKILL.md), the kit for building one HTML page and capturing a 60 fps film, the procedural sound engine, the green page and look, and 3 complete examples: a tarantula, a piranha and a wasp, each with a full film and a 10-second version. The method docs move into docs/ with the README's GIFs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Nyxera0x
2026-11-06 12:57:09 +03:00
parent ca143f35f4
commit 5d8f1c6efe
93 changed files with 15705 additions and 39 deletions
+368
View File
@@ -0,0 +1,368 @@
// The Vespion VX-9 wasp's 10-second demo (entry wasp-demo), made 2026-11-06 for the article: the bee's 18-second
// film (robobee-shared/tour_18.js) carried onto the wasp (its tour_v2.js differences: the sting, the abdomen camera's
// target, the labels) and cut down to one assembly. What it runs:
// - the opening: the wasp dives in from high on the left, banking, and flares nose-up as it brakes;
// - one assembly, the WING: pulled out of its hinge and turned over in the air;
// - the explode in slow motion (0.4x while the parts leave), the camera passing low under them, a full 360 deg
// turntable and a push-in for the reassembly;
// - the exit: the wasp turns a little toward the lens, noses up and climbs straight out of the top of the frame.
// The speed ramp is a warp of film time t into scene time tau (tauAt), so everything stays a pure function of t.
import * as THREE from 'three';
import {FLOOR_Y} from './tour.js';
import {AMP, ASSEMBLY_LABEL, FLAP_HZ} from './tour_v2.js';
const smoother = (x) => {
const u = Math.min(1, Math.max(0, x));
return u * u * u * (u * (u * 6 - 15) + 10);
};
const ss = (a, b, t) => smoother((t - a) / (b - a));
const lerp = (a, b, k) => a + (b - a) * k;
const bump = (a, b, c, d, t) => ss(a, b, t) * (1 - ss(c, d, t));
const D2R = Math.PI / 180;
const MM = 80;
const S = 1.15;
// each act's own clock in scene seconds after its click, a beat every 2.2 s
export const ACT_R = {
optics: {open: [0.25, 1.05], close: [1.55, 1.9], stop: false},
wing: {open: [0.2, 0.75], close: [1.6, 1.95], stop: true},
thorax: {open: [0.25, 1.0], close: [1.5, 1.9], stop: true},
abdomen: {open: [0.25, 1.0], close: [1.55, 1.95], stop: true},
};
// the pulled wing turns over once while it hangs out of its hinge
export const WING_FLIP = [0.45, 1.45];
// the ramp in film seconds after the EXPLODED click: down to 0.4x as the parts start to leave, held while they drift
// apart, back up as the turntable takes over
export const RAMP = {a: [0.35, 0.55], b: [1.9, 2.1], low: 0.4};
// the climb starts this long after HERO (scene seconds)
export const DEP = 0.75;
// the hero camera, low on the front-right so the climb reads against the paper above
const HERO_AZ = 32;
const HERO_EL = 4;
const HERO_D = 7.8;
export function makeWarp(tRamp, dur) {
const rate = (t) => 1 - (1 - RAMP.low) * bump(tRamp + RAMP.a[0], tRamp + RAMP.a[1], tRamp + RAMP.b[0], tRamp + RAMP.b[1], t);
const DT = 1 / 480;
const TAU = [0];
for (let i = 1; i * DT <= dur + 2; i++) TAU.push(TAU[i - 1] + rate((i - 0.5) * DT) * DT);
const tauAt = (t) => {
if (t <= 0) return t;
const u = Math.min(TAU.length - 2, t / DT);
const i = Math.floor(u);
return TAU[i] + (TAU[i + 1] - TAU[i]) * (u - i);
};
return {rate, tauAt};
}
export function make10Tour(TL) {
const SCRIPT = [...TL.script].sort((a, b) => a.t - b.t);
const DURATION = TL.duration;
const EVENTS = SCRIPT.map((e) => e.t);
const tfOf = (act) => (SCRIPT.find((e) => e.act === act) ?? {t: 999}).t;
const tfExp = tfOf('exploded');
const tfAsm = tfOf('assemble');
const {rate, tauAt} = makeWarp(tfExp, DURATION);
const AT = {};
for (const e of SCRIPT) (AT[e.act] ??= []).push(tauAt(e.t));
const at = (act) => AT[act] ?? [];
const T_EXP = at('exploded')[0] ?? 999;
const T_ASM = at('assemble')[0] ?? 999;
const T_END = at('hero')[0] ?? 999;
const T_FIRST = Math.min(...Object.keys(ACT_R).flatMap((a) => at(a)), 999);
const openOf = (act, x) => {
let v = 0;
for (const t0 of at(act)) {
const A2 = ACT_R[act];
v = Math.max(v, bump(t0 + A2.open[0], t0 + A2.open[1], t0 + A2.close[0], t0 + A2.close[1], x));
}
return v;
};
const explodeAt = (x) => ss(T_EXP + 0.2, T_EXP + 1.5, x) * (1 - ss(T_ASM, T_ASM + 0.8, x));
// the turntable: a full +360 deg from the explode to just after the bee is whole again
const TT = [T_EXP + 0.2, T_ASM + 1.2];
const turnAt = (x) => {
const [a, b] = TT;
if (x <= a) return 0;
const R = 0.5;
const span = b - a;
const v = 360 / (span - R);
const y0 = Math.min(x, b) - a;
if (y0 < R) return (v * y0 * y0) / (2 * R);
if (y0 < span - R) return v * (y0 - R / 2);
const y = y0 - (span - R);
return v * (span - 1.5 * R) + v * y - (v * y * y) / (2 * R);
};
// the wings park for the acts that need still wings and for the explode; when the next act parks them too they stay
// parked across the cut instead of spinning up for a moment between
const STOPS = [];
SCRIPT.forEach((e, n) => {
const A2 = ACT_R[e.act];
if (!A2?.stop) return;
const t0 = tauAt(e.t);
const nx = SCRIPT[n + 1];
const hold = nx && (ACT_R[nx.act]?.stop || nx.act === 'exploded') ? tauAt(nx.t) - t0 + 0.4 : A2.close[1];
STOPS.push([t0, t0 + 0.35, t0 + hold, t0 + hold + 0.45]);
});
STOPS.push([T_EXP, T_EXP + 0.4, T_ASM + 0.7, T_ASM + 1.2]);
const stopAt = (x) => Math.max(0, ...STOPS.map((w) => bump(w[0], w[1], w[2], w[3], x)));
const activity = (x) => Math.max(...Object.keys(ACT_R).map((a) => openOf(a, x)), explodeAt(x));
const DT = 1 / 240;
const SPIN = [0];
for (let i = 1; i * DT <= DURATION + 1; i++) SPIN.push(SPIN[i - 1] + (1 + 5 * activity((i - 0.5) * DT)) * DT);
const look = (A2, x) => {
const u = Math.max(0, Math.min(A2.length - 2, x / DT));
const i = Math.floor(u);
return A2[i] + (A2[i + 1] - A2[i]) * (u - i);
};
const spinAt = (x) => (x < 0 ? x : look(SPIN, x));
// the bee: dives in from high on the left banking, flares nose-up and hovers through the teardowns, turns on the
// explode turntable, turns a little toward the lens on HERO and climbs out of the top of the frame
const flightAt = (x) => {
const kIn = ss(-0.9, 1.6, x);
const ex = explodeAt(x);
const calm = 1 - Math.min(1, ex * 2.5);
const path = new THREE.Vector3(lerp(-0.8 * S, 0, kIn), lerp(1.0 * S, 0, kIn), lerp(0.45 * S, 0, kIn));
let yaw = lerp(-24, 0, kIn);
let roll = 28 * Math.sin(Math.PI * Math.min(1, kIn * 1.05)) - 7 * Math.sin(2 * Math.PI * kIn) * kIn + 1.7 * Math.sin(x * 1.3 + 1.1) * calm;
let pitch = -16 * (1 - kIn) + 10 * Math.sin(Math.PI * ss(0.55, 1.0, kIn)) + 1.4 * Math.sin(x * 1.9 + 0.6) * calm;
yaw += turnAt(x);
// HERO: the wasp turns a little toward the lens and lifts its nose, then climbs straight up out of the frame,
// pitching up into the climb with one roll
const kH = ss(T_END, T_END + 0.8, x);
yaw -= 22 * kH;
pitch += 8 * kH;
roll += 10 * Math.sin(Math.PI * kH);
if (x > T_END + DEP) {
const u = x - T_END - DEP;
const k = ss(0, 0.6, u);
pitch += 24 * k;
roll -= 12 * Math.sin(Math.PI * ss(0, 1.3, u));
path.y += 0.7 * u + 1.8 * u * u;
path.x += 0.3 * u * u;
}
const pos = path.clone().add(new THREE.Vector3(0, 0.05 * Math.sin(x * 2.6) * calm, 0));
return {pos, path, yaw, roll, pitch, calm};
};
// ------------------------------------------------------------ cameras: [az, el, d, tx, ty, tz, sx, sy]
// az from the right flank (0) toward the face (90); the hero side is about 20-40. The teardown targets and drift
// rates are the second cut's.
const macro = (act, u, depth = 0.12) => {
const A2 = ACT_R[act];
return 1 - depth * bump(A2.open[1] - 0.35, A2.open[1] + 0.1, A2.close[0] - 0.1, A2.close[1], u);
};
const push = (a, b, u, end = 1.9) => lerp(a, b, ss(0, end, u));
const EXP_SPAN_F = tfAsm - tfExp;
const CAM = {
// the dive: the camera comes down from above with the bee, pushing in
intro: (u) => {
const k = ss(0, 2.0, u);
return [lerp(46, 34, k), lerp(22, 10, k), lerp(7.9, 7.4, k), 0.0, -0.2, 0.25, -20, -14];
},
// the lens from the face side, so the barrel unscrews sideways across the frame
optics: (u) => [90 - 9 * u, 6, push(4.9, 4.3, u) * macro('optics', u, 0.07), 1.22, 0.12, 0.45, 0, -14],
// the wing from the hero side, rising with it as it leaves the hinge and turns over
wing: (u) => {
const k = ss(0, 1.9, u);
return [38 + 9 * k, lerp(12, 22, k), push(8.8, 7.8, u), -0.5, 0.95, 1.25, 0, -14];
},
// the thorax from high over the near flank
thorax: (u) => [6 + 10 * u, 34, push(6.9, 6.0, u) * macro('thorax', u), 0.0, 0.32, 0.05, 0, -14],
// the abdomen from behind the near flank as it telescopes out
abdomen: (u) => [-32 + 10 * u, 14, push(6.8, 5.9, u) * macro('abdomen', u, 0.08), -2.45, -0.95, 0.1, 0, -14],
// the explode, on FILM time (u = film seconds since the click): while the ramp holds the parts at 0.4x the camera
// keeps its own speed and swings round low under them looking up, then rises over the turntable and pushes in for
// the reassembly
exploded: (u) => {
const arc = ss(0.45, 2.0, u);
const rise = ss(1.9, 2.9, u);
const near = ss(EXP_SPAN_F - 0.3, EXP_SPAN_F + 0.9, u);
return [24 + 32 * arc - 14 * rise, lerp(10, -2, arc) + 20 * rise, lerp(11.4, 12.0, arc) - 3.6 * near, 0.0, lerp(-0.15, 0.05, arc) * (1 - rise) - 0.15 * rise, 0.0, -10, -14];
},
// HERO: low on the front-right, holding still while the wasp turns and climbs out
hero: (u) => {
const k = ss(0, 0.9, u);
return [lerp(42, HERO_AZ, k), lerp(18, HERO_EL, k), lerp(8.4, HERO_D, k), 0.0, -0.15, 0.25, -14, -14];
},
};
const VIEWS = [{t: -1, tf: -1, key: 'intro'}, ...SCRIPT.map((e) => ({t: tauAt(e.t), tf: e.t, key: e.act === 'assemble' ? 'exploded' : e.act}))];
const viewIdx = (x) => {
let i = 0;
while (i < VIEWS.length - 1 && VIEWS[i + 1].t <= x) i++;
return i;
};
// ASSEMBLE runs on the EXPLODED view's clock, so both read as one continuous shot (and HERO blends out of it)
const resolve = (i) => (VIEWS[i].key === 'exploded' && i > 0 && VIEWS[i - 1].key === 'exploded' ? VIEWS[i - 1] : VIEWS[i]);
const camFn = (V, x, t) => CAM[V.key](V.key === 'intro' ? x : V.key === 'exploded' ? t - V.tf : x - V.t);
const camAt = (x, t) => {
const i = viewIdx(x);
let o = camFn(resolve(i), x, t);
if (i > 0 && resolve(i) === VIEWS[i]) {
const k = ss(VIEWS[i].t, VIEWS[i].t + 0.7, x);
if (k < 1) {
const a = camFn(resolve(i - 1), x, t);
const dAz = ((o[0] - a[0] + 540) % 360) - 180;
const b = o.map((v, j) => lerp(a[j], v, k));
b[0] = a[0] + dAz * k;
b[2] += 0.5 * Math.sin(Math.PI * k);
o = b;
}
}
const f = flightAt(x);
// the camera follows the wasp's path, and on the climb lets go sideways and follows the rise a third of the way
const kOut = ss(T_END + DEP - 0.2, T_END + DEP + 0.5, x);
const kIn = 1 - ss(0.2, 1.9, x);
const tr = (0.85 - 0.3 * kIn) * (1 - kOut);
const trY = (0.85 - 0.35 * kIn) * (1 - 0.65 * kOut);
return {az: o[0], el: o[1], d: o[2], tx: o[3] + f.path.x * tr, ty: o[4] + f.path.y * trY, tz: o[5] + f.path.z * tr, sx: o[6], sy: o[7]};
};
const actAt = (x) => VIEWS[viewIdx(x)].key;
const stateAt = (t) => {
const x = tauAt(t);
const ex = explodeAt(x);
const amp = AMP * (1 - stopAt(x));
const f = flightAt(x);
const open = Object.fromEntries(Object.keys(ACT_R).map((a) => [a, openOf(a, x)]));
let wingFlip = 0;
for (const t0 of at('wing')) wingFlip = Math.max(wingFlip, ss(t0 + WING_FLIP[0], t0 + WING_FLIP[1], x));
if (wingFlip >= 1) wingFlip = 0;
// the sting: out of its collar once the abdomen hangs open, back in before it closes
let stingK = 0;
for (const t0 of at('abdomen')) stingK = Math.max(stingK, ss(t0 + 0.75, t0 + 1.15, x) * (1 - ss(t0 + 1.4, t0 + 1.6, x)));
return {
t,
tau: x,
rate: rate(t),
spinT: spinAt(x),
explode: ex,
amp,
flap: Math.PI * 2 * FLAP_HZ * x,
display: 1 - amp / AMP,
blur: 1,
sub: {thorax: open.thorax, abdomen: open.abdomen},
eye: open.optics,
wingOut: open.wing,
wingFlip,
stingK,
legK: 0,
open,
flight: f,
cam: camAt(x, t),
view: actAt(x),
guides: 0.45 + 0.55 * Math.min(1, ex * 2.5 + activity(x)),
turn: turnAt(x),
};
};
// labels: on while the act's parts are moving apart and while they hang open, gone before they close
const LABELS = {
optics: [['eyeGlass', 'OUTER GLASS', 'Ø 40 MM · AR COATED'], ['eyeInner', 'INNER ELEMENT', 'Ø 15 MM'], ['iris', 'IRIS', '10 BLADES · OPENS 3×'], ['barrel', 'LENS BARREL', 'THREADED · 4 RINGS']],
wing: [['wing', 'WING MEMBRANE', 'FROSTED FILM · 0.1 MM'], ['hinge', 'WING HINGE', 'QUICK RELEASE'], ['hinge2', 'HINDWING HINGE', 'PHASE +40°']],
thorax: [['plate', 'SADDLE PLATE', 'POLYMER SHELL'], ['gears', 'DRIVE GEAR STACK', '3 SPUR GEARS'], ['act', 'ACTUATOR RING', '11 PISTONS'], ['core', 'CONTROL BOARDS', 'FLIGHT CPU · IMU']],
abdomen: [['waist', 'WAIST STALK', '5 BEADS · LIT RINGS'], ['s1', 'SHELL BAND', 'TELESCOPING'], ['capsule', 'BAND 4', 'RIVETED · 5 SEGMENTS'], ['sting', 'STINGER', 'GLASS · EXTENDS 30 MM']],
exploded: [['lens', 'OPTIC HEAD', '2 × LENS'], ['collar', 'NECK BEARING', '10 SEGMENTS'], ['gears', 'DRIVE GEARS', 'SPINNING FREE'], ['capsule', 'ABDOMEN BANDS', '5 SEGMENTS'], ['hinge', 'WING HINGE', 'QUICK RELEASE']],
};
const labelAt = (x, s) => {
const v = s.view;
if (ACT_R[v]) {
const t0 = at(v).filter((y) => y <= x).pop();
const A2 = ACT_R[v];
return {set: LABELS[v], o: bump(t0 + A2.open[0] + 0.1, t0 + A2.open[0] + 0.4, t0 + A2.close[0] - 0.25, t0 + A2.close[0], x)};
}
if (v === 'exploded') return {set: LABELS.exploded, o: bump(T_EXP + 0.4, T_EXP + 0.8, T_EXP + 1.6, T_EXP + 1.9, x)};
return {set: [], o: 0};
};
const telemetry = (t, s) => {
const x = s.tau;
const f = s.flight;
const stroke = [];
for (let i = 0; i <= 90; i++) {
const tt = x - 1.2 + (i / 90) * 1.2;
const a = AMP * (1 - stopAt(tt));
const ph = Math.PI * 2 * FLAP_HZ * tt;
stroke.push([a * Math.sin(ph), a * Math.sin(ph + 0.7)]);
}
const ex = s.explode > 0.04;
const acc = -Math.sin(x * 2.6);
const free = [0, 1, 2, 3, 4, 5].map(() => ex);
const servos = [0.44, 0.58, 0.49, 0.4, 0.53, 0.46].map((b, i) => (free[i] ? 0 : Math.max(0, Math.min(1, b * (1 + 0.32 * acc) + 0.12 * Math.abs(f.roll) / 30 + 0.03 * Math.sin(x * 7 + i)))));
const v = s.view;
const opening = ACT_R[v] ? s.open[v] : 0;
const NAME = {optics: 'OPTICS OPEN', wing: 'WING OFF', thorax: 'THORAX OPEN', abdomen: 'ABDOMEN OPEN'};
const dartU = x - T_END - DEP;
const darting = dartU > 0;
let status = 'HOVER';
let kind = 'ok';
if (x < T_FIRST) status = 'DIVING';
if (ACT_R[v] && opening > 0.05) [status, kind] = [NAME[v], 'warn'];
if (v === 'exploded') [status, kind] = s.rate < 0.9 ? ['SLOW-MO', 'warn'] : x < T_ASM ? ['TEARDOWN', 'warn'] : s.explode > 0.04 ? ['REASSEMBLY', 'warn'] : ['HOVER', 'ok'];
if (darting) status = 'CLIMB-OUT';
const ROW = {optics: 0, thorax: 2, wing: 3, leg: 4, abdomen: 5};
const sub = (i) => {
if (ex) return ['warn', 'DETACHED'];
if (ROW[v] === i && opening > 0.05) return ['warn', i === 3 ? 'DETACHED' : 'OPEN'];
if (i === 3) return s.amp > 1 ? ['ok', `${FLAP_HZ} HZ`] : ['idle', 'PARKED'];
if (i === 2) return s.amp > 1 ? ['ok', 'RUNNING'] : ['idle', 'STOPPED'];
return ['ok', ['TRACKING', 'LOCKED', '', '', 'HOLDING', 'SEALED'][i]];
};
const last = SCRIPT.filter((e) => e.t <= t).pop();
const say = (e) => (e.act === 'exploded' ? 'EXPLODED ON' : e.act === 'assemble' ? 'EXPLODED OFF · REASSEMBLE' : e.act === 'hero' ? 'HERO · CLIMB-OUT' : `ISOLATE ${ASSEMBLY_LABEL[e.act]}`);
const sp = darting ? 0.4 + 1.2 * (1.2 + 3 * dartU) : f.pos.length() > 0.05 ? 0.4 + 0.2 * Math.abs(Math.sin(x)) : 0.004;
const labels = labelAt(x, s);
return {
time: t,
dur: DURATION,
lift: Math.max(0, (s.amp / AMP) * (0.68 + 0.02 * Math.sin(s.flap)) + 0.12 * Math.abs(f.roll) / 30),
status,
statusKind: kind,
freq: FLAP_HZ * ss(0.5, 6, s.amp),
amp: s.amp,
stroke,
playback: s.rate,
blur: 1,
battery: 0.842 - 0.0022 * t,
power: 4.2 + 31 * Math.pow(s.amp / AMP, 1.5) * (1 + 0.04 * Math.sin(s.flap)) + 3 * Math.abs(f.roll) / 30 + (darting ? 9 * ss(0, 0.5, dartU) : 0),
volt: 3.92 - 0.006 * 36,
motorT: 34 + 0.35 * t,
servos,
legsFree: ex,
legFreeEach: free,
airborne: true,
alt: (f.pos.y - FLOOR_Y) * MM,
vs: x < T_FIRST ? -MM * S * (ss(-0.9, 1.6, x + 0.05) - ss(-0.9, 1.6, x - 0.05)) * 10 : MM * 0.05 * 2.6 * Math.cos(x * 2.6) * f.calm,
pitch: f.pitch,
roll: f.roll,
airspeed: sp,
view: v === 'intro' ? 'hero' : v === 'exploded' ? null : v,
display: {labels: labels.o > 0.5, exploded: x >= T_EXP && x < T_ASM, blur: s.amp > 3, turntable: s.turn > 0.5 && x < TT[1]},
subs: [0, 1, 2, 3, 4, 5].map(sub),
focus: ROW[v] ?? (v === 'exploded' ? 1 : -1),
events: EVENTS,
next: `${EVENTS.length} OPERATOR ACTIONS`,
log: last ? `OPERATOR · ${say(last)}` : 'INBOUND · DIVING · BANK LEFT',
mode: status,
modeSub:
status === 'DIVING'
? `BANK ${f.roll.toFixed(0)}° · DIVING IN`
: status === 'SLOW-MO'
? `PLAYBACK ${s.rate.toFixed(2)}× · ${Math.round(s.explode * 100)}% APART`
: status === 'TEARDOWN' || status === 'REASSEMBLY'
? `TURNTABLE ${Math.round(s.turn)}° CW · ${Math.round(s.explode * 100)}% APART`
: status === 'CLIMB-OUT'
? `CLIMBING · ${sp.toFixed(1)} M/S`
: ACT_R[v]
? `${ASSEMBLY_LABEL[v]} · ${Math.round(opening * 100)}% APART`
: `STATION KEEPING · ${((f.pos.y - FLOOR_Y) * MM).toFixed(0)} MM AGL`,
viewNote: `ISOLATE · ${v === 'intro' || v === 'hero' ? 'HERO' : v === 'exploded' ? 'ALL' : ASSEMBLY_LABEL[v]}`,
labelSet: labels,
};
};
return {SCRIPT, DURATION, stateAt, telemetry, camAt, flightAt, tauAt};
}