@meimu/mutracer 0.0.0-stage → 0.1.0

package/lib/renderer/staticBvhPreparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticBvhPreparation.js","sourceRoot":"","sources":["../../src/renderer/staticBvhPreparation.ts"],"names":[],"mappings":"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","sourcesContent":["import { setGeometryBvh, type BvhBuildConfig } from './geometryBvh.js';\nimport type Mesh from '../scene/Mesh.js';\nimport type Geometry from '../scene/Geometry.js';\nimport type { TinyBvhLayout } from '../tinybvh/TinyBvhBuilder.js';\nimport { buildBLAS, type FlattendBVH } from './bvhAccel.js';\nimport {\n  buildBvhInWorker, BvhWorkerPool, BvhWorkerUnavailableError, BvhWorkerDisposedError\n} from './bvhWorkerClient.js';\nimport {\n  captureMeshBlasSnapshot,\n  getMeshBlasInput,\n  getPreparedMeshGeometry,\n  meshNeedsStaticBvh,\n  meshBlasSnapshotIsCurrent\n} from './prepareMeshBVH.js';\n\nexport interface StaticBvhPreparationOptions {\n  config?: BvhBuildConfig;\n  builder: 'builtin' | 'tinybvh';\n  layout: TinyBvhLayout;\n  spatialSplits: boolean;\n  useWorker: boolean;\n  workerPool?: BvhWorkerPool;\n  isCancelled?: () => boolean;\n  rebuild: boolean;\n  onProgress?: (progress: number) => void;\n}\n\nexport interface StaticBvhPreparationResult {\n  geometryCount: number;\n  bvhTimeMs: number;\n  failedMeshes: Mesh[];\n  workerUnavailable: boolean;\n  tinyBvhUnavailable: boolean;\n}\n\n/** Build static BLASes once per target geometry, preserving old BVHs until writeback. */\nexport async function prepareStaticBvhs(\n  meshes: readonly Mesh[], options: StaticBvhPreparationOptions\n): Promise<StaticBvhPreparationResult> {\n  const result: StaticBvhPreparationResult = {\n    geometryCount: 0, bvhTimeMs: 0, failedMeshes: [],\n    workerUnavailable: false, tinyBvhUnavailable: false\n  };\n  const jobs = new Map<Geometry, {\n    mesh: Mesh;\n    snapshot: ReturnType<typeof captureMeshBlasSnapshot>;\n  }>();\n  for (const mesh of meshes) {\n    if (!mesh.geometry.position?.array.length || mesh.geometry.dynamic) continue;\n    const target = getPreparedMeshGeometry(mesh);\n    if (jobs.has(target) || (!meshNeedsStaticBvh(mesh, options.config ?? options) && !options.rebuild)) continue;\n    try {\n      jobs.set(target, { mesh, snapshot: captureMeshBlasSnapshot(mesh, target) });\n    } catch {\n      result.failedMeshes.push(mesh);\n    }\n  }\n  const pool = options.useWorker ? options.workerPool ?? new BvhWorkerPool(1) : undefined;\n\n  async function build(\n    input: ReturnType<typeof getMeshBlasInput>, builder: StaticBvhPreparationOptions['builder'], useWorker: boolean\n  ): Promise<FlattendBVH> {\n    const { geometry, displacementScale, trianglesDisplacement } = input;\n    let bvh: FlattendBVH & { bvhTimeMs?: number };\n    if (useWorker) {\n      bvh = await buildBvhInWorker(geometry, displacementScale, trianglesDisplacement,\n        builder, builder === 'tinybvh' ? options.layout : 'bvh2', options.spatialSplits, pool);\n    } else if (builder === 'tinybvh') {\n      const { buildTinyBvh } = await import('../tinybvh/TinyBvhBuilder.js');\n      bvh = await buildTinyBvh(geometry, displacementScale, trianglesDisplacement,\n        options.layout, options.spatialSplits);\n    } else {\n      const start = performance.now();\n      bvh = { ...buildBLAS(geometry, displacementScale, trianglesDisplacement),\n        bvhTimeMs: performance.now() - start };\n    }\n    if (builder === 'tinybvh' && (bvh.builder !== 'tinybvh' || !bvh.buffer.byteLength)) {\n      throw new Error('TinyBVH did not build every scene geometry.');\n    }\n    result.bvhTimeMs += bvh.bvhTimeMs ?? 0;\n    return bvh;\n  }\n\n  async function buildWithFallback(input: ReturnType<typeof getMeshBlasInput>) {\n    let builder = options.builder;\n    let useWorker = options.useWorker && !result.workerUnavailable;\n    for (;;) {\n      if (options.isCancelled?.()) throw new BvhWorkerDisposedError();\n      try {\n        return await build(input, builder, useWorker);\n      } catch (error) {\n        if (error instanceof BvhWorkerDisposedError) throw error;\n        if (error instanceof BvhWorkerUnavailableError && useWorker) {\n          result.workerUnavailable = true;\n          useWorker = false;\n        } else if (builder === 'tinybvh') {\n          result.tinyBvhUnavailable = true;\n          builder = 'builtin';\n          useWorker = options.useWorker && !result.workerUnavailable;\n        } else {\n          throw error;\n        }\n      }\n    }\n  }\n\n  let completed = 0;\n  // Large BLASes start first to reduce the tail. Only active lanes prepare\n  // attributes/displacement inputs and submit geometry to Workers.\n  const pending = [...jobs].sort(([a], [b]) =>\n    (b.indices?.array.length ?? 0) - (a.indices?.array.length ?? 0));\n  let next = 0;\n  async function runLane() {\n    while (next < pending.length && !options.isCancelled?.()) {\n      const [target, { mesh, snapshot }] = pending[next++];\n      try {\n        if (!meshBlasSnapshotIsCurrent(mesh, target, snapshot)) continue;\n        const input = getMeshBlasInput(mesh);\n        const bvh = await buildWithFallback(input);\n        if (!options.isCancelled?.() && meshBlasSnapshotIsCurrent(mesh, target, snapshot)) {\n          setGeometryBvh(target, bvh, options.config ?? options);\n          result.geometryCount++;\n        }\n      } catch (error) {\n        if (!(error instanceof BvhWorkerDisposedError)) result.failedMeshes.push(mesh);\n      } finally {\n        if (!options.isCancelled?.()) {\n          // A loading-screen callback must not stop a lane and strand jobs.\n          try { options.onProgress?.(++completed / jobs.size); } catch { /* Keep building. */ }\n        }\n      }\n    }\n  }\n  try {\n    await Promise.allSettled(Array.from({ length: Math.min(pool?.size ?? 1, jobs.size) }, runLane));\n  } finally {\n    if (!options.workerPool) pool?.dispose();\n  }\n  return result;\n}\n"]}

package/lib/renderer/textureRegion.d.ts

@@ -0,0 +1,8 @@
+export declare function setTextureRegion(texture: object, width: number, height: number): void;
+export declare function textureRegion(texture: {
+    width: number;
+    height: number;
+}): {
+    width: number;
+    height: number;
+};

package/lib/renderer/textureRegion.js

@@ -0,0 +1,9 @@
+/** Logical image region of a reusable, larger physical scratch texture. */
+const regions = new WeakMap();
+export function setTextureRegion(texture, width, height) {
+    regions.set(texture, { width, height });
+}
+export function textureRegion(texture) {
+    return regions.get(texture) ?? { width: texture.width, height: texture.height };
+}
+//# sourceMappingURL=textureRegion.js.map

package/lib/renderer/textureRegion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureRegion.js","sourceRoot":"","sources":["../../src/renderer/textureRegion.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,OAAO,GAAG,IAAI,OAAO,EAA2C,CAAC;AACvE,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,KAAa,EAAE,MAAc;IAC7E,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAC,KAAK,EAAE,MAAM,EAAC,CAAC,CAAC;AACxC,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,OAAwC;IACpE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAC,CAAC;AAChF,CAAC","sourcesContent":["/** Logical image region of a reusable, larger physical scratch texture. */\nconst regions = new WeakMap<object, {width: number; height: number}>();\nexport function setTextureRegion(texture: object, width: number, height: number) {\n  regions.set(texture, {width, height});\n}\nexport function textureRegion(texture: {width: number; height: number}) {\n  return regions.get(texture) ?? {width: texture.width, height: texture.height};\n}\n"]}

package/lib/renderer/texturesFromMaterials.d.ts

@@ -0,0 +1,6 @@
+import OpenPBRMaterial, { MaterialTextureName } from '../scene/OpenPBRMaterial.js';
+import Texture from '../scene/Texture.js';
+export declare function mergeTexturesFromMaterials<T extends MaterialTextureName>(materials: OpenPBRMaterial[], textureNames: readonly T[]): {
+    textures: Texture[];
+    indices: Record<T, number[]>;
+};

package/lib/renderer/texturesFromMaterials.js

@@ -0,0 +1,37 @@
+// Portions adapted from ray-tracing-renderer@0.10.15
+// (https://github.com/hoverinc/ray-tracing-renderer).
+// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.
+// retrieve textures used by meshes, grouping textures from meshes shared *across all* mesh properties
+export function mergeTexturesFromMaterials(materials, textureNames) {
+    const textureMap = {
+        textures: [],
+        indices: {}
+    };
+    for (const name of textureNames) {
+        textureMap.indices[name] = texturesFromMaterials(materials, name, textureMap.textures);
+    }
+    return textureMap;
+}
+function texturesFromMaterials(materials, textureName, textures) {
+    const indices = [];
+    for (const material of materials) {
+        const isTextureLoaded = material[textureName] &&
+            material[textureName].image;
+        if (!isTextureLoaded) {
+            indices.push(-1);
+        }
+        else {
+            let existsIndex = textures.indexOf(material[textureName]);
+            if (existsIndex >= 0) {
+                // Reuse existing duplicate texture.
+                indices.push(existsIndex);
+            }
+            else {
+                indices.push(textures.length);
+                textures.push(material[textureName]);
+            }
+        }
+    }
+    return indices;
+}
+//# sourceMappingURL=texturesFromMaterials.js.map

package/lib/renderer/texturesFromMaterials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturesFromMaterials.js","sourceRoot":"","sources":["../../src/renderer/texturesFromMaterials.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,sDAAsD;AACtD,kFAAkF;AAOlF,sGAAsG;AACtG,MAAM,UAAU,0BAA0B,CACxC,SAA4B,EAC5B,YAA0B;IAE1B,MAAM,UAAU,GAGZ;QACF,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAyB;KACnC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAC9C,SAAS,EACT,IAAI,EACJ,UAAU,CAAC,QAAQ,CACpB,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,qBAAqB,CAC5B,SAA4B,EAC5B,WAAgC,EAChC,QAAmB;IAEnB,MAAM,OAAO,GAAG,EAAE,CAAC;IAEnB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,eAAe,GACnB,QAAQ,CAAC,WAAW,CAAC;YACrB,QAAQ,CAAC,WAAW,CAAE,CAAC,KAAK,CAAC;QAE/B,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,IAAI,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAE,CAAC,CAAC;YAC3D,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,oCAAoC;gBACpC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["// Portions adapted from ray-tracing-renderer@0.10.15\n// (https://github.com/hoverinc/ray-tracing-renderer).\n// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.\n\nimport OpenPBRMaterial, {\n  MaterialTextureName\n} from '../scene/OpenPBRMaterial.js';\nimport Texture from '../scene/Texture.js';\n\n// retrieve textures used by meshes, grouping textures from meshes shared *across all* mesh properties\nexport function mergeTexturesFromMaterials<T extends MaterialTextureName>(\n  materials: OpenPBRMaterial[],\n  textureNames: readonly T[]\n) {\n  const textureMap: {\n    textures: Texture[];\n    indices: Record<T, number[]>;\n  } = {\n    textures: [],\n    indices: {} as Record<T, number[]>\n  };\n\n  for (const name of textureNames) {\n    textureMap.indices[name] = texturesFromMaterials(\n      materials,\n      name,\n      textureMap.textures\n    );\n  }\n\n  return textureMap;\n}\n\nfunction texturesFromMaterials(\n  materials: OpenPBRMaterial[],\n  textureName: MaterialTextureName,\n  textures: Texture[]\n) {\n  const indices = [];\n\n  for (const material of materials) {\n    const isTextureLoaded =\n      material[textureName] &&\n      material[textureName]!.image;\n\n    if (!isTextureLoaded) {\n      indices.push(-1);\n    } else {\n      let existsIndex = textures.indexOf(material[textureName]!);\n      if (existsIndex >= 0) {\n        // Reuse existing duplicate texture.\n        indices.push(existsIndex);\n      } else {\n        indices.push(textures.length);\n        textures.push(material[textureName]!);\n      }\n    }\n  }\n\n  return indices;\n}\n"]}

