modern-canvas 0.24.10 → 0.24.13

package/dist/Engine.d.ts

@@ -71,13 +71,23 @@ export declare class Engine extends SceneTree {
     start(): Promise<void>;
     /**
      * Largest dimension (in device pixels) a single offscreen render pass can
-     * allocate. The root scene renders into a RenderTarget texture (plus a
-     * stencil renderbuffer when masks are used) sized to the canvas, so any
-     * export larger than these GPU limits throws
-     * `texImage2D: width or height out of range`. Oversized exports are tiled
-     * within this budget instead.
+     * allocate. Capped by the GPU's MAX_TEXTURE_SIZE / MAX_RENDERBUFFER_SIZE /
+     * MAX_VIEWPORT_DIMS *and* — crucially — the actual WebGL drawing-buffer size,
+     * which the browser/GPU often clamps far below MAX_TEXTURE_SIZE (tied to
+     * screen size / VRAM, e.g. ~5760 on a laptop while MAX_TEXTURE_SIZE is 16384).
+     * The export reads pixels back from the drawing buffer, so anything beyond it
+     * is lost/garbled. Oversized exports are tiled within this budget instead.
      */
     protected _maxExportPassSize(): number;
+    protected _maxDrawingBufferCache: number;
+    /**
+     * Probe the real drawing-buffer cap on the *renderer's own* GL context (its
+     * attributes — preserveDrawingBuffer / stencil / antialias — lower the cap vs
+     * a bare context, so a throwaway probe overestimates). Temporarily sizes the
+     * canvas (default framebuffer only, not the FBO textures) to `cap` and reads
+     * `drawingBufferWidth/Height`, then restores. Cached per engine.
+     */
+    protected _maxDrawingBufferSize(cap: number): number;
     /** Tile budget in logical units (the GPU limit is in device pixels). */
     protected _exportTileLimit(): number;
     /** Resize the renderer + root viewport without triggering a render. */