From 10ffe77f4a6cdedccb72e20ce1bef0fbbfbdabea Mon Sep 17 00:00:00 2001 From: Vance Ingalls Date: Tue, 9 Jun 2026 15:50:42 -0700 Subject: [PATCH] docs(engine): root-cause the video fast-capture gate + R&D escape hatch Probing established the real failure mode: drawElementImage drops layer-promoted subtrees while their transforms animate (sub-composition entrance/zoom scenes capture black until settled). The injected video captures fine; paint-event sync and an opaque canvas destination both made zero difference (bit-identical output). Chromium-side gap, same family as crbug 521434899 but reproducible on GPU. HF_FAST_CAPTURE_VIDEO=true bypasses the gate for future probing. Co-Authored-By: Claude Opus 4.8 (1M context) --- packages/engine/src/services/frameCapture.ts | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/packages/engine/src/services/frameCapture.ts b/packages/engine/src/services/frameCapture.ts index fee28cfe0e..fe96f3e6f1 100644 --- a/packages/engine/src/services/frameCapture.ts +++ b/packages/engine/src/services/frameCapture.ts @@ -347,10 +347,21 @@ async function initDrawElementOrTransparentBackground( if (useDrawElement) { session.isSwiftShader = await detectSwiftShader(page); const transparent = session.options.format === "png"; - // drawElementImage does not capture the per-frame video (the snapshot - // predates it) — verified black on both macOS and native Linux/BeginFrame — - // so any composition containing