package/lib/renderer/util.d.ts

@@ -0,0 +1,17 @@
+import { WritableArrayLike } from '../types.js';
+export declare function clamp(x: number, min: number, max: number): number;
+export declare function shuffle(arr: WritableArrayLike<number>, rand: () => number): WritableArrayLike<number>;
+export declare function numberArraysEqual(a: ArrayLike<number>, b: ArrayLike<number>, eps?: number): boolean;
+export declare const isMac: false | RegExpMatchArray | null;
+/** Detect the WebGL workaround platform only when the WebGL backend needs it. */
+export declare function isIntelMac(): boolean;
+/** Lowest resolution scale interactive preview adapts down to. */
+export declare const MIN_PREVIEW_SCALE = 0.25;
+/**
+ * Next interactive-preview resolution scale from a preview frame time measured
+ * at `measuredScale`. Tracing and denoising cost grow with the pixel count
+ * (scale²), so the scale follows the square root of the time ratio. Steps are
+ * 1/16 (1/32 below 0.25); a change of less than 15% from `currentScale` keeps
+ * it, because every resolution change restarts sampling.
+ */
+export declare function nextPreviewScale(measuredScale: number, frameTimeMs: number, targetTimeMs: number, maxScale: number, currentScale?: number, minScale?: number): number;

