From c38ac5438c751094a720c55c68bd15fc6450ec37 Mon Sep 17 00:00:00 2001 From: Vance Ingalls Date: Mon, 9 Nov 2026 09:10:46 +0000 Subject: [PATCH] feat(producer): distributed and range renders honour page motion blur (#7311) * feat(producer): distributed and range renders honour page motion blur A film with data-motion-blur="on" blurs the same way however it is rendered. plan() no longer forces the synthetic job to pageMotionBlur "off", so the plan locks screenshot capture for a blurred film as a whole render does, and renderChunk() no longer defaults the page's off switch to "distributed-render". An explicit pageMotionBlur "off" in the config still stands the page down. Hosted renders pick this up after the next OSS release and a producer pin bump; a render of a blur-on film that goes distributed changes output then. Co-Authored-By: Claude Sonnet 5.5 * test(producer): the default tier blurs the same in chunks; docs agree distributed renders blur Two files compare plan -> renderChunk -> assemble with the tier attribute removed, so `auto` (the filter tier) decides, against a whole render: held-card and callbacks (the muted-callback path). The skill's motion reference no longer says distributed renders are off. The rewritten R19 plan test gets 60 s for its three plan() calls. Co-Authored-By: Claude Sonnet 5.5 --------- Co-authored-by: Claude Sonnet 5.5 --- docs/guides/motion-blur.mdx | 3 +- packages/cli/src/docs/motion-blur.md | 2 +- .../producer/scripts/integration-tests.json | 7 + packages/producer/scripts/run-test-lane.mjs | 8 +- .../__test_utils__/blurChunkRender.ts | 210 ++++++++++++++++++ .../blurChunks.callbacks.integration.test.ts | 21 ++ ...Chunks.callbacksFilter.integration.test.ts | 24 ++ .../blurChunks.configOff.integration.test.ts | 41 ++++ .../blurChunks.heldCard.integration.test.ts | 21 ++ ...rChunks.heldCardFilter.integration.test.ts | 24 ++ ...rChunks.onceGuardLabel.integration.test.ts | 21 ++ .../blurChunks.scrollList.integration.test.ts | 21 ++ .../services/distributed/chunkFrames.test.ts | 4 +- .../src/services/distributed/chunkFrames.ts | 2 +- .../src/services/distributed/plan.test.ts | 33 +-- .../producer/src/services/distributed/plan.ts | 1 + .../src/services/distributed/renderChunk.ts | 1 + .../renderConfigValidation.test.ts | 21 ++ .../src/services/distributed/shared.ts | 3 +- scripts/test-reachability.json | 2 +- skills-manifest.json | 2 +- skills/hyperframes/references/motion.md | 2 +- 22 files changed, 448 insertions(+), 26 deletions(-) create mode 100644 packages/producer/src/services/distributed/__test_utils__/blurChunkRender.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.callbacks.integration.test.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.callbacksFilter.integration.test.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.configOff.integration.test.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.heldCard.integration.test.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.heldCardFilter.integration.test.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.onceGuardLabel.integration.test.ts create mode 100644 packages/producer/src/services/distributed/blurChunks.scrollList.integration.test.ts diff --git a/docs/guides/motion-blur.mdx b/docs/guides/motion-blur.mdx index 8fb1b4c391..a9e3950407 100644 --- a/docs/guides/motion-blur.mdx +++ b/docs/guides/motion-blur.mdx @@ -69,7 +69,7 @@ A page that asks for capture gets the filter tier instead when capture cannot ru This is decided once for the whole composition, from the first frame. A defect the scan misses (a WebGL canvas added late, say) is caught per frame instead: that one frame is rendered sharp and counted in `failedFrames`. -Blur is off, and stays off, for HDR renders, distributed renders, and renders that use the engine's own sub-frame blur. +Blur is off, and stays off, for HDR renders and renders that use the engine's own sub-frame blur. Distributed renders (`plan`, `renderChunk`, `assemble`, as the AWS Lambda and Google Cloud Run adapters run them) and `--start`/`--end` range renders blur like a whole local render. Pass `--page-motion-blur off` (or `pageMotionBlur: "off"` in a distributed config) to render them sharp. ### Find out which one is drawing @@ -88,6 +88,7 @@ In the page, `window.__hfMotionBlur.report()` returns `state`, `tier`, `reason`, ## Cost and limits - **Render time.** It varies by film. On an 8 s test composition with four whips, a render took 9.8 s with capture, 5.2–5.4 s with the filter tier and 5.3–5.9 s with no blur (two runs each, including startup). On two real 1080p films the filter tier cost more than capture, measured as CPU seconds of the whole render (wall time was too noisy on a loaded machine): `spacex-launch` (77 movers, 39.5 s) took 547–552 CPU s with the filter tier, 302–320 with capture and 184–193 with no blur (three runs each, 2.9 times no blur); `k3-promo` (106 movers, 16.5 s) took 236, 205 and 117 (one run per arm, 2.0 times no blur). The two films do not order by mover count, and the cause of the difference was not isolated. The filter tier draws each mover as at least 32 offset copies per frame; capture adds a second paint per blurred frame. +- **Distributed renders.** Blur applies in every chunk, drawn with the filter tier on `auto`. Measured on two real 1080p films with plan, `renderChunk` and assemble at 240 frames per chunk, in a software-GPU Chrome 153 on a machine other work was loading (load average 12 to 25), one run per arm: summed chunk CPU seconds went from 155 to 246 (1.6 times) on `k3-promo` and from 338 to 545 (1.6 times) on `spacex-launch`; summed chunk wall time rose 1.2 and 1.4 times. A film with `data-motion-blur="on"` also plans screenshot capture instead of BeginFrame capture, and the measured cost includes that switch. - **Editing.** The filter tier never wraps anything. With capture the root is wrapped only while playing or rendering; paused, it is plain DOM, so click-to-select works. - **Capture only.** Blurred preview can run at half the frame rate on heavy compositions, and a `