Setting the file. One moment. Verify Motion · Figma · heygen-com/hyperframes · Skills Docsscripts/verify-motion.mjs
scripts/verify-motion.mjs
JavaScript·153 lines·5 KB
15 * sits between with margin on both sides.
16 *
17 * node verify-motion.mjs --reference figma-export.mp4 --render out.mp4 \
18 * [--crop WxH+X+Y] [--interval 0.2] [--min-motion-psnr 15]
19 *
20 * --crop selects the card region inside the (usually larger) composition
21 * frame. Measure it from the render (the card's left/top edge + scaled
22 * size), don't guess: a wrong crop reads as motion divergence.
23 */
24import { execFileSync, spawnSync } from "node:child_process";
25import { mkdtempSync, rmSync } from "node:fs";
26import { tmpdir } from "node:os";
27import { join } from "node:path";
28
29function arg(name, fallback) {
30 const i = process.argv.indexOf(`--${name}`);
31 return i > -1 ? process.argv[i + 1] : fallback;
32}
33const reference = arg("reference");
34const render = arg("render");
35if (!reference || !render) {
36 console.error(
37 "usage: verify-motion.mjs --reference ref.mp4 --render out.mp4 [--crop WxH+X+Y] [--interval 0.2] [--min-motion-psnr 15]",
38 );
39 process.exit(2);
40}
41const crop = arg("crop", null);
42const interval = Number(arg("interval", "0.2"));
43const minMotion = Number(arg("min-motion-psnr", "15"));
44
45const ffprobe = (file) =>
46 Number(
47 execFileSync("ffprobe", [
48 "-v",
49 "error",
50 "-show_entries",
51 "format=duration",
52 "-of",
53 "csv=p=0",
54 "--",
55 file,
56 ])
57 .toString()
58 .trim(),
59 );
60const refDur = ffprobe(reference);
61const renderDur = ffprobe(render);
62const end = Math.min(refDur, renderDur) - interval - 0.01;
63
64const dims = execFileSync("ffprobe", [
65 "-v",
66 "error",
67 "-select_streams",
68 "v",
69 "-show_entries",
70 "stream=width,height",
71 "-of",
72 "csv=p=0",
73 "--",
74 reference,
75])
76 .toString()
77 .trim()
78 .split(",")
79 .map(Number);
80const [rw, rh] = dims;
81
82let cropFilter = "";
83if (crop) {
84 const m = crop.match(/^(\d+)x(\d+)\+(\d+)\+(\d+)$/);
85 if (!m) {
86 console.error("bad --crop, expected WxH+X+Y");
87 process.exit(2);
88 }
89 cropFilter = `crop=${m[1]}:${m[2]}:${m[3]}:${m[4]},`;
90}
91
92const dir = mkdtempSync(join(tmpdir(), "verify-motion-"));
93const frame = (src, t, vf, dst) => {
94 const args = ["-y", "-v", "error", "-ss", String(t), "-i", src, "-frames:v", "1"];
95 if (vf) args.push("-vf", vf);
96 execFileSync("ffmpeg", args.concat(dst));
97};
98const diff = (a, b, dst) =>
99 execFileSync("ffmpeg", [
100 "-y",
101 "-v",
102 "error",
103 "-i",
104 a,
105 "-i",
106 b,
107 "-filter_complex",
108 "blend=all_mode=difference",
109 dst,
110 ]);
111const psnr = (a, b) => {
112 // spawnSync with array args (no shell): psnr stats land on stderr
113 const r = spawnSync("ffmpeg", ["-i", a, "-i", b, "-lavfi", "psnr", "-f", "null", "-"], {
114 encoding: "utf8",
115 });
116 const m = (r.stderr || "").match(/average:([\d.]+|inf)/);
117 return m ? (m[1] === "inf" ? 99 : Number(m[1])) : NaN;
118};
119
120const renderVf = `${cropFilter}scale=${rw}:${rh}`;
121const results = [];
122for (let t = 0; t <= end; t = Math.round((t + interval) * 1000) / 1000) {
123 const t1 = Math.round((t + interval) * 1000) / 1000;
124 frame(reference, t, null, join(dir, "ra.png"));
125 frame(reference, t1, null, join(dir, "rb.png"));
126 frame(render, t, renderVf, join(dir, "oa.png"));
127 frame(render, t1, renderVf, join(dir, "ob.png"));
128 diff(join(dir, "ra.png"), join(dir, "rb.png"), join(dir, "rd.png"));
129 diff(join(dir, "oa.png"), join(dir, "ob.png"), join(dir, "od.png"));
130 results.push({
131 t,
132 motion: psnr(join(dir, "rd.png"), join(dir, "od.png")),
133 abs: psnr(join(dir, "rb.png"), join(dir, "ob.png")),
134 });
135}
136rmSync(dir, { recursive: true, force: true });
137
138const min = Math.min(...results.map((r) => r.motion));
139const mean = results.reduce((s, r) => s + r.motion, 0) / results.length;
140for (const r of results)
141 console.log(
142 `window ${r.t.toFixed(2)}s→${(r.t + interval).toFixed(2)}s motion-psnr=${r.motion.toFixed(2)}dB (abs=${r.abs.toFixed(1)}dB)${r.motion < minMotion ? " <-- BELOW THRESHOLD" : ""}`,
143 );
144console.log(
145 `\nwindows=${results.length} min-motion=${min.toFixed(2)}dB mean-motion=${mean.toFixed(2)}dB threshold=${minMotion}dB`,
146);
147if (min < minMotion) {
148 console.log(
149 "VERDICT: FAIL — choreography diverges from the Figma export (check timings, invented keyframes, durations)",
150 );
151 process.exit(1);
152}
153console.log("VERDICT: PASS — motion matches the Figma export within the static-fidelity ceiling");