package/lib/renderer/util.js

@@ -0,0 +1,56 @@
+import { createCanvas } from '../util/canvas.js';
+export function clamp(x, min, max) {
+    return Math.min(Math.max(x, min), max);
+}
+export function shuffle(arr, rand) {
+    for (let i = arr.length - 1; i > 0; i--) {
+        const j = Math.floor(rand() * (i + 1));
+        const x = arr[i];
+        arr[i] = arr[j];
+        arr[j] = x;
+    }
+    return arr;
+}
+export function numberArraysEqual(a, b, eps = 1e-4) {
+    for (let i = 0; i < a.length; i++) {
+        if (Math.abs(a[i] - b[i]) > eps) {
+            return false;
+        }
+    }
+    return true;
+}
+export const isMac = typeof navigator !== 'undefined' && navigator.userAgent.match('Macintosh');
+let cachedIntelMac;
+/** Detect the WebGL workaround platform only when the WebGL backend needs it. */
+export function isIntelMac() {
+    if (cachedIntelMac !== undefined)
+        return cachedIntelMac;
+    cachedIntelMac = false;
+    if (isMac) {
+        try {
+            const ctx = createCanvas().getContext('webgl');
+            const d = ctx && ctx.getExtension('WEBGL_debug_renderer_info');
+            const g = (d && ctx.getParameter(d.UNMASKED_RENDERER_WEBGL)) || '';
+            if (!(g.match(/Apple M/) || g.match(/Apple GPU/)))
+                cachedIntelMac = true;
+        }
+        catch (e) { }
+    }
+    return cachedIntelMac;
+}
+/** Lowest resolution scale interactive preview adapts down to. */
+export const MIN_PREVIEW_SCALE = 0.25;
+/**
+ * Next interactive-preview resolution scale from a preview frame time measured
+ * at `measuredScale`. Tracing and denoising cost grow with the pixel count
+ * (scale²), so the scale follows the square root of the time ratio. Steps are
+ * 1/16 (1/32 below 0.25); a change of less than 15% from `currentScale` keeps
+ * it, because every resolution change restarts sampling.
+ */
+export function nextPreviewScale(measuredScale, frameTimeMs, targetTimeMs, maxScale, currentScale = measuredScale, minScale = MIN_PREVIEW_SCALE) {
+    const raw = measuredScale * Math.sqrt(targetTimeMs / Math.max(frameTimeMs, 0.1));
+    const steps = raw < 0.25 ? 32 : 16;
+    const next = clamp(Math.round(raw * steps) / steps, minScale, Math.max(minScale, maxScale));
+    return Math.abs(Math.log(next / currentScale)) >= Math.log(1.15) ? next : currentScale;
+}
+//# sourceMappingURL=util.js.map

