Skip to content

Write HTML. Render video. Built for agents.

docs(cli): render help says when page-side compositing is actually used (#4572)

Miguel Ángela380036903bb
diff --git a/docs/packages/cli.mdx b/docs/packages/cli.mdx
index e93c42c675..c3e4ee4fd7 100644
--- a/docs/packages/cli.mdx
+++ b/docs/packages/cli.mdx
@@ -921,7 +921,7 @@ How it uses the machine, and when it gives up:
| `--low-memory-mode` / `--no-low-memory-mode` | auto at 8 GB RAM or less | Safe profile: one worker, screenshot capture, no calibration. See the note below. |
| `--gpu` | off | Hardware FFmpeg encoding (NVENC, VideoToolbox, AMF, VAAPI, QSV) |
| `--browser-gpu` / `--no-browser-gpu` | auto locally, off in Docker | Host GPU for Chrome and WebGL capture, or software rendering. Auto probes WebGL once and falls back. |
-| `--page-side-compositing` / `--no-page-side-compositing` | on | Page-side WebGL for compatible SDR shader transitions, ~6× faster. HDR, alpha, and video disable it themselves. |
+| `--page-side-compositing` / `--no-page-side-compositing` | on | Page-side WebGL for SDR shader transitions in mp4, hls and gif, ~6× faster. webm and mov use the layered path; gif always uses page-side WebGL, even with `--no-page-side-compositing`. |
| `--experimental-fast-capture` | on where it can engage | Chrome's draw-element capture, ~2× faster; falls back to screenshots on its own. Env: `PRODUCER_EXPERIMENTAL_FAST_CAPTURE`. |
| `--frames-cache-dir` | `<tmpdir>/hyperframes-extract-cache-<uid>` | Where extracted source frames cache. `off`, `none`, `false`, or `0` disables it. `doctor` reports the live value. |
| `--max-concurrent-renders` | `2` | Concurrent jobs on the Producer server, 1–10 |
diff --git a/packages/cli/src/commands/render.ts b/packages/cli/src/commands/render.ts
index d5ecee680c..df47984c8a 100644
--- a/packages/cli/src/commands/render.ts
+++ b/packages/cli/src/commands/render.ts
@@ -326,8 +326,10 @@ export default defineCommand({
description:
"Run shader transitions on a page-side WebGL canvas inside Chrome " +
"instead of the Node-side layered blend. ~6× faster for SDR " +
- "shader-transition renders. HDR/alpha/video content auto-disables. " +
- "Use --no-page-side-compositing to force the layered path.",
+ "shader-transition renders. Used for mp4, hls and gif output without " +
+ "HDR content; for mp4 and hls it usually turns off under --experimental-fast-capture. " +
+ "webm and mov output take the layered path. --no-page-side-compositing forces " +
+ "the layered path for mp4 and hls; gif always uses the page-side canvas.",
default: true,
},
"browser-timeout": {