Files
Netcatty/components/terminal/runtime/webglRendererPolicy.ts
T
bincxz 9294a7130f perf(terminal): defer WebGL renderer for hidden panes until visible
Each terminal that loads the WebGL addon holds a live WebGL context for
its whole lifetime, and all session panes stay mounted (hidden ones
off-screen). Batch connect therefore created a WebGL context per host up
front, contending for the GPU on the main thread — also the root of the
"garbled / 花屏" corruption in #1049/#1063. Defer WebGL creation for panes
that mount hidden (background tabs of a batch) and upgrade them on first
visibility via an idempotent ensureWebglRenderer(); a hidden pane renders
through xterm's DOM renderer until shown. Visible panes (single connect,
the active tab) keep creating WebGL immediately — unchanged behavior.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-06 22:52:35 +08:00

22 lines
970 B
TypeScript

/**
* Decide whether a terminal should postpone creating its WebGL renderer until
* the pane is actually visible.
*
* Every terminal that loads the WebGL addon holds a live WebGL context for its
* whole lifetime. Batch-connecting several hosts mounts all their panes at once,
* so without deferral the renderer creates N WebGL contexts back-to-back on the
* main thread (and N contexts contend for the GPU, which is also the root of the
* "garbled / 花屏" corruption in #1049/#1063). A pane that mounts hidden does not
* need a renderer yet — it buffers output via xterm's default DOM renderer and
* upgrades to WebGL the moment it becomes visible.
*
* Visible panes (single connect, the active tab of a batch) keep the current
* behavior: WebGL is created immediately.
*/
export function shouldDeferWebglUntilVisible(opts: {
useWebGLAddon: boolean;
initiallyVisible: boolean;
}): boolean {
return opts.useWebGLAddon && !opts.initiallyVisible;
}