package/lib/renderer/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/renderer/util.ts"],"names":[],"mappings":"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","sourcesContent":["import {createCanvas} from '../util/canvas.js';\n// Portions adapted from ray-tracing-renderer@0.10.15\n// (https://github.com/hoverinc/ray-tracing-renderer).\n// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.\n\nimport { WritableArrayLike } from '../types.js';\n\nexport function clamp(x: number, min: number, max: number) {\n  return Math.min(Math.max(x, min), max);\n}\n\nexport function shuffle(arr: WritableArrayLike<number>, rand: () => number) {\n  for (let i = arr.length - 1; i > 0; i--) {\n    const j = Math.floor(rand() * (i + 1));\n    const x = arr[i];\n    arr[i] = arr[j];\n    arr[j] = x;\n  }\n  return arr;\n}\n\nexport function numberArraysEqual(\n  a: ArrayLike<number>,\n  b: ArrayLike<number>,\n  eps = 1e-4\n) {\n  for (let i = 0; i < a.length; i++) {\n    if (Math.abs(a[i] - b[i]) > eps) {\n      return false;\n    }\n  }\n\n  return true;\n}\nexport const isMac =\n  typeof navigator !== 'undefined' && navigator.userAgent.match('Macintosh');\n\nlet cachedIntelMac: boolean | undefined;\n\n/** Detect the WebGL workaround platform only when the WebGL backend needs it. */\nexport function isIntelMac() {\n  if (cachedIntelMac !== undefined) return cachedIntelMac;\n  cachedIntelMac = false;\n  if (isMac) {\n    try {\n      const ctx = createCanvas().getContext('webgl') as WebGLRenderingContext | null;\n      const d = ctx && ctx.getExtension('WEBGL_debug_renderer_info');\n      const g = (d && ctx.getParameter(d.UNMASKED_RENDERER_WEBGL)) || '';\n      if (!(g.match(/Apple M/) || g.match(/Apple GPU/))) cachedIntelMac = true;\n    } catch (e) {}\n  }\n  return cachedIntelMac;\n}\n\n/** Lowest resolution scale interactive preview adapts down to. */\nexport const MIN_PREVIEW_SCALE = 0.25;\n\n/**\n * Next interactive-preview resolution scale from a preview frame time measured\n * at `measuredScale`. Tracing and denoising cost grow with the pixel count\n * (scale²), so the scale follows the square root of the time ratio. Steps are\n * 1/16 (1/32 below 0.25); a change of less than 15% from `currentScale` keeps\n * it, because every resolution change restarts sampling.\n */\nexport function nextPreviewScale(\n  measuredScale: number,\n  frameTimeMs: number,\n  targetTimeMs: number,\n  maxScale: number,\n  currentScale = measuredScale,\n  minScale = MIN_PREVIEW_SCALE\n) {\n  const raw = measuredScale * Math.sqrt(targetTimeMs / Math.max(frameTimeMs, 0.1));\n  const steps = raw < 0.25 ? 32 : 16;\n  const next = clamp(Math.round(raw * steps) / steps, minScale, Math.max(minScale, maxScale));\n  return Math.abs(Math.log(next / currentScale)) >= Math.log(1.15) ? next : currentScale;\n}\n"]}

