@luma.gl/webgl 9.0.0-beta.3 → 9.0.0-beta.5

package/dist/adapter/resources/webgl-vertex-array.js

@@ -1,167 +1,238 @@
-let _Symbol$toStringTag;
+// luma.gl, MIT license
+// Copyright (c) vis.gl contributors
 import { VertexArray, getScratchArray, fillArray } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
 import { getBrowser } from '@probe.gl/env';
-import { getGLFromVertexType } from "../converters/vertex-formats.js";
-_Symbol$toStringTag = Symbol.toStringTag;
+import { getGLFromVertexType } from '../converters/vertex-formats';
+// import {AccessorObject} from '../..';
+// import {getGLFromVertexType} from '../converters/vertex-formats';
+/** VertexArrayObject wrapper */
 export class WEBGLVertexArray extends VertexArray {
-  get [_Symbol$toStringTag]() {
-    return 'VertexArray';
-  }
-  static isConstantAttributeZeroSupported(device) {
-    return device.info.type === 'webgl2' || getBrowser() === 'Chrome';
-  }
-  constructor(device, props) {
-    super(device, props);
-    this.device = void 0;
-    this.handle = void 0;
-    this.buffer = null;
-    this.bufferValue = null;
-    this.init = false;
-    this.device = device;
-    this.handle = this.device.gl2.createVertexArray();
-  }
-  destroy() {
-    super.destroy();
-    if (this.buffer) {
-      var _this$buffer;
-      (_this$buffer = this.buffer) === null || _this$buffer === void 0 ? void 0 : _this$buffer.destroy();
-    }
-    if (this.handle) {
-      this.device.gl2.deleteVertexArray(this.handle);
-      this.handle = undefined;
-    }
-  }
-  setIndexBuffer(indexBuffer) {
-    const buffer = indexBuffer;
-    if (buffer && buffer.glTarget !== 34963) {
-      throw new Error('Use .setBuffer()');
-    }
-    this.device.gl2.bindVertexArray(this.handle);
-    this.device.gl2.bindBuffer(34963, buffer ? buffer.handle : null);
-    this.indexBuffer = buffer;
-  }
-  setBuffer(location, attributeBuffer) {
-    const buffer = attributeBuffer;
-    if (buffer.glTarget === 34963) {
-      throw new Error('Use .setIndexBuffer()');
-    }
-    const {
-      size,
-      type,
-      stride,
-      offset,
-      normalized,
-      integer,
-      divisor
-    } = this._getAccessor(location);
-    this.device.gl2.bindVertexArray(this.handle);
-    this.device.gl.bindBuffer(34962, buffer.handle);
-    if (integer) {
-      this.device.assertWebGL2();
-      this.device.gl2.vertexAttribIPointer(location, size, type, stride, offset);
-    } else {
-      this.device.gl.vertexAttribPointer(location, size, type, normalized, stride, offset);
-    }
-    this.device.gl.enableVertexAttribArray(location);
-    this.device.gl2.vertexAttribDivisor(location, divisor || 0);
-    this.attributes[location] = buffer;
-  }
-  setConstant(location, value) {
-    this._enable(location, false);
-    this.attributes[location] = value;
-  }
-  bindBeforeRender() {
-    this.device.gl2.bindVertexArray(this.handle);
-    if (!this.init) {
-      const webglBuffer = this.indexBuffer;
-      this.device.gl2.bindBuffer(34963, (webglBuffer === null || webglBuffer === void 0 ? void 0 : webglBuffer.handle) || null);
-      this.init = true;
-    }
-    this._applyConstantAttributes();
-  }
-  unbindAfterRender() {
-    this.device.gl2.bindVertexArray(null);
-  }
-  _applyConstantAttributes() {
-    for (let location = 0; location < this.maxVertexAttributes; ++location) {
-      const constant = this.attributes[location];
-      if (ArrayBuffer.isView(constant)) {
-        this.device.setConstantAttribute(location, constant);
-      }
-    }
-  }
-  _getAccessor(location) {
-    const attributeInfo = this.attributeInfos[location];
-    if (!attributeInfo) {
-      throw new Error(`Unknown attribute location ${location}`);
-    }
-    const glType = getGLFromVertexType(attributeInfo.bufferDataType);
-    return {
-      size: attributeInfo.bufferComponents,
-      type: glType,
-      stride: attributeInfo.byteStride,
-      offset: attributeInfo.byteOffset,
-      normalized: attributeInfo.normalized,
-      integer: attributeInfo.integer,
-      divisor: attributeInfo.stepMode === 'instance' ? 1 : 0
-    };
-  }
-  _enable(location) {
-    let enable = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-    const canDisableAttributeZero = WEBGLVertexArray.isConstantAttributeZeroSupported(this.device);
-    const canDisableAttribute = canDisableAttributeZero || location !== 0;
-    if (enable || canDisableAttribute) {
-      location = Number(location);
-      this.device.gl2.bindVertexArray(this.handle);
-      if (enable) {
+    get [Symbol.toStringTag]() {
+        return 'VertexArray';
+    }
+    device;
+    handle;
+    /** Attribute 0 buffer constant */
+    buffer = null;
+    bufferValue = null;
+    /** * Attribute 0 can not be disable on most desktop OpenGL based browsers */
+    static isConstantAttributeZeroSupported(device) {
+        return getBrowser() === 'Chrome';
+    }
+    // Create a VertexArray
+    constructor(device, props) {
+        super(device, props);
+        this.device = device;
+        this.handle = this.device.gl.createVertexArray();
+    }
+    destroy() {
+        super.destroy();
+        if (this.buffer) {
+            this.buffer?.destroy();
+        }
+        if (this.handle) {
+            this.device.gl.deleteVertexArray(this.handle);
+            // @ts-expect-error read-only/undefined
+            this.handle = undefined;
+        }
+        // Auto-delete elements?
+        // return [this.elements];
+    }
+    /**
+    // Set (bind/unbind) an elements buffer, for indexed rendering.
+    // Must be a Buffer bound to GL.ELEMENT_ARRAY_BUFFER or null. Constants not supported
+     *
+     * @param elementBuffer
+     */
+    setIndexBuffer(indexBuffer) {
+        const buffer = indexBuffer;
+        // Explicitly allow `null` to support clearing the index buffer
+        if (buffer && buffer.glTarget !== GL.ELEMENT_ARRAY_BUFFER) {
+            throw new Error('Use .setBuffer()');
+        }
+        // In WebGL The GL.ELEMENT_ARRAY_BUFFER_BINDING is stored on the VertexArrayObject
+        this.device.gl.bindVertexArray(this.handle);
+        // TODO - this initial binding does not seem to take effect? see bindBeforeRender()
+        this.device.gl.bindBuffer(GL.ELEMENT_ARRAY_BUFFER, buffer ? buffer.handle : null);
+        // log.log(1, 'VertexArray.setIndexBuffer', indexBuffer)();
+        // log.log(1, `Binding vertex array ${this.id}`, buffer?.id)();
+        this.indexBuffer = buffer;
+    }
+    /** Set a location in vertex attributes array to a buffer, enables the location, sets divisor */
+    setBuffer(location, attributeBuffer) {
+        const buffer = attributeBuffer;
+        // Sanity check target
+        if (buffer.glTarget === GL.ELEMENT_ARRAY_BUFFER) {
+            throw new Error('Use .setIndexBuffer()');
+        }
+        const { size, type, stride, offset, normalized, integer, divisor } = this._getAccessor(location);
+        this.device.gl.bindVertexArray(this.handle);
+        // A non-zero buffer object must be bound to the GL_ARRAY_BUFFER target
+        this.device.gl.bindBuffer(GL.ARRAY_BUFFER, buffer.handle);
+        // WebGL2 supports *integer* data formats, i.e. GPU will see integer values
+        if (integer) {
+            this.device.gl.vertexAttribIPointer(location, size, type, stride, offset);
+        }
+        else {
+            // Attaches ARRAY_BUFFER with specified buffer format to location
+            this.device.gl.vertexAttribPointer(location, size, type, normalized, stride, offset);
+        }
+        // Mark as non-constant
         this.device.gl.enableVertexAttribArray(location);
-      } else {
-        this.device.gl.disableVertexAttribArray(location);
-      }
-      this.device.gl2.bindVertexArray(null);
-    }
-  }
-  getConstantBuffer(elementCount, value) {
-    const constantValue = normalizeConstantArrayValue(value);
-    const byteLength = constantValue.byteLength * elementCount;
-    const length = constantValue.length * elementCount;
-    if (this.buffer && byteLength !== this.buffer.byteLength) {
-      throw new Error(`Buffer size is immutable, byte length ${byteLength} !== ${this.buffer.byteLength}.`);
-    }
-    let updateNeeded = !this.buffer;
-    this.buffer = this.buffer || this.device.createBuffer({
-      byteLength
-    });
-    updateNeeded = updateNeeded || !compareConstantArrayValues(constantValue, this.bufferValue);
-    if (updateNeeded) {
-      const typedArray = getScratchArray(value.constructor, length);
-      fillArray({
-        target: typedArray,
-        source: constantValue,
-        start: 0,
-        count: length
-      });
-      this.buffer.write(typedArray);
-      this.bufferValue = value;
-    }
-    return this.buffer;
-  }
+        // Set the step mode 0=vertex, 1=instance
+        this.device.gl.vertexAttribDivisor(location, divisor || 0);
+        this.attributes[location] = buffer;
+    }
+    /** Set a location in vertex attributes array to a constant value, disables the location */
+    setConstant(location, value) {
+        this._enable(location, false);
+        this.attributes[location] = value;
+    }
+    init = false;
+    bindBeforeRender() {
+        this.device.gl.bindVertexArray(this.handle);
+        // TODO - the initial bind does not seem to take effect.
+        if (!this.init) {
+            // log.log(1, `Binding vertex array ${this.id}`, this.indexBuffer?.id)();
+            const webglBuffer = this.indexBuffer;
+            this.device.gl.bindBuffer(GL.ELEMENT_ARRAY_BUFFER, webglBuffer?.handle || null);
+            this.init = true;
+        }
+        this._applyConstantAttributes();
+    }
+    unbindAfterRender() {
+        // log.log(1, `Unbinding vertex array ${this.id}`)();
+        // TODO technically this is not necessary, but we might be interfacing
+        // with code that does not use vertex array objects
+        this.device.gl.bindVertexArray(null);
+        // this.device.gl.bindBuffer(GL.ELEMENT_ARRAY_BUFFER, null);
+    }
+    // Internal methods
+    /**
+     * Constant attributes need to be reset before every draw call
+     * Any attribute that is disabled in the current vertex array object
+     * is read from the context's global constant value for that attribute location.
+     * @note Constant attributes are only supported in WebGL, not in WebGPU
+     */
+    _applyConstantAttributes() {
+        for (let location = 0; location < this.maxVertexAttributes; ++location) {
+            const constant = this.attributes[location];
+            // A typed array means this is a constant
+            if (ArrayBuffer.isView(constant)) {
+                this.device.setConstantAttribute(location, constant);
+            }
+        }
+    }
+    /**
+     * Set a location in vertex attributes array to a buffer, enables the location, sets divisor
+     * @note requires vertex array to be bound
+     */
+    // protected _setAttributeLayout(location: number): void {
+    //   const {size, type, stride, offset, normalized, integer, divisor} = this._getAccessor(location);
+    //   // WebGL2 supports *integer* data formats, i.e. GPU will see integer values
+    //   if (integer) {
+    //     this.device.gl.vertexAttribIPointer(location, size, type, stride, offset);
+    //   } else {
+    //     // Attaches ARRAY_BUFFER with specified buffer format to location
+    //     this.device.gl.vertexAttribPointer(location, size, type, normalized, stride, offset);
+    //   }
+    //   this.device.gl.vertexAttribDivisor(location, divisor || 0);
+    // }
+    /** Get an accessor from the  */
+    _getAccessor(location) {
+        const attributeInfo = this.attributeInfos[location];
+        if (!attributeInfo) {
+            throw new Error(`Unknown attribute location ${location}`);
+        }
+        const glType = getGLFromVertexType(attributeInfo.bufferDataType);
+        return {
+            size: attributeInfo.bufferComponents,
+            type: glType,
+            stride: attributeInfo.byteStride,
+            offset: attributeInfo.byteOffset,
+            normalized: attributeInfo.normalized,
+            // it is the shader attribute declaration, not the vertex memory format,
+            // that determines if the data in the buffer will be treated as integers.
+            //
+            // Also note that WebGL supports assigning non-normalized integer data to floating point attributes,
+            // but as far as we can tell, WebGPU does not.
+            integer: attributeInfo.integer,
+            divisor: attributeInfo.stepMode === 'instance' ? 1 : 0
+        };
+    }
+    /**
+     * Enabling an attribute location makes it reference the currently bound buffer
+     * Disabling an attribute location makes it reference the global constant value
+     * TODO - handle single values for size 1 attributes?
+     * TODO - convert classic arrays based on known type?
+     */
+    _enable(location, enable = true) {
+        // Attribute 0 cannot be disabled in most desktop OpenGL based browsers...
+        const canDisableAttributeZero = WEBGLVertexArray.isConstantAttributeZeroSupported(this.device);
+        const canDisableAttribute = canDisableAttributeZero || location !== 0;
+        if (enable || canDisableAttribute) {
+            location = Number(location);
+            this.device.gl.bindVertexArray(this.handle);
+            if (enable) {
+                this.device.gl.enableVertexAttribArray(location);
+            }
+            else {
+                this.device.gl.disableVertexAttribArray(location);
+            }
+            this.device.gl.bindVertexArray(null);
+        }
+    }
+    /**
+     * Provide a means to create a buffer that is equivalent to a constant.
+     * NOTE: Desktop OpenGL cannot disable attribute 0.
+     * https://stackoverflow.com/questions/20305231/webgl-warning-attribute-0-is-disabled-
+     * this-has-significant-performance-penalty
+     */
+    getConstantBuffer(elementCount, value) {
+        // Create buffer only when needed, and reuse it (avoids inflating buffer creation statistics)
+        const constantValue = normalizeConstantArrayValue(value);
+        const byteLength = constantValue.byteLength * elementCount;
+        const length = constantValue.length * elementCount;
+        if (this.buffer && byteLength !== this.buffer.byteLength) {
+            throw new Error(`Buffer size is immutable, byte length ${byteLength} !== ${this.buffer.byteLength}.`);
+        }
+        let updateNeeded = !this.buffer;
+        this.buffer = this.buffer || this.device.createBuffer({ byteLength });
+        // Reallocate and update contents if needed
+        updateNeeded = updateNeeded || !compareConstantArrayValues(constantValue, this.bufferValue);
+        if (updateNeeded) {
+            // Create a typed array that is big enough, and fill it with the required data
+            const typedArray = getScratchArray(value.constructor, length);
+            fillArray({ target: typedArray, source: constantValue, start: 0, count: length });
+            this.buffer.write(typedArray);
+            this.bufferValue = value;
+        }
+        return this.buffer;
+    }
 }
