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

package/dist/adapter/objects/webgl-resource.js

@@ -1,159 +1,114 @@
-import { Resource, assert, uid, stubRemovedMethods } from '@luma.gl/core';
-import { isWebGL2, assertWebGLContext } from "../../context/context/webgl-checks.js";
-import { WebGLDevice } from "../webgl-device.js";
-import { getKeyValue } from "./constants-to-keys.js";
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { Resource, uid, stubRemovedMethods } from '@luma.gl/core';
 const ERR_RESOURCE_METHOD_UNDEFINED = 'Resource subclass must define virtual methods';
+/**
+ * Base class for WebGL object wrappers
+ */
 export class WebGLResource extends Resource {
-  constructor(device, props, defaultProps) {
-    super(device, props, defaultProps);
-    this.device = void 0;
-    this.gl = void 0;
-    this.gl2 = void 0;
-    this._handle = void 0;
-    this._bound = false;
-    this.byteLength = 0;
-    this.device = WebGLDevice.attach(device);
-    const gl = this.device.gl;
-    assertWebGLContext(gl);
-    const {
-      id
-    } = props || {};
-    this.gl = gl;
-    this.gl2 = gl;
-    this.id = id || uid(this.constructor.name);
-    this._handle = props === null || props === void 0 ? void 0 : props.handle;
-    if (this._handle === undefined) {
-      this._handle = this._createHandle();
+    device;
+    gl;
+    gl2;
+    _handle;
+    _bound = false;
+    // Only meaningful for resources that allocate GPU memory
+    byteLength = 0;
+    constructor(device, props, defaultProps) {
+        super(device, props, defaultProps);
+        this.device = device;
+        const gl = this.device.gl;
+        // extends
+        const { id } = props || {};
+        this.gl = gl;
+        this.gl2 = gl;
+        this.id = id || uid(this.constructor.name);
+        // Set the handle
+        // If handle was provided, use it, otherwise create a new handle
+        // TODO - Stores the handle with context loss information
+        // this.glCount = glGetContextLossCount(this.gl);
+        // Default VertexArray needs to be created with null handle, so compare against undefined
+        this._handle = props?.handle;
+        if (this._handle === undefined) {
+            this._handle = this._createHandle();
+        }
+        this.byteLength = 0;
     }
-    this.byteLength = 0;
-  }
-  toString() {
-    return `${this.constructor.name}(${this.id})`;
-  }
-  get handle() {
-    return this._handle;
-  }
-  delete() {
-    let {
-      deleteChildren = false
-    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-    const children = this._handle && this._deleteHandle(this._handle);
-    if (this._handle) {
-      this.removeStats();
+    toString() {
+        return `${this.constructor.name}(${this.id})`;
     }
-    this._handle = null;
-    if (children && deleteChildren) {
-      children.filter(Boolean).forEach(child => child.destroy());
+    get handle() {
+        // TODO - Add context loss handling
+        // Will regenerate and reinitialize the handle if necessary
+        // const glCount = glGetContextLossCount(this.gl);
+        // if (this.glCount !== glCount) {
+        //   this._handle = this._createHandle(this.props);
+        //   this._glCount = glCount;
+        //   // Reinitialize object
+        //   this.initialize(this.props);
+        // }
+        return this._handle;
     }
-    return this;
-  }
-  bind() {
-    let funcOrHandle = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.handle;
-    if (typeof funcOrHandle !== 'function') {
-      this._bindHandle(funcOrHandle);
-      return this;
+    delete({ deleteChildren = false } = {}) {
+        // Delete this object, and get refs to any children
+        // @ts-expect-error
+        const children = this._handle && this._deleteHandle(this._handle);
+        if (this._handle) {
+            this.removeStats();
+        }
+        this._handle = null;
+        // Optionally, recursively delete the children
+        // @ts-expect-error
+        if (children && deleteChildren) {
+            // @ts-expect-error
+            children.filter(Boolean).forEach(child => child.destroy());
+        }
+        return this;
     }
-    let value;
-    if (!this._bound) {
-      this._bindHandle(this.handle);
-      this._bound = true;
-      value = funcOrHandle();
-      this._bound = false;
-      this._bindHandle(null);
-    } else {
-      value = funcOrHandle();
+    bind(funcOrHandle = this.handle) {
+        if (typeof funcOrHandle !== 'function') {
+            this._bindHandle(funcOrHandle);
+            return this;
+        }
+        let value;
+        if (!this._bound) {
+            this._bindHandle(this.handle);
+            this._bound = true;
+            value = funcOrHandle();
+            this._bound = false;
+            this._bindHandle(null);
+        }
+        else {
+            value = funcOrHandle();
+        }
+        return value;
     }
-    return value;
-  }
-  unbind() {
-    this.bind(null);
-  }
-  getParameter(pname) {
-    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-    pname = getKeyValue(this.gl, pname);
-    assert(pname);
-    const parameters = this.constructor.PARAMETERS || {};
-    const parameter = parameters[pname];
-    if (parameter) {
-      const isWebgl2 = isWebGL2(this.gl);
-      const parameterAvailable = (!('webgl2' in parameter) || isWebgl2) && (!('extension' in parameter) || this.gl.getExtension(parameter.extension));
-      if (!parameterAvailable) {
-        const webgl1Default = parameter.webgl1;
-        const webgl2Default = 'webgl2' in parameter ? parameter.webgl2 : parameter.webgl1;
-        const defaultValue = isWebgl2 ? webgl2Default : webgl1Default;
-        return defaultValue;
-      }
+    unbind() {
+        this.bind(null);
     }
-    return this._getParameter(pname, props);
-  }
-  getParameters() {
-    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-    const {
-      parameters,
-      keys
-    } = options;
-    const PARAMETERS = this.constructor.PARAMETERS || {};
-    const isWebgl2 = isWebGL2(this.gl);
-    const values = {};
-    const parameterKeys = parameters || Object.keys(PARAMETERS);
-    for (const pname of parameterKeys) {
-      const parameter = PARAMETERS[pname];
-      const parameterAvailable = parameter && (!('webgl2' in parameter) || isWebgl2) && (!('extension' in parameter) || this.gl.getExtension(parameter.extension));
-      if (parameterAvailable) {
-        const key = keys ? this.device.getGLKey(pname) : pname;
-        values[key] = this.getParameter(pname, options);
-        if (keys && parameter.type === 'GLenum') {
-          values[key] = this.device.getGLKey(values[key]);
-        }
-      }
+    // Install stubs for removed methods
+    stubRemovedMethods(className, version, methodNames) {
+        return stubRemovedMethods(this, className, version, methodNames);
+    }
+    // PUBLIC VIRTUAL METHODS
+    initialize(props) { }
+    // PROTECTED METHODS - These must be overridden by subclass
+    _createHandle() {
+        throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
+    }
+    _deleteHandle() {
+        throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
+    }
+    _bindHandle(handle) {
+        throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
+    }
+    _getOptsFromHandle() {
+        throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
     }
-    return values;
-  }
-  setParameter(pname, value) {
-    pname = getKeyValue(this.gl, pname);
-    assert(pname);
-    const parameters = this.constructor.PARAMETERS || {};
-    const parameter = parameters[pname];
-    if (parameter) {
-      const isWebgl2 = isWebGL2(this.gl);
-      const parameterAvailable = (!('webgl2' in parameter) || isWebgl2) && (!('extension' in parameter) || this.gl.getExtension(parameter.extension));
-      if (!parameterAvailable) {
-        throw new Error('Parameter not available on this platform');
-      }
-      if (parameter.type === 'GLenum') {
-        value = getKeyValue(value);
-      }
+    _getParameter(pname, props) {
+        throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
     }
-    this._setParameter(pname, value);
-    return this;
-  }
-  setParameters(parameters) {
-    for (const pname in parameters) {
-      this.setParameter(pname, parameters[pname]);
+    _setParameter(pname, value) {
+        throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
     }
-    return this;
-  }
-  stubRemovedMethods(className, version, methodNames) {
-    return stubRemovedMethods(this, className, version, methodNames);
-  }
-  initialize(props) {}
-  _createHandle() {
-    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
-  }
-  _deleteHandle() {
-    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
-  }
-  _bindHandle(handle) {
-    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
-  }
-  _getOptsFromHandle() {
-    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
-  }
-  _getParameter(pname, props) {
-    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
-  }
-  _setParameter(pname, value) {
-    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
-  }
 }
-//# sourceMappingURL=webgl-resource.js.map

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

@@ -1,12 +1,11 @@
 import type { BufferProps } from '@luma.gl/core';
 import { Buffer } from '@luma.gl/core';
 import { GL } from '@luma.gl/constants';
-import { WebGLDevice } from '../webgl-device';
+import { WebGLDevice } from "../webgl-device.js";
 /** WebGL Buffer interface */
 export declare class WEBGLBuffer extends Buffer {
     readonly device: WebGLDevice;
-    readonly gl: WebGLRenderingContext;
-    readonly gl2: WebGL2RenderingContext | null;
+    readonly gl: WebGL2RenderingContext;
     readonly handle: WebGLBuffer;
     /** Target in OpenGL defines the type of buffer */
     readonly glTarget: GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER;
@@ -27,6 +26,6 @@ export declare class WEBGLBuffer extends Buffer {
     /** Asynchronously read data from the buffer */
     readAsync(byteOffset?: number, byteLength?: number): Promise<Uint8Array>;
     /** Synchronously read data from the buffer. WebGL only. */
-    readSyncWebGL2(byteOffset?: number, byteLength?: number): Uint8Array;
+    readSyncWebGL(byteOffset?: number, byteLength?: number): Uint8Array;
 }
 //# sourceMappingURL=webgl-buffer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webgl-buffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-buffer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAC,MAAM,EAAS,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAE5C,6BAA6B;AAC7B,qBAAa,WAAY,SAAQ,MAAM;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,oBAAoB,GAAG,EAAE,CAAC,cAAc,CAAC;IACjF,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,YAAY,CAAqB;IAE9E,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;gBAEN,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,WAAgB;IA4BxD,sEAAsE;IACtE,aAAa,CACX,IAAI,EAAE,WAAW,GAAG,eAAe,EACnC,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAqC,GAChD,IAAI;IAgBP,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA2BpC,OAAO,IAAI,IAAI;IAWf,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI;IAoBnE,+CAA+C;IAChC,SAAS,CAAC,UAAU,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlF,2DAA2D;IAClD,cAAc,CAAC,UAAU,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU;CAiBzE"}
+{"version":3,"file":"webgl-buffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-buffer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAC,MAAM,EAAS,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,2BAAwB;AAE5C,6BAA6B;AAC7B,qBAAa,WAAY,SAAQ,MAAM;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,sBAAsB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,oBAAoB,GAAG,EAAE,CAAC,cAAc,CAAC;IACjF,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,YAAY,CAAqB;IAE9E,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;gBAEN,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,WAAgB;IA2BxD,sEAAsE;IACtE,aAAa,CACX,IAAI,EAAE,WAAW,GAAG,eAAe,EACnC,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAqC,GAChD,IAAI;IAgBP,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA2BpC,OAAO,IAAI,IAAI;IAWf,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI;IAmBnE,+CAA+C;IAChC,SAAS,CAAC,UAAU,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlF,2DAA2D;IAClD,aAAa,CAAC,UAAU,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU;CAexE"}

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

@@ -1,130 +1,172 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { Buffer, assert } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
+/** WebGL Buffer interface */
 export class WEBGLBuffer extends Buffer {
-  constructor(device) {
-    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-    super(device, props);
-    this.device = void 0;
-    this.gl = void 0;
-    this.gl2 = void 0;
-    this.handle = void 0;
-    this.glTarget = void 0;
-    this.glUsage = void 0;
-    this.glIndexType = 5123;
-    this.byteLength = void 0;
-    this.bytesUsed = void 0;
-    this.device = device;
-    this.gl = this.device.gl;
-    this.gl2 = this.device.gl2;
-    const handle = typeof props === 'object' ? props.handle : undefined;
-    this.handle = handle || this.gl.createBuffer();
-    device.setSpectorMetadata(this.handle, {
-      ...this.props,
-      data: typeof this.props.data
-    });
-    this.glTarget = getWebGLTarget(this.props.usage);
-    this.glUsage = getWebGLUsage(this.props.usage);
-    this.glIndexType = this.props.indexType === 'uint32' ? 5125 : 5123;
-    if (props.data) {
-      this._initWithData(props.data, props.byteOffset, props.byteLength);
-    } else {
-      this._initWithByteLength(props.byteLength || 0);
+    device;
+    gl;
+    handle;
+    /** Target in OpenGL defines the type of buffer */
+    glTarget;
+    /** Usage is a hint on how frequently the buffer will be updates */
+    glUsage;
+    /** Index type is needed when issuing draw calls, so we pre-compute it */
+    glIndexType = 5123;
+    /** Number of bytes allocated on the GPU for this buffer */
+    byteLength;
+    /** Number of bytes used */
+    bytesUsed;
+    constructor(device, props = {}) {
+        super(device, props);
+        this.device = device;
+        this.gl = this.device.gl;
+        const handle = typeof props === 'object' ? props.handle : undefined;
+        this.handle = handle || this.gl.createBuffer();
+        device.setSpectorMetadata(this.handle, { ...this.props, data: typeof this.props.data });
+        // - In WebGL1, need to make sure we use GL.ELEMENT_ARRAY_BUFFER when initializing element buffers
+        //   otherwise buffer type will lock to generic (non-element) buffer
+        // - In WebGL2, we can use GL.COPY_READ_BUFFER which avoids locking the type here
+        this.glTarget = getWebGLTarget(this.props.usage);
+        this.glUsage = getWebGLUsage(this.props.usage);
+        this.glIndexType = this.props.indexType === 'uint32' ? 5125 : 5123;
+        // Set data: (re)initializes the buffer
+        if (props.data) {
+            this._initWithData(props.data, props.byteOffset, props.byteLength);
+        }
+        else {
+            this._initWithByteLength(props.byteLength || 0);
+        }
     }
-  }
-  _initWithData(data) {
-    let byteOffset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    let byteLength = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : data.byteLength + byteOffset;
-    const glTarget = this.glTarget;
-    this.gl.bindBuffer(glTarget, this.handle);
-    this.gl.bufferData(glTarget, byteLength, this.glUsage);
-    this.gl.bufferSubData(glTarget, byteOffset, data);
-    this.gl.bindBuffer(glTarget, null);
-    this.bytesUsed = byteLength;
-    this.byteLength = byteLength;
-    this._setDebugData(data, byteOffset, byteLength);
-    this.trackAllocatedMemory(byteLength);
-  }
-  _initWithByteLength(byteLength) {
-    assert(byteLength >= 0);
-    let data = byteLength;
-    if (byteLength === 0) {
-      data = new Float32Array(0);
+    // PRIVATE METHODS
+    /** Allocate a new buffer and initialize to contents of typed array */
+    _initWithData(data, byteOffset = 0, byteLength = data.byteLength + byteOffset) {
+        // const glTarget = this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;
+        const glTarget = this.glTarget;
+        this.gl.bindBuffer(glTarget, this.handle);
+        this.gl.bufferData(glTarget, byteLength, this.glUsage);
+        this.gl.bufferSubData(glTarget, byteOffset, data);
+        this.gl.bindBuffer(glTarget, null);
+        this.bytesUsed = byteLength;
+        this.byteLength = byteLength;
+        this._setDebugData(data, byteOffset, byteLength);
+        this.trackAllocatedMemory(byteLength);
     }
-    const glTarget = this.glTarget;
-    this.gl.bindBuffer(glTarget, this.handle);
-    this.gl.bufferData(glTarget, data, this.glUsage);
-    this.gl.bindBuffer(glTarget, null);
-    this.bytesUsed = byteLength;
-    this.byteLength = byteLength;
-    this._setDebugData(null, 0, byteLength);
-    this.trackAllocatedMemory(byteLength);
-    return this;
-  }
-  destroy() {
-    if (!this.destroyed && this.handle) {
-      this.removeStats();
-      this.trackDeallocatedMemory();
-      this.gl.deleteBuffer(this.handle);
-      this.destroyed = true;
-      this.handle = null;
+    // Allocate a GPU buffer of specified size.
+    _initWithByteLength(byteLength) {
+        assert(byteLength >= 0);
+        // Workaround needed for Safari (#291):
+        // gl.bufferData with size equal to 0 crashes. Instead create zero sized array.
+        let data = byteLength;
+        if (byteLength === 0) {
+            // @ts-expect-error
+            data = new Float32Array(0);
+        }
+        // const glTarget = this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;
+        const glTarget = this.glTarget;
+        this.gl.bindBuffer(glTarget, this.handle);
+        this.gl.bufferData(glTarget, data, this.glUsage);
+        this.gl.bindBuffer(glTarget, null);
+        this.bytesUsed = byteLength;
+        this.byteLength = byteLength;
+        this._setDebugData(null, 0, byteLength);
+        this.trackAllocatedMemory(byteLength);
+        return this;
     }
-  }
-  write(data) {
-    let byteOffset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    const srcOffset = 0;
-    const byteLength = undefined;
-    const glTarget = this.device.isWebGL2 ? 36663 : this.glTarget;
-    this.gl.bindBuffer(glTarget, this.handle);
-    if (srcOffset !== 0 || byteLength !== undefined) {
-      this.device.assertWebGL2();
-      this.gl2.bufferSubData(glTarget, byteOffset, data, srcOffset, byteLength);
-    } else {
-      this.gl.bufferSubData(glTarget, byteOffset, data);
+    destroy() {
+        if (!this.destroyed && this.handle) {
+            this.removeStats();
+            this.trackDeallocatedMemory();
+            this.gl.deleteBuffer(this.handle);
+            this.destroyed = true;
+            // @ts-expect-error
+            this.handle = null;
+        }
+    }
+    write(data, byteOffset = 0) {
+        const srcOffset = 0;
+        const byteLength = undefined; // data.byteLength;
+        // Create the buffer - binding it here for the first time locks the type
+        // In WebGL2, use GL.COPY_WRITE_BUFFER to avoid locking the type
+        const glTarget = 36663;
+        this.gl.bindBuffer(glTarget, this.handle);
+        // WebGL2: subData supports additional srcOffset and length parameters
+        if (srcOffset !== 0 || byteLength !== undefined) {
+            this.gl.bufferSubData(glTarget, byteOffset, data, srcOffset, byteLength);
+        }
+        else {
+            this.gl.bufferSubData(glTarget, byteOffset, data);
+        }
+        this.gl.bindBuffer(glTarget, null);
+        this._setDebugData(data, byteOffset, data.byteLength);
+    }
+    /** Asynchronously read data from the buffer */
+    async readAsync(byteOffset = 0, byteLength) {
+        return this.readSyncWebGL(byteOffset, byteLength);
+    }
+    /** Synchronously read data from the buffer. WebGL only. */
+    readSyncWebGL(byteOffset = 0, byteLength) {
+        byteLength = byteLength ?? this.byteLength - byteOffset;
+        const data = new Uint8Array(byteLength);
+        const dstOffset = 0;
+        // Use GL.COPY_READ_BUFFER to avoid disturbing other targets and locking type
+        this.gl.bindBuffer(36662, this.handle);
+        this.gl.getBufferSubData(36662, byteOffset, data, dstOffset, byteLength);
+        this.gl.bindBuffer(36662, null);
+        // Update local `data` if offsets are 0
+        this._setDebugData(data, byteOffset, byteLength);
+        return data;
     }
-    this.gl.bindBuffer(glTarget, null);
-    this._setDebugData(data, byteOffset, data.byteLength);
-  }
-  async readAsync() {
-    let byteOffset = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
-    let byteLength = arguments.length > 1 ? arguments[1] : undefined;
-    return this.readSyncWebGL2(byteOffset, byteLength);
-  }
-  readSyncWebGL2() {
-    var _byteLength;
-    let byteOffset = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
-    let byteLength = arguments.length > 1 ? arguments[1] : undefined;
-    this.device.assertWebGL2();
-    byteLength = (_byteLength = byteLength) !== null && _byteLength !== void 0 ? _byteLength : this.byteLength - byteOffset;
-    const data = new Uint8Array(byteLength);
-    const dstOffset = 0;
-    this.gl.bindBuffer(36662, this.handle);
-    this.gl2.getBufferSubData(36662, byteOffset, data, dstOffset, byteLength);
-    this.gl.bindBuffer(36662, null);
-    this._setDebugData(data, byteOffset, byteLength);
-    return data;
-  }
 }
+/**
+ * Returns a WebGL buffer target
+ *
+ * @param usage
+ * static MAP_READ = 0x01;
+ * static MAP_WRITE = 0x02;
+ * static COPY_SRC = 0x0004;
+ * static COPY_DST = 0x0008;
+ * static INDEX = 0x0010;
+ * static VERTEX = 0x0020;
+ * static UNIFORM = 0x0040;
+ * static STORAGE = 0x0080;
+ * static INDIRECT = 0x0100;
+ * static QUERY_RESOLVE = 0x0200;
+ *
+ * @returns WebGL buffer targe
+ *
+ * Buffer bind points in WebGL2
+ * gl.COPY_READ_BUFFER: Buffer for copying from one buffer object to another.
+ * gl.COPY_WRITE_BUFFER: Buffer for copying from one buffer object to another.
+ * gl.TRANSFORM_FEEDBACK_BUFFER: Buffer for transform feedback operations.
+ * gl.PIXEL_PACK_BUFFER: Buffer used for pixel transfer operations.
+ * gl.PIXEL_UNPACK_BUFFER: Buffer used for pixel transfer operations.
+ */
 function getWebGLTarget(usage) {
-  if (usage & Buffer.INDEX) {
-    return 34963;
-  }
-  if (usage & Buffer.VERTEX) {
+    if (usage & Buffer.INDEX) {
+        return 34963;
+    }
+    if (usage & Buffer.VERTEX) {
+        return 34962;
+    }
+    if (usage & Buffer.UNIFORM) {
+        return 35345;
+    }
+    // Binding a buffer for the first time locks the type
+    // In WebGL2, we can use GL.COPY_WRITE_BUFFER to avoid locking the type
     return 34962;
-  }
-  if (usage & Buffer.UNIFORM) {
-    return 35345;
-  }
-  return 34962;
 }
+/** @todo usage is not passed correctly */
 function getWebGLUsage(usage) {
-  if (usage & Buffer.INDEX) {
-    return 35044;
-  }
-  if (usage & Buffer.VERTEX) {
+    if (usage & Buffer.INDEX) {
+        return 35044;
+    }
+    if (usage & Buffer.VERTEX) {
+        return 35044;
+    }
+    if (usage & Buffer.UNIFORM) {
+        return 35048;
+    }
     return 35044;
-  }
-  if (usage & Buffer.UNIFORM) {
-    return 35048;
-  }
-  return 35044;
 }
-//# sourceMappingURL=webgl-buffer.js.map

package/dist/adapter/resources/webgl-command-buffer.d.ts

@@ -1,7 +1,7 @@
 import type { CopyBufferToBufferOptions, CopyBufferToTextureOptions, CopyTextureToBufferOptions, CopyTextureToTextureOptions } from '@luma.gl/core';
 import { CommandBuffer } from '@luma.gl/core';
 import { GL } from '@luma.gl/constants';
-import { WebGLDevice } from '../webgl-device';
+import { WebGLDevice } from "../webgl-device.js";
 type CopyBufferToBufferCommand = {
     name: 'copy-buffer-to-buffer';
     options: CopyBufferToBufferOptions;

package/dist/adapter/resources/webgl-command-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-command-buffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-command-buffer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,aAAa,EAAuB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AAEtC,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAU5C,KAAK,yBAAyB,GAAG;IAC/B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,2BAA2B,CAAC;CACtC,CAAC;AAEF,KAAK,OAAO,GACR,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,2BAA2B,CAAC;AAEhC,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAM;gBAEb,MAAM,EAAE,WAAW;IAK/B,cAAc,CAAC,QAAQ,GAAE,OAAO,EAAkB;CAkBnD;AAwQD,wBAAgB,oBAAoB,CAAC,MAAM,KAAA,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAmB1D;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAcjD"}
+{"version":3,"file":"webgl-command-buffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-command-buffer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,aAAa,EAAuB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AAEtC,OAAO,EAAC,WAAW,EAAC,2BAAwB;AAU5C,KAAK,yBAAyB,GAAG;IAC/B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,2BAA2B,CAAC;CACtC,CAAC;AAEF,KAAK,OAAO,GACR,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,2BAA2B,CAAC;AAEhC,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAM;gBAEb,MAAM,EAAE,WAAW;IAK/B,cAAc,CAAC,QAAQ,GAAE,OAAO,EAAkB;CAkBnD;AA6PD,wBAAgB,oBAAoB,CAAC,MAAM,KAAA,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAmB1D;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAcjD"}