From b3a7547f604cecb09082308b771dce457479118c Mon Sep 17 00:00:00 2001 From: Navneet Chaudhary Date: Sat, 7 Nov 2026 22:05:09 +0530 Subject: [PATCH] feat: add timed blink playback review --- .agents/skills/puppetcontrol/SKILL.md | 2 +- README.md | 4 +- docs/CHARACTER_REVIEW.md | 2 + docs/EYE_TIMING.md | 64 +++++++++++++++++++++++ docs/EYE_TRANSITIONS.md | 4 ++ docs/IMPLEMENTATION_PLAN.md | 1 + docs/THIRD_PARTY_NOTICES.md | 2 +- docs/media/hana-timed-blink-30fps.mp4 | Bin 0 -> 24706 bytes src/character/blink-review.ts | 70 ++++++++++++++++++-------- src/character/timed-blink.ts | 50 ++++++++++++++++++ src/cli/index.ts | 20 +++++--- tests/timed-blink.test.ts | 35 +++++++++++++ 12 files changed, 223 insertions(+), 31 deletions(-) create mode 100644 docs/EYE_TIMING.md create mode 100644 docs/media/hana-timed-blink-30fps.mp4 create mode 100644 src/character/timed-blink.ts create mode 100644 tests/timed-blink.test.ts diff --git a/.agents/skills/puppetcontrol/SKILL.md b/.agents/skills/puppetcontrol/SKILL.md index 3a50f0b..98f2c4c 100644 --- a/.agents/skills/puppetcontrol/SKILL.md +++ b/.agents/skills/puppetcontrol/SKILL.md @@ -15,7 +15,7 @@ Read repo-root AGENTS.md, docs/TECHNICAL_CONCEPT.md, and docs/CHARACTER_IMPORT.m 6. Build using node dist/cli/index.js character build (use --force if prior output exists). Inspect any geometryWarnings, particularly BODY_PIVOT_TOO_LOW and IRIS_LANDMARK_MISSING; these do not replace pixel inspection. Source/landmark/model/texture hashes are recorded in avatar-build.json and scene preflight rejects stale assets. Inspect every returned review/poses.png, turn.png, eyes.png and mouth.png. If incorrect, repair avatar.json and rebuild using --force; this resets the generated manifest and any edited scaffold. 7. To test optional drawn eye/mouth variants on a built actor, request edit masks, locally supply reviewed `variants/.png`, and explicitly import. With reviewed closed+half eye drawings, `character variants import eyes_closed eyes_half --experimental-short-fade --reviewed-art` shortens fade windows but makes poses change faster and may still ghost; it is a visual experiment, never a default or automatic quality fix. The import revokes prior approval and refreshes provenance only after re-rendering review sheets. 8. For a deliberately non-blended eye-art experiment, `character variants import eyes_closed eyes_half --experimental-stepped-eyes --reviewed-art` selects only one complete eye appearance outside tiny threshold windows. It can remove ghosted doubled lashes but creates visible pose pops; do not call it seamless or automatically approve. See `docs/EYE_TRANSITIONS.md` and compare actual frames. -9. Before approving a verified imported rig, run `node dist/cli/index.js character qa blink ` to generate an ordered 25-frame actual eyelid transition contact sheet (`blink-eyes.png` and `blink-full.png`); inspect EyeOpen=0.19 and 0.69 and the real eye artwork seams. The QA report flags motion stalls but never passes visual approval. +9. Before approving a verified imported rig, run `node dist/cli/index.js character qa blink ` to generate an ordered 25-frame actual eyelid transition contact sheet (`blink-eyes.png` and `blink-full.png`); inspect EyeOpen=0.19 and 0.69 and the real eye artwork seams. The QA report flags motion stalls but never passes visual approval. Also run `character qa blink --timed` for a 36-frame synthetic 30 FPS video and review the actual moving result. Different fade policies may produce identical frames when their transition windows fall between sampled timestamps; see `docs/EYE_TIMING.md`. 10. A successful build intentionally leaves character.json with approved:false. A --force rebuild revokes approval *before* writing model/texture files, even if the rebuild later fails. Only after actual visual QA may an agent/user explicitly run `node dist/cli/index.js character approve --reviewed` (the flag is an acknowledgement, not evidence of review) to record neutral-pose approval. If there are torn eyelids, missing areas, extra contours or identity drift, LEAVE IT UNAPPROVED and report what needs correction. 11. For a reviewed reusable rig, use `node dist/cli/index.js scene new --character --seconds 12 --fps 15` to create a strict editable scene. Reuse the same character file in a second scene without rebuilding artwork. The generated preview-scene.json is also editable. Use node dist/cli/index.js scene validate and scene plan before rendering. Preview PNG frames, inspect key timestamps, then render and inspect the MP4. 12. Within a compatible shared rig, semantic pose events may interpolate through validated parameter presets (the neutral-to-pointing demo uses shoulder and elbow controls). Distinct pose models require explicit scene camera cuts; an authored bridge is NOT implemented. Never silently crossfade meshes or call a body cut a smooth physical transition. diff --git a/README.md b/README.md index e347a08..ea5a6e2 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ The long-term goal: **generate artwork when necessary, animate and reuse it inde - Guarded **local drawn eye/mouth variant** request, status and import commands using Rev2D masks and sprites. Imported drawings revoke approval and require a fresh visual review; no image generation happens automatically. - An optional **experimental** short-fade profile for imported half/closed eye drawings; avoids prolonged duplicate lash outlines at the cost of faster pose changes, revokes approval and regenerates review sheets. - Local PNG pixel and ordered-frame QA (full frame or explicit region) reports RGB activity, unexpected transparency, candidate motion jumps and changed-control stalls; these metrics never auto-approve a rig. -- Import review can now render a 25-frame blink contact sheet focused on actual eyelid transition boundaries, with pixel/motion diagnostics that never auto-approve a rig; see [Character Review](docs/CHARACTER_REVIEW.md). An optional [stepped-eye visibility experiment](docs/EYE_TRANSITIONS.md) eliminates sampled double-sprite ghosting on one MIT sample but introduces noticeable pose switching; it is not a seamless eyelid morph. +- Import review can render a 25-frame parameter-sweep contact sheet and a separate **36-frame, 30 FPS synthetic timed-blink MP4** with motion warnings; see [Character Review](docs/CHARACTER_REVIEW.md) and [Time-domain Blink QA](docs/EYE_TIMING.md). The opt-in [stepped-eye experiment](docs/EYE_TRANSITIONS.md) removes sampled opacity ghosting but does not provide a seamless morph. The two modes even produced byte-identical frames in one real-time test. - Imported flat-image actors start with narrower editable head/gaze motion limits, with consistent vertical look direction and unchanged amplitude for existing layered rigs; see [Look Motion](docs/LOOK_MOTION.md). - Optional SHA-256 Rhubarb cue bindings can detect when audio or mouth-cue bytes are replaced after alignment; a bound scene fails validation/render instead of silently using stale lip sync. - Agent-readable CLI output, tests and CI. @@ -71,6 +71,8 @@ The sample uses Rev2D's own **Hana** rig from the pinned MIT-licensed upstream c [Watch the reversible gesture demo](docs/media/hana-gesture-cycle.mp4) (5 seconds, silent 30 fps; the same arm moves between neutral and pointing four times with no cuts). +[Watch the 30 FPS timed-blink diagnostic](docs/media/hana-timed-blink-30fps.mp4) (1.2 seconds, silent 36-frame unapproved imported art test; not a polished animation). + For the first reproducible **one-character video workflow**, see [First Video](docs/FIRST_VIDEO.md). With an already reviewed rig, run `character approve --reviewed` for provenance-tracked imported characters, then `scene new --character `, `scene validate` and `scene render`. Create another scene with the same character path to reuse its rig, without regenerating artwork. To attach your own voice, use a real WAV and aligned Rhubarb cue JSON; no TTS is implied. Run a custom scene through the CLI: diff --git a/docs/CHARACTER_REVIEW.md b/docs/CHARACTER_REVIEW.md index 2f585c1..54f8e95 100644 --- a/docs/CHARACTER_REVIEW.md +++ b/docs/CHARACTER_REVIEW.md @@ -53,6 +53,8 @@ node dist/cli/index.js character qa blink avatars/portrait This produces an **ignored, uniquely named** directory under `outputs/qa/blink-review/` with `blink-full.png`, `blink-eyes.png`, `blink-review.json` and the individual PNG frames. The 25-frame sequence samples closed/open and both short-fade transition boundaries, including `EyeOpen=0.19` and `EyeOpen=0.69`. Thirteen actual Rev2D states are rendered; the remaining twelve are the same states in reverse order. Review the montage left-to-right, top-to-bottom. +To check what an actual video frame rate samples, also run `node dist/cli/index.js character qa blink avatars/portrait --timed`. This generates a separate 36-frame, 30 FPS synthetic blink MP4 and 6×6 contact sheet without approving or modifying the character. The default 25-frame parameter sweep remains available for narrow threshold defects. See [EYE_TIMING.md](EYE_TIMING.md): the old short-fade and stepped rigs gave all 36 **identical rendered frames** for one tested blink schedule despite different boundary stills. + The JSON report lists candidate motion stalls, frame changes, sampled controls and crop coordinates. **None of those statistics establish good visual quality.** Scrutinize both eyelids for lingering lashes, matte seams, iris clipping, mismatched shadow/color and sudden double contours. Inspect the existing `review/eyes.png`, `review/mouth.png`, `review/turn.png` and `review/poses.png` too. If eye annotations are unavailable, specify `--region x,y,width,height` explicitly. ## 4. Approve only after actual visual review diff --git a/docs/EYE_TIMING.md b/docs/EYE_TIMING.md new file mode 100644 index 0000000..9d8abd6 --- /dev/null +++ b/docs/EYE_TIMING.md @@ -0,0 +1,64 @@ +# Blink timing versus eye-art quality + +**Status:** review-only, not an automatic animation-quality pass. +**Evidence date:** 2026-11-07. +**Sample:** locally imported MIT-licensed RevStudio/Rev2D Hana illustration, with manually revised experimental half/closed eyelid drawings. Original imported actor remains **unapproved**. + +## Two complementary diagnostics + +To inspect the exact opacity thresholds: + +~~~powershell +node dist/cli/index.js character qa blink avatars/portrait +~~~ + +This samples 13 real Rev2D states (including `EyeOpen=0.19` and `0.69`), mirrors them into a 25-frame sequence, and writes full/eye crop montages and a JSON motion report. Frame adjacency is **not** a realistic clock. + +To test a synthetic **time-domain** blink at a real video frame rate: + +~~~powershell +node dist/cli/index.js character qa blink avatars/portrait --timed +~~~ + +This outputs a 36-frame, 30 FPS, 1.2-second H.264 video and a 6×6 visual contact sheet. Frame `n` is sampled at exactly `n/30` seconds. The fixed control schedule is 250ms open lead-in, 140ms closing, 65ms closed hold, 240ms reopening, and an open tail. Ease-in/ease-out is deterministic. For repeated identical control values, the tool reuses the exact previous PNG rather than rerendering a different result. It never touches approval, models or input art. + +A new unique ignored directory under `outputs/qa/blink-review/` contains `blink-timed-30fps.mp4`, `blink-eyes.png`, `blink-full.png`, `blink-review.json`, and per-frame PNGs. + +**Warning:** The timing is a fixed test case, not a measured biological blink or an actual character's finished animation. Other animation speeds, FPS and control waveforms may expose different defects. + +## Real 30 FPS findings + +[Watch the timed Hana blink, 1.2 seconds, 30 FPS](media/hana-timed-blink-30fps.mp4) + +The original experimental imported character remains unapproved. The sample video is a diagnostic using rights-cleared art, not a release-quality character demonstration. + +| Test | Short fade | Stepped | +|---|---:|---:| +| 30 FPS frames | 36 | 36 | +| Unique Rev2D render states | 13 | 13 | +| Reused frames | 23 | 23 | +| Possible abrupt changes | 5 | 5 | +| Possible changed-control stalls | 5 | 5 | + +**All 36 rendered PNG files were SHA-256 identical between the two methods** under this specific timing. The 0.18–0.20 and 0.68–0.70 transition bands fell between sampled frames. Neither mode could improve the actual 30 FPS output here, although the stepped version removes ghosting in deliberately sampled boundary *still images*. + +This demonstrates why a static threshold comparison is not enough to justify an animation-quality claim. The bigger blocker is the **unconvincing eye geometry and half/closed drawings**. + +## Rejected continuous-mesh experiments + +Four isolated model variants were generated and rendered from the same imported image, without touching any tracked or approved artwork: + +- **Early closed overlay** (0.11–0.20 opacity fade): kept continuous open-eye motion but produced doubled lines and translucent irises near the fade. +- **Late overlay** (0.035–0.105) and **ultra-late overlay** (0.01–0.055): moved ghosting nearer full closure but did not remove it. The underlying mesh still formed pinched/triangular lash corners. +- **Reduced upper warp** (80% displacement, 0.065–0.15 fade): altered the squeeze but did not produce natural eyelid geometry. Rejected for visible contour artifacts. + +These experiments live only in ignored `outputs/qa/eye-hybrid-20261107/` and were **not** integrated as new CLI options. A mode that merely moves artifacts to different parameter values is not a sufficient fix. + +## Acceptance criteria for future continuous eyelids + +1. Produce a coherent, art-matched moving eyelid silhouette with the iris correctly occluded at intermediate positions. +2. Avoid double lash contours and corner pinching at all values in a slow parameter sweep, not just at 30 FPS. +3. Replay real 15/30/60 FPS performance timelines and compare actual frames across several rights-cleared drawing styles. +4. Preserve the original character's linework and colors, and require explicit human review. No code metric alone may mark an avatar approved. + +The next engineering target is **quality-controlled intermediate eyelid artwork or a proper eyelid-specific deforming rig**, not another global opacity/fade profile. diff --git a/docs/EYE_TRANSITIONS.md b/docs/EYE_TRANSITIONS.md index 13604f5..fbed5f8 100644 --- a/docs/EYE_TRANSITIONS.md +++ b/docs/EYE_TRANSITIONS.md @@ -63,6 +63,10 @@ This is a **non-uniform parameter-sweep review clip** (25 frames at 30 FPS), **n A separate disposable, **QA-only** copy of the stepped actor was temporarily marked approved solely for renderer integration testing. It exported a valid 3-second, 15 FPS, 512×640, 45-frame H.264 MP4 via the verified-rig snapshot path. That marker was never applied to the experimental source character. The source remains `approved:false`. +## Time-domain verification + +A 30 FPS, 1.2-second synthetic blink was rendered under both profiles. For the specific 140ms closing / 65ms hold / 240ms opening curve, **all 36 output PNGs matched byte-for-byte**, because the transition windows occurred between the actual frame sample times. This does not mean those profiles always render identically at other timings or FPS. See [EYE_TIMING.md](EYE_TIMING.md) and the [30 FPS diagnostic video](media/hana-timed-blink-30fps.mp4). The important release blocker is still the quality of the eye silhouettes. + ## Acceptance boundary and next work Actual quality requires better curved, consistent eye artwork and/or a continuous eyelid-specific mesh with properly hidden irises. A reversible stepped visibility option is useful for stylized quick blinks, but shouldn't become a default or be described as Live2D-grade deformation. diff --git a/docs/IMPLEMENTATION_PLAN.md b/docs/IMPLEMENTATION_PLAN.md index 72311be..dcf7701 100644 --- a/docs/IMPLEMENTATION_PLAN.md +++ b/docs/IMPLEMENTATION_PLAN.md @@ -84,6 +84,7 @@ - [x] Test and expose an opt-in, validated short eye-sprite fade as a local derived-model experiment. Compare 13 actual Hana blink frames with native, immediate-switch and shortened fades: shorter fades visibly reduce double lashes at sampled midpoints, but introduce faster pose changes; never auto-approve. - [x] Add bounded per-character semantic head/eye look amplitudes with conservative imported-PNG starting values, schema validation, compiler tests and real Hana ±yaw/pitch/gaze frame comparisons. This does not establish visual approval. - [x] Test an optional stepped-eye visibility profile that removes sampled double-sprite ghosting at EyeOpen 0.19/0.69 on refined MIT Hana artwork, with a 25-frame A/B render, explicit abrupt-change warnings and local 45-frame end-to-end smoke video. The source remains unapproved; **this trades ghosting for pose popping**, not a seamless morph. +- [x] Add a 36-frame, 30 FPS time-domain blink QA export with deterministic synthetic timing, unique Rev2D state caching, and JSON motion warnings. The actual short-fade and stepped 30 FPS frames were SHA-256 identical for this one schedule, showing threshold tuning alone is insufficient. Four mesh/overlay variants failed visual QA and were not integrated. - [ ] Produce and visually approve high-quality closed/half eye and mouth artwork; demonstrate seamless real rendered transitions across full blink playback and multiple character styles. The local proof drawing stays unapproved. ## First video milestone — reproducible usable slice (2026-11-07) diff --git a/docs/THIRD_PARTY_NOTICES.md b/docs/THIRD_PARTY_NOTICES.md index 2f71ee7..863fb54 100644 --- a/docs/THIRD_PARTY_NOTICES.md +++ b/docs/THIRD_PARTY_NOTICES.md @@ -5,7 +5,7 @@ - Source project: https://github.com/RevStudio/Rev2D - Pinned source commit: f144581cdf1f12d781379c4df90d262b8c2dfa3d - File: examples/hana/hana.r2d.json in Rev2D upstream -- Use: local demo pose-rig generation, attributed sample MP4, and the derived eye-transition crop in `docs/media/stepped-eye-before-after.png`. PuppetControl's own source code does not bundle the original full Hana model/artwork. +- Use: local demo pose-rig generation, attributed sample MP4, the derived eye-transition crop in `docs/media/stepped-eye-before-after.png`, and the 30 FPS diagnostic preview in `docs/media/hana-timed-blink-30fps.mp4`. PuppetControl's own source code does not bundle the original full Hana model/artwork. - Original license: MIT License, Copyright (c) 2026 RevStudio. ### MIT License (RevStudio) diff --git a/docs/media/hana-timed-blink-30fps.mp4 b/docs/media/hana-timed-blink-30fps.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..f5cc1e55add95dffda0c2a508b89695055857157 GIT binary patch literal 24706 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�Xk*Q3M8E`o%u03vwrkW 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 literal 0 HcmV?d00001 diff --git a/src/character/blink-review.ts b/src/character/blink-review.ts index 4103459..a20bfcb 100644 --- a/src/character/blink-review.ts +++ b/src/character/blink-review.ts @@ -15,6 +15,7 @@ import { AvatarWorkflowError, checkedPath, pinnedRev2D, runRev2D } from "./avata import { verifyAvatarBuildRecord, checkAvatarPoseCoverage } from "./provenance.js"; import { comparePngSequence } from "./frame-sequence-qa.js"; import { parsePixelRegionArgument, type PixelRegion } from "./pixel-qa.js"; +import { TIMED_BLINK, timedBlinkValues } from "./timed-blink.js"; const execFileAsync = promisify(execFile); const MAX_MODEL_BYTES = 20_000_000; @@ -72,7 +73,7 @@ export function eyeRegionFromAvatarSpec( async function contactSheet( framesDirectory: string, outputFile: string, - crop?: PixelRegion, + crop?: PixelRegion, columns = 5, ): Promise { const cropStage = crop ? `crop=${crop.width}:${crop.height}:${crop.x}:${crop.y},` : ""; const scaleStage = crop ? "scale=490:-2:flags=lanczos" : "scale=256:-2:flags=lanczos"; @@ -80,7 +81,7 @@ async function contactSheet( await execFileAsync("ffmpeg", [ "-nostdin", "-hide_banner", "-loglevel", "error", "-y", "-framerate", "30", "-i", join(framesDirectory, "frame-%03d.png"), - "-vf", cropStage + scaleStage + ",tile=5x5", "-frames:v", "1", outputFile, + "-vf", cropStage + scaleStage + `,tile=${columns}x${columns}`, "-frames:v", "1", outputFile, ], { windowsHide: true, shell: false, timeout: 90_000, maxBuffer: 4_000_000 }); } catch (cause) { throw new AvatarWorkflowError("BLINK_CONTACT_FAILED", @@ -89,7 +90,7 @@ async function contactSheet( } export async function createBlinkReview( - projectDir: string, options: { region?: PixelRegion; root?: string } = {}, + projectDir: string, options: { region?: PixelRegion; root?: string; timed?: boolean } = {}, ) { const root = resolve(options.root ?? process.cwd()); const project = await checkedPath(root, resolve(root, projectDir)); @@ -135,43 +136,68 @@ export async function createBlinkReview( const framesDir = join(runRoot, "frames"); await mkdir(framesDir, { recursive: true }); + const values = options.timed ? timedBlinkValues() : BLINK_REVIEW_VALUES; const frames: string[] = []; - for (let index = 0; index < BLINK_CLOSING_VALUES.length; index++) { - const value = BLINK_CLOSING_VALUES[index]!; + const cachedFrames = new Map(); + let engineFramesRendered = 0; + for (let index = 0; index < values.length; index++) { + const value = values[index]!; const path = join(framesDir, `frame-${String(index).padStart(3, "0")}.png`); - await runRev2D(backend, [ - "render", modelPath, "-o", path, "--param", `EyeLOpen=${value}`, - "--param", `EyeROpen=${value}`, "--bg", "#f0eaf4", "--ss", "1", - ], 60_000); - frames.push(path); - } - for (let index = BLINK_CLOSING_VALUES.length; index < BLINK_REVIEW_VALUES.length; index++) { - const sourceIndex = BLINK_REVIEW_VALUES.length - 1 - index; - const path = join(framesDir, `frame-${String(index).padStart(3, "0")}.png`); - await copyFile(frames[sourceIndex]!, path); + const prior = cachedFrames.get(value.toFixed(6)); + if (prior) { + await copyFile(prior, path); + } else { + await runRev2D(backend, [ + "render", modelPath, "-o", path, "--param", `EyeLOpen=${value}`, + "--param", `EyeROpen=${value}`, "--bg", "#f0eaf4", "--ss", "1", + ], 60_000); + cachedFrames.set(value.toFixed(6), path); + engineFramesRendered++; + } frames.push(path); } const report = await comparePngSequence(frames, { - region, controlValues: BLINK_REVIEW_VALUES, + region, controlValues: values, }, root); const fullSheet = join(runRoot, "blink-full.png"); const eyeSheet = join(runRoot, "blink-eyes.png"); - await contactSheet(framesDir, fullSheet); - await contactSheet(framesDir, eyeSheet, region); + await contactSheet(framesDir, fullSheet, undefined, options.timed ? 6 : 5); + await contactSheet(framesDir, eyeSheet, region, options.timed ? 6 : 5); + const timedVideo = options.timed ? join(runRoot, "blink-timed-30fps.mp4") : undefined; + if (timedVideo) { + try { + await execFileAsync("ffmpeg", [ + "-nostdin", "-hide_banner", "-loglevel", "error", "-n", + "-framerate", "30", "-i", join(framesDir, "frame-%03d.png"), + "-frames:v", String(values.length), + "-c:v", "libx264", "-pix_fmt", "yuv420p", "-movflags", "+faststart", + timedVideo, + ], { windowsHide: true, shell: false, timeout: 90_000, maxBuffer: 4_000_000 }); + } catch (cause) { + throw new AvatarWorkflowError("BLINK_TIMED_EXPORT_FAILED", + "Cannot encode the synthetic timing preview: " + String(cause)); + } + } const reportPath = join(runRoot, "blink-review.json"); const evidence = { version: 1, status: "visual-review-required", approvedByThisCommand: false, projectDir: project, - values: BLINK_REVIEW_VALUES, - closingFramesRendered: BLINK_CLOSING_VALUES.length, - openingFramesReused: BLINK_REVIEW_VALUES.length - BLINK_CLOSING_VALUES.length, + mode: options.timed ? "synthetic-30fps-playback" : "parameter-sweep", + ...(options.timed ? { timing: TIMED_BLINK, timedVideo } : {}), + values, + engineFramesRendered, + repeatedFramesCopied: values.length - engineFramesRendered, + closingFramesRendered: options.timed ? undefined : BLINK_CLOSING_VALUES.length, + openingFramesReused: options.timed ? undefined : BLINK_REVIEW_VALUES.length - BLINK_CLOSING_VALUES.length, fpsForContactOrdering: 30, region, report, fullSheet, eyeSheet, framesDirectory: framesDir, notes: [ - "Static eye sprites can plateau despite control changes; inspect every contact panel, particularly EyeOpen=0.19/0.69.", + options.timed + ? "Synthetic 140ms close, 65ms hold, 240ms open at 30fps; this is a playback diagnostic, not human-motion proof." + : "Parameter sweep is not natural blink timing; inspect EyeOpen=0.19/0.69.", "Numbers cannot assess lash seams, iris clipping, head turns or whether eyelids look natural.", "This command never changes the rig or its approval state. A human must still approve intentionally.", ], diff --git a/src/character/timed-blink.ts b/src/character/timed-blink.ts new file mode 100644 index 0000000..cfc8329 --- /dev/null +++ b/src/character/timed-blink.ts @@ -0,0 +1,50 @@ +/** + * Deterministic 1.2-second natural-*timing* diagnostic for a 30 fps blink. + * + * This is a sampling schedule, NOT a guarantee the underlying eyelid art is + * natural or the rig physically plausible. Closing = 140 ms, hold = 65 ms, + * opening = 240 ms. Frame n samples exactly n * 1000/30 milliseconds. + */ +export const TIMED_BLINK = Object.freeze({ + fps: 30, + durationMs: 1200, + closeStartMs: 250, + closeEndMs: 390, + holdEndMs: 455, + openEndMs: 695, +}); + +function smoothstep(p: number): number { + const t = Math.min(1, Math.max(0, p)); + return t * t * (3 - 2 * t); +} + +export function sampledBlinkAtMs(timeMs: number): number { + if (!Number.isFinite(timeMs) || timeMs < 0) { + throw new RangeError("Blink sample time must be a finite, nonnegative number"); + } + if (timeMs <= TIMED_BLINK.closeStartMs) return 1; + if (timeMs < TIMED_BLINK.closeEndMs) { + return 1 - smoothstep( + (timeMs - TIMED_BLINK.closeStartMs) / + (TIMED_BLINK.closeEndMs - TIMED_BLINK.closeStartMs), + ); + } + if (timeMs <= TIMED_BLINK.holdEndMs) return 0; + if (timeMs < TIMED_BLINK.openEndMs) { + return smoothstep( + (timeMs - TIMED_BLINK.holdEndMs) / + (TIMED_BLINK.openEndMs - TIMED_BLINK.holdEndMs), + ); + } + return 1; +} + +export function timedBlinkValues(): number[] { + const frames = (TIMED_BLINK.durationMs / 1000) * TIMED_BLINK.fps; + if (!Number.isInteger(frames) || frames < 2 || frames > 60) { + throw new RangeError("Unsupported timed blink diagnostic frame count"); + } + return Array.from({ length: frames }, (_, index) => + Number(sampledBlinkAtMs((index * 1000) / TIMED_BLINK.fps).toFixed(6))); +} diff --git a/src/cli/index.ts b/src/cli/index.ts index 5ef5157..feecc16 100644 --- a/src/cli/index.ts +++ b/src/cli/index.ts @@ -42,7 +42,7 @@ function usage(): never { " puppetctl character variants status \n" + " puppetctl character variants import [--experimental-short-fade|--experimental-stepped-eyes] --reviewed-art\n" + " puppetctl character qa compare [--region x,y,w,h]\n" + - " puppetctl character qa blink [--region x,y,w,h]\n" + + " puppetctl character qa blink [--timed] [--region x,y,w,h]\n" + " puppetctl character qa sequence ... [--region x,y,w,h] [--cut-after i,j] [--control-values v1,v2,...]\n" + " puppetctl character landmarks assist \n" + " puppetctl character landmarks propose --provider codex\n" + @@ -194,11 +194,19 @@ async function run(): Promise { if (first === "character" && second === "qa" && third === "blink") { const [project, ...flags] = process.argv.slice(5); - if (!project || (flags.length !== 0 && - (flags.length !== 2 || flags[0] !== "--region" || !flags[1]))) usage(); - print(await createBlinkReview(project, { - ...(flags.length ? { region: parsePixelRegionArgument(flags[1]!) } : {}), - })); + if (!project || project.startsWith("--")) usage(); + let timed = false; + let region: ReturnType | undefined; + for (let index = 0; index < flags.length; index++) { + const flag = flags[index]; + if (flag === "--timed" && !timed) { + timed = true; + } else if (flag === "--region" && !region && flags[index + 1] && + !flags[index + 1]!.startsWith("--")) { + region = parsePixelRegionArgument(flags[++index]!); + } else usage(); + } + print(await createBlinkReview(project, { timed, ...(region ? { region } : {}) })); return; } diff --git a/tests/timed-blink.test.ts b/tests/timed-blink.test.ts new file mode 100644 index 0000000..2efd6fc --- /dev/null +++ b/tests/timed-blink.test.ts @@ -0,0 +1,35 @@ +import { describe, expect, it } from "vitest"; +import { TIMED_BLINK, sampledBlinkAtMs, timedBlinkValues } from "../src/character/timed-blink.js"; + +describe("30 fps time-domain blink diagnostic", () => { + it("samples frame n at n/30 s for exactly 1.2 seconds without endpoint duplication", () => { + const values = timedBlinkValues(); + expect(values).toHaveLength(36); + expect(values[0]).toBe(1); + expect(values.at(-1)).toBe(1); + for (let i = 0; i < values.length; i++) { + expect(values[i]).toBeCloseTo( + Number(sampledBlinkAtMs(i * 1000 / TIMED_BLINK.fps).toFixed(6)), 7); + } + }); + it("has open lead-in, one closed hold, and open tail; bounds every frame", () => { + const values = timedBlinkValues(); + expect(values.slice(0, 8)).toEqual(Array(8).fill(1)); + expect(values.some((x) => x === 0)).toBe(true); + expect(values.slice(22)).toEqual(Array(14).fill(1)); + expect(values.every((x) => x >= 0 && x <= 1 && Number.isFinite(x))).toBe(true); + expect(values.filter((x) => x === 0).length).toBeGreaterThanOrEqual(2); + }); + it("keeps the closing segment monotonically decreasing and opening increasing", () => { + const values = timedBlinkValues(); + for (let i = 9; i <= 11; i++) expect(values[i]).toBeLessThanOrEqual(values[i - 1]!); + for (let i = 15; i <= 20; i++) expect(values[i]).toBeGreaterThanOrEqual(values[i - 1]!); + expect(values[11]).toBeLessThan(0.08); + expect(values[18]).toBeGreaterThan(0.5); + }); + it("rejects invalid sample times rather than using bogus frame values", () => { + for (const x of [NaN, -1, Infinity, -Infinity]) { + expect(() => sampledBlinkAtMs(x)).toThrow(RangeError); + } + }); +});