+// HELPER FUNCTIONS
+/**
+ * TODO - convert Arrays based on known type? (read type from accessor, don't assume Float32Array)
+ * TODO - handle single values for size 1 attributes?
+ */
 function normalizeConstantArrayValue(arrayValue) {
-  if (Array.isArray(arrayValue)) {
-    return new Float32Array(arrayValue);
-  }
-  return arrayValue;
+    if (Array.isArray(arrayValue)) {
+        return new Float32Array(arrayValue);
+    }
+    return arrayValue;
 }
+/**
+ *
+ */
 function compareConstantArrayValues(v1, v2) {
-  if (!v1 || !v2 || v1.length !== v2.length || v1.constructor !== v2.constructor) {
-    return false;
-  }
-  for (let i = 0; i < v1.length; ++i) {
-    if (v1[i] !== v2[i]) {
-      return false;
-    }
-  }
-  return true;
+    if (!v1 || !v2 || v1.length !== v2.length || v1.constructor !== v2.constructor) {
+        return false;
+    }
+    for (let i = 0; i < v1.length; ++i) {
+        if (v1[i] !== v2[i]) {
+            return false;
+        }
+    }
+    return true;
 }
-//# sourceMappingURL=webgl-vertex-array.js.map

package/dist/adapter/webgl-canvas-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-canvas-context.d.ts","sourceRoot":"","sources":["../../src/adapter/webgl-canvas-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACtD,OAAO,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,YAAY,CAAiC;gBAEzC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB;IAS1D,qBAAqB,IAAI,gBAAgB;IAOzC,sDAAsD;IACtD,MAAM;IASN;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAC,GAAG,IAAI;IAiB7F,MAAM;CAOP"}
+{"version":3,"file":"webgl-canvas-context.d.ts","sourceRoot":"","sources":["../../src/adapter/webgl-canvas-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACtD,OAAO,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,YAAY,CAAiC;gBAEzC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB;IAS1D,qBAAqB,IAAI,gBAAgB;IAOzC,sDAAsD;IACtD,MAAM;IASN;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAC,GAAG,IAAI;IAW7F,MAAM;CAOP"}

package/dist/adapter/webgl-canvas-context.js

@@ -1,43 +1,64 @@
+// luma.gl, MIT license
+// Copyright (c) vis.gl contributors
 import { CanvasContext } from '@luma.gl/core';
-import { WEBGLFramebuffer } from "./resources/webgl-framebuffer.js";
+import { WEBGLFramebuffer } from './resources/webgl-framebuffer';
+/**
+ * A WebGL Canvas Context which manages the canvas and handles drawing buffer resizing etc
+ */
 export class WebGLCanvasContext extends CanvasContext {
-  constructor(device, props) {
-    super(props);
-    this.device = void 0;
-    this.presentationSize = void 0;
-    this._framebuffer = null;
-    this.device = device;
-    this.presentationSize = [-1, -1];
-    this._setAutoCreatedCanvasId(`${this.device.id}-canvas`);
-    this.update();
-  }
-  getCurrentFramebuffer() {
-    this.update();
-    this._framebuffer = this._framebuffer || new WEBGLFramebuffer(this.device, {
-      handle: null
-    });
-    return this._framebuffer;
-  }
-  update() {
-    const size = this.getPixelSize();
-    const sizeChanged = size[0] !== this.presentationSize[0] || size[1] !== this.presentationSize[1];
-    if (sizeChanged) {
-      this.presentationSize = size;
-      this.resize();
+    device;
+    presentationSize;
+    _framebuffer = null;
+    constructor(device, props) {
+        // Note: Base class creates / looks up the canvas (unless under Node.js)
+        super(props);
+        this.device = device;
+        this.presentationSize = [-1, -1];
+        this._setAutoCreatedCanvasId(`${this.device.id}-canvas`);
+        this.update();
     }
-  }
-  resize(options) {
-    if (!this.device.gl) return;
-    if (this.canvas) {
-      const devicePixelRatio = this.getDevicePixelRatio(options === null || options === void 0 ? void 0 : options.useDevicePixels);
-      this.setDevicePixelRatio(devicePixelRatio, options);
-      return;
+    getCurrentFramebuffer() {
+        this.update();
+        // Setting handle to null returns a reference to the default framebuffer
+        this._framebuffer = this._framebuffer || new WEBGLFramebuffer(this.device, { handle: null });
+        return this._framebuffer;
     }
-    const ext = this.device.gl.getExtension('STACKGL_resize_drawingbuffer');
-    if (ext && options && 'width' in options && 'height' in options) {
-      ext.resize(options.width, options.height);
+    /** Resizes and updates render targets if necessary */
+    update() {
+        const size = this.getPixelSize();
+        const sizeChanged = size[0] !== this.presentationSize[0] || size[1] !== this.presentationSize[1];
+        if (sizeChanged) {
+            this.presentationSize = size;
+            this.resize();
+        }
+    }
+    /**
+     * Resize the canvas' drawing buffer.
+     *
+     * Can match the canvas CSS size, and optionally also consider devicePixelRatio
+     * Can be called every frame
+     *
+     * Regardless of size, the drawing buffer will always be scaled to the viewport, but
+     * for best visual results, usually set to either:
+     *  canvas CSS width x canvas CSS height
+     *  canvas CSS width * devicePixelRatio x canvas CSS height * devicePixelRatio
+     * See http://webgl2fundamentals.org/webgl/lessons/webgl-resizing-the-canvas.html
+     */
+    resize(options) {
+        if (!this.device.gl)
+            return;
+        // Resize browser context .
+        if (this.canvas) {
+            const devicePixelRatio = this.getDevicePixelRatio(options?.useDevicePixels);
+            this.setDevicePixelRatio(devicePixelRatio, options);
+            return;
+        }
+    }
+    commit() {
+        // gl.commit was ultimately removed from the WebGL standard??
+        // if (this.offScreen && this.gl.commit) {
+        //   // @ts-expect-error gl.commit is not officially part of WebGL2RenderingContext
+        //   this.gl.commit();
+        // }
     }
-  }
-  commit() {}
 }
-//# sourceMappingURL=webgl-canvas-context.js.map

package/dist/adapter/webgl-device.d.ts

@@ -1,6 +1,6 @@
 import type { DeviceProps, DeviceInfo, DeviceLimits, DeviceFeature, CanvasContextProps, TextureFormat, VertexArray, VertexArrayProps, Framebuffer, Buffer, Texture, TypedArray } from '@luma.gl/core';
 import { Device, CanvasContext } from '@luma.gl/core';
-import { WebGLLimits } from './device-helpers/device-limits';
+import { WebGLLimits } from './device-helpers/webgl-device-limits';
 import { WebGLCanvasContext } from './webgl-canvas-context';
 import type { BufferProps, ShaderProps, SamplerProps, TextureProps, ExternalTexture, ExternalTextureProps, FramebufferProps, RenderPipelineProps, ComputePipeline, ComputePipelineProps, RenderPassProps, ComputePass, ComputePassProps, CommandEncoderProps, TransformFeedbackProps } from '@luma.gl/core';
 import { WEBGLBuffer } from './resources/webgl-buffer';
@@ -18,7 +18,7 @@ export declare class WebGLDevice extends Device {
     static isSupported(): boolean;
     readonly info: DeviceInfo;
     readonly canvasContext: WebGLCanvasContext;
-    readonly handle: WebGLRenderingContext;
+    readonly handle: WebGL2RenderingContext;
     get features(): Set<DeviceFeature>;
     get limits(): DeviceLimits;
     readonly lost: Promise<{
@@ -34,7 +34,7 @@ export declare class WebGLDevice extends Device {
      * @param gl
      * @returns
      */
-    static attach(gl: Device | WebGLRenderingContext | WebGL2RenderingContext): WebGLDevice;
+    static attach(gl: Device | WebGL2RenderingContext): WebGLDevice;
     static create(props?: DeviceProps): Promise<WebGLDevice>;
     constructor(props: DeviceProps);
     /**
@@ -47,8 +47,6 @@ export declare class WebGLDevice extends Device {
     isTextureFormatSupported(format: TextureFormat): boolean;
     isTextureFormatFilterable(format: TextureFormat): boolean;
     isTextureFormatRenderable(format: TextureFormat): boolean;
-    /** Returns a WebGL2RenderingContext or throws an error */
-    assertWebGL2(): WebGL2RenderingContext;
     createCanvasContext(props?: CanvasContextProps): CanvasContext;
     createBuffer(props: BufferProps | ArrayBuffer | ArrayBufferView): WEBGLBuffer;
     _createTexture(props: TextureProps): WEBGLTexture;
@@ -67,7 +65,7 @@ export declare class WebGLDevice extends Device {
     createCommandEncoder(props?: CommandEncoderProps): WEBGLCommandEncoder;
     /**
      * Offscreen Canvas Support: Commit the frame
-     * https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/commit
+     * https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/commit
      * Chrome's offscreen canvas does not require gl.commit
      */
     submit(): void;
@@ -102,15 +100,9 @@ export declare class WebGLDevice extends Device {
         depth?: any;
         stencil?: any;
     }): void;
-    /** WebGL1 typed context. Can always be used. */
-    readonly gl: WebGLRenderingContext;
-    /** WebGL2 typed context. Need to check isWebGL2 or isWebGL1 before using. */
-    readonly gl2: WebGL2RenderingContext | null;
+    /** WebGL2 context. */
+    readonly gl: WebGL2RenderingContext;
     readonly debug: boolean;
-    /** `true` if this is a WebGL1 context. @note `false` if WebGL2 */
-    readonly isWebGL1: boolean;
-    /** `true` if this is a WebGL2 context. @note `false` if WebGL1 */
-    readonly isWebGL2: boolean;
     /** State used by luma.gl classes: TODO - move to canvasContext*/
     readonly _canvasSizeInfo: {
         clientWidth: number;
@@ -144,7 +136,7 @@ export declare class WebGLDevice extends Device {
      * Be aware that there are some duplicates especially for constants that are 0,
      * so this isn't guaranteed to return the right key in all cases.
      */
-    getGLKey(value: unknown, gl?: WebGLRenderingContext): string;
+    getGLKey(value: unknown, gl?: WebGL2RenderingContext): string;
     /** Store constants */
     _constants: (TypedArray | null)[];
     /**

package/dist/adapter/webgl-device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-device.d.ts","sourceRoot":"","sources":["../../src/adapter/webgl-device.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webgl-device.d.ts","sourceRoot":"","sources":["../../src/adapter/webgl-device.ts"],"names":[],"mappings":"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"}