Skip to content

AI media harness for planning, generating, and editing locally

TypeScript

Document backdrop GPU checks

Bitti93d056e86a36
diff --git a/docs/video-effects.md b/docs/video-effects.md
index 45e7ca5..5b9aeb9 100644
--- a/docs/video-effects.md
+++ b/docs/video-effects.md
@@ -16,7 +16,7 @@ Each effect can be adjusted or removed independently. Locked tracks cannot be ed
| Vignette | Amount −100 to +100% (positive darkens, negative lightens), midpoint 0–100%, roundness −100 to +100%, and feather 0–100%. |
| 3D LUT | Import or replace a `.cube` file and blend it at 0–100% intensity. |
-For a consistent backdrop, choose **Green** or **Blue** for color-difference keying, **Black** for light, fire and glows, or **White** for dark smoke and ink. Black and white modes derive partial transparency from brightness; they are not general segmentation tools for solid subjects. The color swatch can be adjusted to the actual screen color. **Auto** measures 32 border samples on the GPU each frame, chooses the dominant green/blue/black/white group, and estimates its color. Keep the subject away from the border, or use a fixed mode and color. Existing effects retain **Custom color (RGB distance)** and their original tolerance.
+For a consistent backdrop, choose **Green** or **Blue** for color-difference keying, **Black** for light, fire and glows, or **White** for dark smoke and ink. Black and white modes derive partial transparency from brightness; they are not general segmentation tools for solid subjects. The color swatch can be adjusted to the actual screen color. **Auto** measures 32 border samples on the GPU each frame, chooses the dominant green/blue/black/white group, and estimates its color. Keep the subject away from the border, or use a fixed mode and color. Existing effects retain **Custom color** and their original tolerance.
Screen gain changes removal strength; screen balance mixes the maximum and average of the other two color channels. Clip black removes faint matte residue and clip white makes the subject opaque; the controls always maintain black below white. Background unmix removes the backdrop contribution from soft edges, while despill suppresses excess green or blue. Remove backdrop shadows normalizes the color key for darker screen pixels. Edge softness and choke/grow use source pixels (0–4 and −4–4 respectively; positive choke shrinks the matte). Speck and hole cleanup affect isolated one-pixel defects. Cleanup/choke run before softness and before the other video effects.
@@ -45,3 +45,5 @@ If a GPU is unavailable, the monitor reports an error and export refuses to prod
Implementation references: [WebGPU external textures](https://www.w3.org/TR/webgpu/#external-texture), [WGSL](https://www.w3.org/TR/WGSL/), and the [Adobe Cube specification](https://kono.phpage.fr/images/a/a1/Adobe-cube-lut-specification-1.0.pdf).
The Creative transforms are adapted from [FilmCraft's procedural looks](https://github.com/storytold/filmcraft/blob/main/crates/render/src/effects.rs), used under the [MIT license](../public/licenses/filmcraft.txt).
+
+To verify backdrop rendering on a real GPU, run `npm run dev` and open `/scripts/check-backdrop-key.html` in a WebGPU browser. The check reads test pixels to verify the four modes, Auto, partial alpha, unmix, shadow removal, cleanup, blur/sharpen composition, bypass, legacy keying, and the shared monitor/export compositor. It displays PASS or the failing assertion; production rendering does not read pixels back.