package/lib/renderer/webgl.d.ts

@@ -0,0 +1,131 @@
+import type { ShaderCompilationDiagnostics } from './RenderingPipeline.js';
+import { FragmentShader, ShaderDefineValue, ShaderUniform } from './shader.js';
+export { FragmentShader, Shader, createShaderMixin, glsl } from './shader.js';
+export declare const constants: {
+    readonly FLOAT: 5126;
+    readonly HALF_FLOAT: 5131;
+    readonly UNSIGNED_BYTE: 5121;
+    readonly RGBA: 6408;
+    readonly LINEAR: 9729;
+    readonly NEAREST: 9728;
+    readonly REPEAT: 10497;
+    readonly CLAMP_TO_EDGE: 33071;
+    readonly SCISSOR_TEST: 3089;
+    readonly COLOR_BUFFER_BIT: 16384;
+    readonly DEPTH_BUFFER_BIT: 256;
+    readonly LINES: 1;
+    readonly TEXTURE_2D: 3553;
+    readonly TEXTURE_2D_ARRAY: 35866;
+};
+export type TextureImageSource = any;
+export interface TexturePixelSource {
+    data: Float32Array | Int32Array | Uint8Array | Uint8ClampedArray | Uint16Array;
+    width: number;
+    height: number;
+}
+type TextureSource = TextureImageSource | TexturePixelSource;
+export interface TextureOptions {
+    source?: TextureSource | TextureImageSource[];
+    width?: number;
+    height?: number;
+    type?: number;
+    minFilter?: number;
+    magFilter?: number;
+    wrapS?: number;
+    wrapT?: number;
+    flipY?: boolean;
+    flipYArray?: boolean[];
+    useMipmap?: boolean;
+    premultiplyAlpha?: boolean;
+    sRGB?: boolean;
+}
+export declare class Texture2D {
+    private _source?;
+    width: number;
+    height: number;
+    target: number;
+    protected _options: TextureOptions;
+    protected _texture?: WebGLTexture;
+    protected _dirty: boolean;
+    protected _allocated: boolean;
+    constructor(options?: TextureOptions);
+    get storageType(): number;
+    get isByteEncoded(): boolean;
+    /** Allocated 2D render-target payload, excluding driver/FBO overhead. */
+    getMemoryBytes(): number;
+    get source(): any;
+    set source(value: any);
+    dirty(): void;
+    resize(width: number, height: number): void;
+    ensureStorage(gl: WebGL2RenderingContext, width: number, height: number, options?: TextureOptions): this;
+    bind(gl: WebGL2RenderingContext, unit: number): void;
+    /** Copies a byte range into a data texture's CPU image and uploads its covering rows. */
+    updateDataRange(gl: WebGL2RenderingContext, data: Float32Array | Int32Array | Uint8Array, offset: number, size: number): void;
+    getWebGLTexture(gl: WebGL2RenderingContext): WebGLTexture;
+    dispose(gl: WebGL2RenderingContext): void;
+    protected _ensureTexture(gl: WebGL2RenderingContext): void;
+    protected _bindAndConfigure(gl: WebGL2RenderingContext): void;
+    protected _format(gl: WebGL2RenderingContext, channels?: number): {
+        type: number;
+        format: 6408 | 6403 | 33319 | 6407;
+        internalFormat: 33326 | 33328 | 34837 | 34836 | 33325 | 33327 | 34843 | 34842 | 35907 | 32856;
+    };
+    protected _upload(gl: WebGL2RenderingContext): void;
+}
+export declare class Texture2DArray extends Texture2D {
+    target: number;
+    get flipYArray(): boolean[];
+    protected _bindAndConfigure(gl: WebGL2RenderingContext): void;
+    protected _upload(gl: WebGL2RenderingContext): void;
+    bind(gl: WebGL2RenderingContext, unit: number): void;
+}
+/** Compiled GLSL program plus its current bind-group-like values. */
+export declare class WebGLProgramBindings {
+    readonly shader: FragmentShader;
+    readonly uniforms: Record<string, ShaderUniform>;
+    readonly defines: Record<string, ShaderDefineValue>;
+    private _programs;
+    constructor(shader: FragmentShader);
+    set(name: string, value: unknown): boolean;
+    setUniforms(values: Record<string, unknown>): void;
+    get(name: string): any;
+    setDefine(name: string, value: ShaderDefineValue): void;
+    deleteDefine(name: string): void;
+    getProgram(renderer: WebGLDevice): WebGLProgram;
+    bind(renderer: WebGLDevice): void;
+}
+export interface RendererOptions extends WebGLContextAttributes {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    pixelRatio?: number;
+    parallelShaderCompile?: boolean;
+}
+export declare class WebGLDevice {
+    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
+    readonly gl: WebGL2RenderingContext;
+    readonly emptyTexture: Texture2D;
+    private _viewport;
+    private _viewportStack;
+    private _programs;
+    private _parallel?;
+    private _compilationStart;
+    private _compilationRecords;
+    constructor(options: RendererOptions);
+    createProgram(shader: FragmentShader, defines: Record<string, ShaderDefineValue>): WebGLProgram;
+    /** Cumulative program compilation measurements used by preparation progress. */
+    getShaderCompilationDiagnostics(): ShaderCompilationDiagnostics;
+    isAllProgramCompiled(): boolean;
+    resize(width: number, height: number): void;
+    getWidth(): number;
+    getHeight(): number;
+    saveViewport(): void;
+    restoreViewport(): void;
+    setViewport(x: number, y: number, width: number, height: number): void;
+    dispose(): void;
+}
+export declare class FrameBuffer {
+    private _frameBuffer?;
+    private _attachments;
+    attach(texture: Texture2D): void;
+    bind(renderer: WebGLDevice, textures?: Texture2D[], target?: number): void;
+    dispose(renderer: WebGLDevice): void;
+}