@luma.gl/webgl 9.0.0-beta.1 → 9.0.0-beta.10

package/dist/adapter/resources/webgl-framebuffer.d.ts

@@ -1,22 +1,19 @@
 import type { FramebufferProps, TextureFormat } from '@luma.gl/core';
 import { Framebuffer, Texture } from '@luma.gl/core';
 import { GL } from '@luma.gl/constants';
-import { WebGLDevice } from '../webgl-device';
-import { WEBGLTexture } from './webgl-texture';
-import { WEBGLRenderbuffer } from '../objects/webgl-renderbuffer';
-export type TextureAttachment = [Texture, number?, number?];
-export type Attachment = WEBGLTexture | WEBGLRenderbuffer | TextureAttachment;
+import { WebGLDevice } from "../webgl-device.js";
+import { WEBGLTexture } from "./webgl-texture.js";
+import { WEBGLTextureView } from "./webgl-texture-view.js";
+export type Attachment = WEBGLTextureView | WEBGLTexture;
 /** luma.gl Framebuffer, WebGL implementation  */
 export declare class WEBGLFramebuffer extends Framebuffer {
     device: WebGLDevice;
-    gl: WebGLRenderingContext;
+    gl: WebGL2RenderingContext;
     handle: WebGLFramebuffer;
-    get texture(): Texture<import("@luma.gl/core").TextureProps>;
+    get texture(): import("@luma.gl/core").TextureView;
     constructor(device: WebGLDevice, props: FramebufferProps);
     /** destroys any auto created resources etc. */
     destroy(): void;
-    /** Check the status */
-    protected _checkStatus(): void;
     /** In WebGL we must use renderbuffers for depth/stencil attachments (unless we have extensions) */
     protected createDepthStencilTexture(format: TextureFormat): Texture;
     /**
@@ -24,13 +21,12 @@ export declare class WEBGLFramebuffer extends Framebuffer {
      */
     protected resizeAttachments(width: number, height: number): this;
     /** Attach one attachment */
-    protected _attachOne(attachmentPoint: GL, attachment: Attachment): WEBGLTexture | WEBGLRenderbuffer;
-    protected _attachWEBGLRenderbuffer(attachment: GL, renderbuffer: WEBGLRenderbuffer): void;
+    protected _attachOne(attachmentPoint: GL, attachment: Attachment): WEBGLTexture;
     /**
      * @param attachment
      * @param texture
      * @param layer = 0 - index into WEBGLTextureArray and Texture3D or face for `TextureCubeMap`
-     * @param level  = 0 - mipmapLevel (must be 0 in WebGL1)
+     * @param level = 0 - mipmapLevel
      */
     protected _attachTexture(attachment: GL, texture: WEBGLTexture, layer: number, level: number): void;
 }

package/dist/adapter/resources/webgl-framebuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-framebuffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-framebuffer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AACnE,OAAO,EAAC,WAAW,EAAE,OAAO,EAAS,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AAGhE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE9E,iDAAiD;AACjD,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,qBAAqB,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IAEzB,IAAI,OAAO,kDAEV;gBAEW,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB;IA8CxD,+CAA+C;IACtC,OAAO,IAAI,IAAI;IAUxB,uBAAuB;IACvB,SAAS,CAAC,YAAY,IAAI,IAAI;IAW9B,mGAAmG;cAChF,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAW5E;;OAEG;cACgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA2BzE,4BAA4B;IAC5B,SAAS,CAAC,UAAU,CAClB,eAAe,EAAE,EAAE,EACnB,UAAU,EAAE,UAAU,GACrB,YAAY,GAAG,iBAAiB;IAenC,SAAS,CAAC,wBAAwB,CAAC,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,iBAAiB,GAAG,IAAI;IASzF;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CACtB,UAAU,EAAE,EAAE,EACd,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;CA2BR"}
+{"version":3,"file":"webgl-framebuffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-framebuffer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AACnE,OAAO,EAAC,WAAW,EAAE,OAAO,EAAS,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,2BAAwB;AAC5C,OAAO,EAAC,YAAY,EAAC,2BAAwB;AAC7C,OAAO,EAAC,gBAAgB,EAAC,gCAA6B;AAMtD,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAEzD,iDAAiD;AACjD,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,sBAAsB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IAEzB,IAAI,OAAO,wCAEV;gBAEW,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB;IAkDxD,+CAA+C;IACtC,OAAO,IAAI,IAAI;IAUxB,mGAAmG;cAChF,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAW5E;;OAEG;cACgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA2BzE,4BAA4B;IAC5B,SAAS,CAAC,UAAU,CAAC,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,YAAY;IAqC/E;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CACtB,UAAU,EAAE,EAAE,EACd,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;CA2BR"}

