modern-canvas 0.24.10 → 0.24.11

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. */

package/dist/index.js

@@ -9633,8 +9633,18 @@ var Ja = "WeakRef" in globalThis, Ya = class extends e {
 		});
 	}
 	_maxExportPassSize() {
-		let e = this.gl, t = this.renderer.texture.maxTextureSize || e.getParameter(e.MAX_TEXTURE_SIZE) || 4096, n = e.getParameter(e.MAX_RENDERBUFFER_SIZE) || t, r = e.getParameter(e.MAX_VIEWPORT_DIMS), i = r && r.length >= 2 ? Math.min(r[0], r[1]) : t;
-		return Math.max(1, Math.min(t, n, i));
+		let e = this.gl, t = this.renderer.texture.maxTextureSize || e.getParameter(e.MAX_TEXTURE_SIZE) || 4096, n = e.getParameter(e.MAX_RENDERBUFFER_SIZE) || t, r = e.getParameter(e.MAX_VIEWPORT_DIMS), i = r && r.length >= 2 ? Math.min(r[0], r[1]) : t, a = Math.max(1, Math.min(t, n, i));
+		return this._maxDrawingBufferSize(a);
+	}
+	_maxDrawingBufferCache = 0;
+	_maxDrawingBufferSize(e) {
+		if (this._maxDrawingBufferCache) return this._maxDrawingBufferCache;
+		let t = e;
+		try {
+			let n = this.gl, r = n.canvas, i = r.width, a = r.height;
+			r.width = e, r.height = e, t = Math.min(n.drawingBufferWidth || e, n.drawingBufferHeight || e), r.width = i, r.height = a;
+		} catch {}
+		return this._maxDrawingBufferCache = Math.max(1, Math.min(e, t));
 	}
 	_exportTileLimit() {
 		let e = this.pixelRatio || 1;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.24.10",
+  "version": "0.24.11",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",