package/dist/adapter/resources/webgl-framebuffer.js

@@ -1,155 +1,190 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { Framebuffer, assert } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
 import { WEBGLTexture } from "./webgl-texture.js";
-import { WEBGLRenderbuffer } from "../objects/webgl-renderbuffer.js";
+import { WEBGLTextureView } from "./webgl-texture-view.js";
 import { getDepthStencilAttachmentWebGL } from "../converters/texture-formats.js";
+/** luma.gl Framebuffer, WebGL implementation  */
 export class WEBGLFramebuffer extends Framebuffer {
-  get texture() {
-    return this.colorAttachments[0];
-  }
-  constructor(device, props) {
-    super(device, props);
-    this.device = void 0;
-    this.gl = void 0;
-    this.handle = void 0;
-    const isDefaultFramebuffer = props.handle === null;
-    this.device = device;
-    this.gl = device.gl;
-    this.handle = this.props.handle || isDefaultFramebuffer ? this.props.handle : this.gl.createFramebuffer();
-    if (!isDefaultFramebuffer) {
-      device.setSpectorMetadata(this.handle, {
-        id: this.props.id,
-        props: this.props
-      });
-      this.autoCreateAttachmentTextures();
-      this.gl.bindFramebuffer(36160, this.handle);
-      for (let i = 0; i < this.colorAttachments.length; ++i) {
-        const attachment = this.colorAttachments[i];
-        const attachmentPoint = 36064 + i;
-        if (attachment) {
-          this._attachOne(attachmentPoint, attachment);
-        }
-      }
-      if (this.depthStencilAttachment) {
-        this._attachOne(getDepthStencilAttachmentWebGL(this.depthStencilAttachment.format), this.depthStencilAttachment);
-      }
-      this.gl.bindFramebuffer(36160, null);
-    }
-    if (props.check !== false) {
-      this._checkStatus();
-    }
-  }
-  destroy() {
-    super.destroy();
-    if (!this.destroyed && this.handle !== null) {
-      this.gl.deleteFramebuffer(this.handle);
-    }
-  }
-  _checkStatus() {
-    const {
-      gl
-    } = this;
-    const prevHandle = gl.bindFramebuffer(36160, this.handle);
-    const status = gl.checkFramebufferStatus(36160);
-    gl.bindFramebuffer(36160, prevHandle || null);
-    if (status !== 36053) {
-      throw new Error(`Framebuffer ${_getFrameBufferStatus(status)}`);
-    }
-  }
-  createDepthStencilTexture(format) {
-    return new WEBGLRenderbuffer(this.device, {
-      id: `${this.id}-depth-stencil`,
-      format,
-      width: this.width,
-      height: this.height
-    });
-  }
-  resizeAttachments(width, height) {
-    if (this.handle === null) {
-      this.width = this.gl.drawingBufferWidth;
-      this.height = this.gl.drawingBufferHeight;
-      return this;
+    device;
+    gl;
+    handle;
+    get texture() {
+        return this.colorAttachments[0];
     }
-    if (width === undefined) {
-      width = this.gl.drawingBufferWidth;
+    constructor(device, props) {
+        super(device, props);
+        // WebGL default framebuffer handle is null
+        const isDefaultFramebuffer = props.handle === null;
+        this.device = device;
+        this.gl = device.gl;
+        this.handle =
+            this.props.handle || isDefaultFramebuffer ? this.props.handle : this.gl.createFramebuffer();
+        if (!isDefaultFramebuffer) {
+            // default framebuffer handle is null, so we can't set spector metadata...
+            device.setSpectorMetadata(this.handle, { id: this.props.id, props: this.props });
+            // Auto create textures for attachments if needed
+            this.autoCreateAttachmentTextures();
+            /** Attach from a map of attachments */
+            this.gl.bindFramebuffer(36160, this.handle);
+            // Walk the attachments
+            for (let i = 0; i < this.colorAttachments.length; ++i) {
+                const attachment = this.colorAttachments[i];
+                const attachmentPoint = 36064 + i;
+                if (attachment) {
+                    this._attachOne(attachmentPoint, attachment);
+                }
+            }
+            if (this.depthStencilAttachment) {
+                this._attachOne(getDepthStencilAttachmentWebGL(this.depthStencilAttachment.props.format), this.depthStencilAttachment);
+            }
+            /** Check the status */
+            // @ts-expect-error
+            if (props.check !== false) {
+                const status = this.gl.checkFramebufferStatus(36160);
+                if (status !== 36053) {
+                    throw new Error(`Framebuffer ${_getFrameBufferStatus(status)}`);
+                }
+            }
+            this.gl.bindFramebuffer(36160, null);
+        }
     }
-    if (height === undefined) {
-      height = this.gl.drawingBufferHeight;
+    /** destroys any auto created resources etc. */
+    destroy() {
+        super.destroy(); // destroys owned resources etc.
+        if (!this.destroyed && this.handle !== null) {
+            this.gl.deleteFramebuffer(this.handle);
+            // this.handle = null;
+        }
     }
-    for (const colorAttachment of this.colorAttachments) {
-      colorAttachment.resize({
-        width,
-        height
-      });
+    // PRIVATE
+    /** In WebGL we must use renderbuffers for depth/stencil attachments (unless we have extensions) */
+    createDepthStencilTexture(format) {
+        // return new WEBGLRenderbuffer(this.device, {
+        return new WEBGLTexture(this.device, {
+            id: `${this.id}-depth-stencil`,
+            format,
+            width: this.width,
+            height: this.height,
+            mipmaps: false
+        });
     }
-    if (this.depthStencilAttachment) {
-      this.depthStencilAttachment.resize({
-        width,
-        height
-      });
+    /**
+     * Attachment resize is expected to be a noop if size is same
+     */
+    resizeAttachments(width, height) {
+        // for default framebuffer, just update the stored size
+        if (this.handle === null) {
+            // assert(width === undefined && height === undefined);
+            this.width = this.gl.drawingBufferWidth;
+            this.height = this.gl.drawingBufferHeight;
+            return this;
+        }
+        if (width === undefined) {
+            width = this.gl.drawingBufferWidth;
+        }
+        if (height === undefined) {
+            height = this.gl.drawingBufferHeight;
+        }
+        // TODO Not clear that this is better than default destroy/create implementation
+        for (const colorAttachment of this.colorAttachments) {
+            colorAttachment.texture.resize({ width, height });
+        }
+        if (this.depthStencilAttachment) {
+            this.depthStencilAttachment.texture.resize({ width, height });
+        }
+        return this;
     }
-    return this;
-  }
-  _attachOne(attachmentPoint, attachment) {
-    if (attachment instanceof WEBGLRenderbuffer) {
-      this._attachWEBGLRenderbuffer(attachmentPoint, attachment);
-      return attachment;
-    } else if (Array.isArray(attachment)) {
-      const [texture, layer = 0, level = 0] = attachment;
-      this._attachTexture(attachmentPoint, texture, layer, level);
-      return texture;
-    } else if (attachment instanceof WEBGLTexture) {
-      this._attachTexture(attachmentPoint, attachment, 0, 0);
-      return attachment;
+    /** Attach one attachment */
+    _attachOne(attachmentPoint, attachment) {
+        // if (attachment instanceof WEBGLRenderbuffer) {
+        //   this._attachWEBGLRenderbuffer(attachmentPoint, attachment);
+        //   return attachment;
+        // }
+        if (Array.isArray(attachment)) {
+            const [texture, layer = 0, level = 0] = attachment;
+            this._attachTexture(attachmentPoint, texture, layer, level);
+            return texture;
+        }
+        if (attachment instanceof WEBGLTexture) {
+            this._attachTexture(attachmentPoint, attachment, 0, 0);
+            return attachment;
+        }
+        if (attachment instanceof WEBGLTextureView) {
+            const textureView = attachment;
+            this._attachTexture(attachmentPoint, textureView.texture, textureView.props.baseMipLevel, textureView.props.baseArrayLayer);
+            return attachment.texture;
+        }
+        throw new Error('attach');
     }
-    throw new Error('attach');
-  }
-  _attachWEBGLRenderbuffer(attachment, renderbuffer) {
-    this.gl.framebufferRenderbuffer(36160, attachment, 36161, renderbuffer.handle);
-  }
-  _attachTexture(attachment, texture, layer, level) {
-    const {
-      gl,
-      gl2
-    } = this.device;
-    gl.bindTexture(texture.target, texture.handle);
-    switch (texture.target) {
-      case 35866:
-      case 32879:
-        this.device.assertWebGL2();
-        gl2 === null || gl2 === void 0 ? void 0 : gl2.framebufferTextureLayer(36160, attachment, texture.target, level, layer);
-        break;
-      case 34067:
-        const face = mapIndexToCubeMapFace(layer);
-        gl.framebufferTexture2D(36160, attachment, face, texture.handle, level);
-        break;
-      case 3553:
-        gl.framebufferTexture2D(36160, attachment, 3553, texture.handle, level);
-        break;
-      default:
-        assert(false, 'Illegal texture type');
+    // TODO - we do not seem to need render buffers in WebGL 2
+    // protected _attachWEBGLRenderbuffer(attachment: GL, renderbuffer: WEBGLRenderbuffer): void {
+    //   this.gl.framebufferRenderbuffer(
+    //     GL.FRAMEBUFFER,
+    //     attachment,
+    //     GL.RENDERBUFFER,
+    //     renderbuffer.handle
+    //   );
+    // }
+    /**
+     * @param attachment
+     * @param texture
+     * @param layer = 0 - index into WEBGLTextureArray and Texture3D or face for `TextureCubeMap`
+     * @param level = 0 - mipmapLevel
+     */
+    _attachTexture(attachment, texture, layer, level) {
+        const { gl } = this.device;
+        gl.bindTexture(texture.target, texture.handle);
+        switch (texture.target) {
+            case 35866:
+            case 32879:
+                gl.framebufferTextureLayer(36160, attachment, texture.target, level, layer);
+                break;
+            case 34067:
+                // layer must be a cubemap face (or if index, converted to cube map face)
+                const face = mapIndexToCubeMapFace(layer);
+                gl.framebufferTexture2D(36160, attachment, face, texture.handle, level);
+                break;
+            case 3553:
+                gl.framebufferTexture2D(36160, attachment, 3553, texture.handle, level);
+                break;
+            default:
+                assert(false, 'Illegal texture type');
+        }
+        gl.bindTexture(texture.target, null);
     }
-    gl.bindTexture(texture.target, null);
-  }
 }
+// Helper functions
+// Map an index to a cube map face constant
 function mapIndexToCubeMapFace(layer) {
-  return layer < 34069 ? layer + 34069 : layer;
+    // TEXTURE_CUBE_MAP_POSITIVE_X is a big value (0x8515)
+    // if smaller assume layer is index, otherwise assume it is already a cube map face constant
+    return layer < 34069
+        ? layer + 34069
+        : layer;
 }
+// Helper METHODS
+// Get a string describing the framebuffer error if installed
 function _getFrameBufferStatus(status) {
-  switch (status) {
-    case 36053:
-      return 'success';
-    case 36054:
-      return 'Mismatched attachments';
-    case 36055:
-      return 'No attachments';
-    case 36057:
-      return 'Height/width mismatch';
-    case 36061:
-      return 'Unsupported or split attachments';
-    case 36182:
-      return 'Samples mismatch';
-    default:
-      return `${status}`;
-  }
+    switch (status) {
+        case 36053:
+            return 'success';
+        case 36054:
+            return 'Mismatched attachments';
+        case 36055:
+            return 'No attachments';
+        case 36057:
+            return 'Height/width mismatch';
+        case 36061:
+            return 'Unsupported or split attachments';
+        // WebGL2
+        case 36182:
+            return 'Samples mismatch';
+        // OVR_multiview2 extension
+        // case GL.FRAMEBUFFER_INCOMPLETE_VIEW_TARGETS_OVR: return 'baseViewIndex mismatch';
+        default:
+            return `${status}`;
+    }
 }
-//# sourceMappingURL=webgl-framebuffer.js.map

package/dist/adapter/resources/webgl-query-set.d.ts

@@ -0,0 +1,44 @@
+import { QuerySet, QuerySetProps } from '@luma.gl/core';
+import { WebGLDevice } from "../webgl-device.js";
+/**
+ * Asynchronous queries for different kinds of information
+ */
+export declare class WEBGLQuerySet extends QuerySet {
+    device: WebGLDevice;
+    handle: WebGLQuery;
+    target: number | null;
+    _queryPending: boolean;
+    _pollingPromise: Promise<any> | null;
+    get [Symbol.toStringTag](): string;
+    constructor(device: WebGLDevice, props: QuerySetProps);
+    destroy(): void;
+    /**
+     * Shortcut for timer query (dependent on extension in both WebGL1 and 2)
+     * Measures GPU time delta between this call and a matching `end` call in the
+     * GPU instruction stream.
+     */
+    beginTimestampQuery(): void;
+    endTimestampQuery(): void;
+    beginOcclusionQuery(options?: {
+        conservative?: boolean;
+    }): void;
+    endOcclusionQuery(): void;
+    beginTransformFeedbackQuery(): void;
+    endTransformFeedbackQuery(): void;
+    resolveQuery(): Promise<bigint[]>;
+    /**
+     * Due to OpenGL API limitations, after calling `begin()` on one Query
+     * instance, `end()` must be called on that same instance before
+     * calling `begin()` on another query. While there can be multiple
+     * outstanding queries representing disjoint `begin()`/`end()` intervals.
+     * It is not possible to interleave or overlap `begin` and `end` calls.
+     */
+    protected _begin(target: number): void;
+    protected _end(): void;
+    isResultAvailable(): boolean;
+    isTimerDisjoint(): boolean;
+    getResult(): any;
+    getTimerMilliseconds(): number;
+    pollQuery(limit?: number): Promise<any>;
+}
+//# sourceMappingURL=webgl-query-set.d.ts.map

package/dist/adapter/resources/webgl-query-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-query-set.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-query-set.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAC,WAAW,EAAC,2BAAwB;AAE5C;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IAEnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,aAAa,UAAS;IACtB,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAQ;IAE5C,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;gBAGW,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa;IAY5C,OAAO;IAMhB;;;;OAIG;IACH,mBAAmB,IAAI,IAAI;IAI3B,iBAAiB,IAAI,IAAI;IAKzB,mBAAmB,CAAC,OAAO,CAAC,EAAE;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,IAAI;IAM7D,iBAAiB;IAKjB,2BAA2B,IAAI,IAAI;IAInC,yBAAyB,IAAI,IAAI;IAI3B,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOvC;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAatC,SAAS,CAAC,IAAI,IAAI,IAAI;IAetB,iBAAiB,IAAI,OAAO;IAgB5B,eAAe,IAAI,OAAO;IAK1B,SAAS,IAAI,GAAG;IAKhB,oBAAoB;IAKpB,SAAS,CAAC,KAAK,GAAE,MAAiC,GAAG,OAAO,CAAC,GAAG,CAAC;CAyBlE"}

package/dist/adapter/resources/webgl-query-set.js

@@ -0,0 +1,136 @@
+// WebGL2 Query (also handles disjoint timer extensions)
+import { QuerySet } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
+/**
+ * Asynchronous queries for different kinds of information
+ */
+export class WEBGLQuerySet extends QuerySet {
+    device;
+    handle;
+    target = null;
+    _queryPending = false;
+    _pollingPromise = null;
+    get [Symbol.toStringTag]() {
+        return 'Query';
+    }
+    // Create a query class
+    constructor(device, props) {
+        super(device, props);
+        this.device = device;
+        if (props.count > 1) {
+            throw new Error('WebGL QuerySet can only have one value');
+        }
+        this.handle = this.device.gl.createQuery();
+        Object.seal(this);
+    }
+    destroy() {
+        this.device.gl.deleteQuery(this.handle);
+    }
+    // FOR RENDER PASS AND COMMAND ENCODER
+    /**
+     * Shortcut for timer query (dependent on extension in both WebGL1 and 2)
+     * Measures GPU time delta between this call and a matching `end` call in the
+     * GPU instruction stream.
+     */
+    beginTimestampQuery() {
+        return this._begin(35007);
+    }
+    endTimestampQuery() {
+        this._end();
+    }
+    // Shortcut for occlusion queries
+    beginOcclusionQuery(options) {
+        return this._begin(options?.conservative ? 36202 : 35887);
+    }
+    endOcclusionQuery() {
+        this._end();
+    }
+    // Shortcut for transformFeedbackQuery
+    beginTransformFeedbackQuery() {
+        return this._begin(35976);
+    }
+    endTransformFeedbackQuery() {
+        this._end();
+    }
+    async resolveQuery() {
+        const value = await this.pollQuery();
+        return [value];
+    }
+    // PRIVATE METHODS
+    /**
+     * Due to OpenGL API limitations, after calling `begin()` on one Query
+     * instance, `end()` must be called on that same instance before
+     * calling `begin()` on another query. While there can be multiple
+     * outstanding queries representing disjoint `begin()`/`end()` intervals.
+     * It is not possible to interleave or overlap `begin` and `end` calls.
+     */
+    _begin(target) {
+        // Don't start a new query if one is already active.
+        if (this._queryPending) {
+            return;
+        }
+        this.target = target;
+        this.device.gl.beginQuery(this.target, this.handle);
+        return;
+    }
+    // ends the current query
+    _end() {
+        // Can't end a new query if the last one hasn't been resolved.
+        if (this._queryPending) {
+            return;
+        }
+        if (this.target) {
+            this.device.gl.endQuery(this.target);
+            this.target = null;
+            this._queryPending = true;
+        }
+        return;
+    }
+    // Returns true if the query result is available
+    isResultAvailable() {
+        if (!this._queryPending) {
+            return false;
+        }
+        const resultAvailable = this.device.gl.getQueryParameter(this.handle, 34919);
+        if (resultAvailable) {
+            this._queryPending = false;
+        }
+        return resultAvailable;
+    }
+    // Timing query is disjoint, i.e. results are invalid
+    isTimerDisjoint() {
+        return this.device.gl.getParameter(36795);
+    }
+    // Returns query result.
+    getResult() {
+        return this.device.gl.getQueryParameter(this.handle, 34918);
+    }
+    // Returns the query result, converted to milliseconds to match JavaScript conventions.
+    getTimerMilliseconds() {
+        return this.getResult() / 1e6;
+    }
+    // Polls the query
+    pollQuery(limit = Number.POSITIVE_INFINITY) {
+        if (this._pollingPromise) {
+            return this._pollingPromise;
+        }
+        let counter = 0;
+        this._pollingPromise = new Promise((resolve, reject) => {
+            const poll = () => {
+                if (this.isResultAvailable()) {
+                    resolve(this.getResult());
+                    this._pollingPromise = null;
+                }
+                else if (counter++ > limit) {
+                    reject('Timed out');
+                    this._pollingPromise = null;
+                }
+                else {
+                    requestAnimationFrame(poll);
+                }
+            };
+            requestAnimationFrame(poll);
+        });
+        return this._pollingPromise;
+    }
+}

package/dist/adapter/resources/webgl-render-pass.d.ts

@@ -1,5 +1,5 @@
 import { RenderPass, RenderPassProps, NumberArray, RenderPassParameters } from '@luma.gl/core';
-import { WebGLDevice } from '../webgl-device';
+import { WebGLDevice } from "../webgl-device.js";
 import { GLParameters } from '@luma.gl/constants';
 export declare class WEBGLRenderPass extends RenderPass {
     readonly device: WebGLDevice;
@@ -14,6 +14,8 @@ export declare class WEBGLRenderPass extends RenderPass {
      * Maps RenderPass parameters to GL parameters
      */
     setParameters(parameters?: RenderPassParameters): void;
+    beginOcclusionQuery(queryIndex: number): void;
+    endOcclusionQuery(): void;
     /**
      * Optionally clears depth, color and stencil buffers based on parameters
      */

package/dist/adapter/resources/webgl-render-pass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-render-pass.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-render-pass.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAK,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAYpD,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,8DAA8D;IAC9D,YAAY,EAAE,YAAY,CAAC;gBAEf,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe;IAYvD,GAAG,IAAI,IAAI;IAQX,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IACxC,aAAa,IAAI,IAAI;IACrB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAS5C;;OAEG;IACH,aAAa,CAAC,UAAU,GAAE,oBAAyB,GAAG,IAAI;IAiD1D;;OAEG;IACH,SAAS,CAAC,KAAK,IAAI,IAAI;IA+BvB;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,GAAE,MAAU,EAAE,KAAK,GAAE,WAA0B;CAwCrF"}
+{"version":3,"file":"webgl-render-pass.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-render-pass.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAC,WAAW,EAAC,2BAAwB;AAC5C,OAAO,EAAK,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAapD,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,8DAA8D;IAC9D,YAAY,EAAE,YAAY,CAAC;gBAEf,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe;IAYvD,GAAG,IAAI,IAAI;IAQX,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IACxC,aAAa,IAAI,IAAI;IACrB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACH,aAAa,CAAC,UAAU,GAAE,oBAAyB,GAAG,IAAI;IA+C1D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKpC,iBAAiB,IAAI,IAAI;IAOlC;;OAEG;IACH,SAAS,CAAC,KAAK,IAAI,IAAI;IA+BvB;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,GAAE,MAAU,EAAE,KAAK,GAAE,WAA0B;CAwCrF"}