@luma.gl/webgl 9.0.0-alpha.53 → 9.0.0-alpha.54

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

@@ -18,18 +18,15 @@ export declare class WEBGLBuffer extends Buffer {
     byteLength: number;
     /** Number of bytes used */
     bytesUsed: number;
-    /** A partial CPU-side copy of the data in this buffer, for debugging purposes */
-    debugData: ArrayBuffer | null;
     constructor(device: WebGLDevice, props?: BufferProps);
     /** Allocate a new buffer and initialize to contents of typed array */
-    _initWithData(data: any, byteOffset?: number, byteLength?: number): this;
+    _initWithData(data: ArrayBuffer | ArrayBufferView, byteOffset?: number, byteLength?: number): void;
     _initWithByteLength(byteLength: number): this;
     destroy(): void;
     write(data: ArrayBufferView, byteOffset?: number): void;
-    /** Read data from the buffer */
+    /** Asynchronously read data from the buffer */
     readAsync(byteOffset?: number, byteLength?: number): Promise<Uint8Array>;
-    _invalidateDebugData(): void;
-    _getWriteTarget(): GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER;
-    _getReadTarget(): GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER;
+    /** Synchronously read data from the buffer. WebGL only. */
+    readSyncWebGL2(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;AAI5C,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;IAClB,iFAAiF;IACjF,SAAS,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAEzB,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,WAAgB;IA8BxD,sEAAsE;IACtE,aAAa,CACX,IAAI,KAAA,EACJ,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAqC,GAChD,IAAI;IAkBP,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAwBpC,OAAO,IAAI,IAAI;IAWf,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI;IAqBnE,gCAAgC;IACjB,SAAS,CAAC,UAAU,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBlF,oBAAoB;IAIpB,eAAe;IAKf,cAAc;CAIf"}
+{"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"}

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

@@ -1,5 +1,4 @@
 import { Buffer, assert } from '@luma.gl/core';
-const DEBUG_DATA_LENGTH = 10;
 export class WEBGLBuffer extends Buffer {
   constructor(device) {
     let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
@@ -13,7 +12,6 @@ export class WEBGLBuffer extends Buffer {
     this.glIndexType = 5123;
     this.byteLength = void 0;
     this.bytesUsed = void 0;
-    this.debugData = null;
     this.device = device;
     this.gl = this.device.gl;
     this.gl2 = this.device.gl2;
@@ -26,7 +24,6 @@ export class WEBGLBuffer extends Buffer {
     this.glTarget = getWebGLTarget(this.props.usage);
     this.glUsage = getWebGLUsage(this.props.usage);
     this.glIndexType = this.props.indexType === 'uint32' ? 5125 : 5123;
-    this.debugData = null;
     if (props.data) {
       this._initWithData(props.data, props.byteOffset, props.byteLength);
     } else {
@@ -36,17 +33,15 @@ export class WEBGLBuffer extends Buffer {
   _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;
-    assert(ArrayBuffer.isView(data));
-    const glTarget = this._getWriteTarget();
+    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.debugData = data.slice(0, DEBUG_DATA_LENGTH);
     this.bytesUsed = byteLength;
     this.byteLength = byteLength;
+    this._setDebugData(data, byteOffset, byteLength);
     this.trackAllocatedMemory(byteLength);
-    return this;
   }
   _initWithByteLength(byteLength) {
     assert(byteLength >= 0);
@@ -54,13 +49,14 @@ export class WEBGLBuffer extends Buffer {
     if (byteLength === 0) {
       data = new Float32Array(0);
     }
-    const glTarget = this._getWriteTarget();
+    const glTarget = this.glTarget;
     this.gl.bindBuffer(glTarget, this.handle);
     this.gl.bufferData(glTarget, data, this.glUsage);
     this.gl.bindBuffer(glTarget, null);
-    this.debugData = null;
     this.bytesUsed = byteLength;
     this.byteLength = byteLength;
+    this._setDebugData(null, 0, byteLength);
+    this.trackAllocatedMemory(byteLength);
     return this;
   }
   destroy() {
@@ -85,29 +81,27 @@ export class WEBGLBuffer extends Buffer {
       this.gl.bufferSubData(glTarget, byteOffset, 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;
+    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;
   }
-  _invalidateDebugData() {
-    this.debugData = null;
-  }
-  _getWriteTarget() {
-    return this.glTarget;
-  }
-  _getReadTarget() {
-    return this.glTarget;
-  }
 }
 function getWebGLTarget(usage) {
   if (usage & Buffer.INDEX) {

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

@@ -1 +1 @@
-{"version":3,"file":"webgl-buffer.js","names":["Buffer","assert","DEBUG_DATA_LENGTH","WEBGLBuffer","constructor","device","props","arguments","length","undefined","gl","gl2","handle","glTarget","glUsage","glIndexType","byteLength","bytesUsed","debugData","createBuffer","setSpectorMetadata","data","getWebGLTarget","usage","getWebGLUsage","indexType","_initWithData","byteOffset","_initWithByteLength","ArrayBuffer","isView","_getWriteTarget","bindBuffer","bufferData","bufferSubData","slice","trackAllocatedMemory","Float32Array","destroy","destroyed","removeStats","trackDeallocatedMemory","deleteBuffer","write","srcOffset","isWebGL2","assertWebGL2","readAsync","_byteLength","Uint8Array","dstOffset","getBufferSubData","_invalidateDebugData","_getReadTarget","INDEX","VERTEX","UNIFORM"],"sources":["../../../src/adapter/resources/webgl-buffer.ts"],"sourcesContent":["// luma.gl, MIT license\n// Copyright (c) vis.gl contributors\n\nimport type {BufferProps} from '@luma.gl/core';\nimport {Buffer, assert} from '@luma.gl/core';\nimport {GL} from '@luma.gl/constants';\nimport {WebGLDevice} from '../webgl-device';\n\nconst DEBUG_DATA_LENGTH = 10;\n\n/** WebGL Buffer interface */\nexport class WEBGLBuffer extends Buffer {\n  readonly device: WebGLDevice;\n  readonly gl: WebGLRenderingContext;\n  readonly gl2: WebGL2RenderingContext | null;\n  readonly handle: WebGLBuffer;\n\n  /** Target in OpenGL defines the type of buffer */\n  readonly glTarget: GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER;\n  /** Usage is a hint on how frequently the buffer will be updates */\n  readonly glUsage: GL.STATIC_DRAW | GL.DYNAMIC_DRAW;\n  /** Index type is needed when issuing draw calls, so we pre-compute it */\n  readonly glIndexType: GL.UNSIGNED_SHORT | GL.UNSIGNED_INT = GL.UNSIGNED_SHORT;\n\n  /** Number of bytes allocated on the GPU for this buffer */\n  byteLength: number;\n  /** Number of bytes used */\n  bytesUsed: number;\n  /** A partial CPU-side copy of the data in this buffer, for debugging purposes */\n  debugData: ArrayBuffer | null = null;\n\n  constructor(device: WebGLDevice, props: BufferProps = {}) {\n    super(device, props);\n\n    this.device = device;\n    this.gl = this.device.gl;\n    this.gl2 = this.device.gl2;\n\n    const handle = typeof props === 'object' ? props.handle : undefined;\n    this.handle = handle || this.gl.createBuffer();\n    device.setSpectorMetadata(this.handle, {...this.props, data: typeof this.props.data});\n\n    // - In WebGL1, need to make sure we use GL.ELEMENT_ARRAY_BUFFER when initializing element buffers\n    //   otherwise buffer type will lock to generic (non-element) buffer\n    // - In WebGL2, we can use GL.COPY_READ_BUFFER which avoids locking the type here\n    this.glTarget = getWebGLTarget(this.props.usage);\n    this.glUsage = getWebGLUsage(this.props.usage);\n    this.glIndexType = this.props.indexType === 'uint32' ? GL.UNSIGNED_INT : GL.UNSIGNED_SHORT;\n\n    this.debugData = null;\n\n    // Set data: (re)initializes the buffer\n    if (props.data) {\n      this._initWithData(props.data, props.byteOffset, props.byteLength);\n    } else {\n      this._initWithByteLength(props.byteLength || 0);\n    }\n  }\n\n  // PRIVATE METHODS\n\n  /** Allocate a new buffer and initialize to contents of typed array */\n  _initWithData(\n    data,\n    byteOffset: number = 0,\n    byteLength: number = data.byteLength + byteOffset\n  ): this {\n    assert(ArrayBuffer.isView(data));\n\n    const glTarget = this._getWriteTarget();\n    this.gl.bindBuffer(glTarget, this.handle);\n    this.gl.bufferData(glTarget, byteLength, this.glUsage);\n    this.gl.bufferSubData(glTarget, byteOffset, data);\n    this.gl.bindBuffer(glTarget, null);\n\n    this.debugData = data.slice(0, DEBUG_DATA_LENGTH);\n    this.bytesUsed = byteLength;\n    this.byteLength = byteLength;\n    this.trackAllocatedMemory(byteLength);\n\n    return this;\n  }\n\n  // Allocate a GPU buffer of specified size.\n  _initWithByteLength(byteLength: number): this {\n    assert(byteLength >= 0);\n\n    // Workaround needed for Safari (#291):\n    // gl.bufferData with size equal to 0 crashes. Instead create zero sized array.\n    let data = byteLength;\n    if (byteLength === 0) {\n      // @ts-expect-error\n      data = new Float32Array(0);\n    }\n\n    const glTarget = this._getWriteTarget();\n\n    this.gl.bindBuffer(glTarget, this.handle);\n    this.gl.bufferData(glTarget, data, this.glUsage);\n    this.gl.bindBuffer(glTarget, null);\n\n    this.debugData = null;\n    this.bytesUsed = byteLength;\n    this.byteLength = byteLength;\n\n    return this;\n  }\n\n  override destroy(): void {\n    if (!this.destroyed && this.handle) {\n      this.removeStats();\n      this.trackDeallocatedMemory();\n      this.gl.deleteBuffer(this.handle);\n      this.destroyed = true;\n      // @ts-expect-error\n      this.handle = null;\n    }\n  }\n\n  override write(data: ArrayBufferView, byteOffset: number = 0): void {\n    const srcOffset = 0;\n    const byteLength = undefined; // data.byteLength;\n\n    // Create the buffer - binding it here for the first time locks the type\n    // In WebGL2, use GL.COPY_WRITE_BUFFER to avoid locking the type\n    const glTarget = this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;\n    this.gl.bindBuffer(glTarget, this.handle);\n    // WebGL2: subData supports additional srcOffset and length parameters\n    if (srcOffset !== 0 || byteLength !== undefined) {\n      this.device.assertWebGL2();\n      this.gl2.bufferSubData(glTarget, byteOffset, data, srcOffset, byteLength);\n    } else {\n      this.gl.bufferSubData(glTarget, byteOffset, data);\n    }\n    this.gl.bindBuffer(glTarget, null);\n\n    // TODO - update local `data` if offsets are right\n    // this.debugData = data.slice(byteOffset, 40);\n  }\n\n  /** Read data from the buffer */\n  override async readAsync(byteOffset = 0, byteLength?: number): Promise<Uint8Array> {\n    this.device.assertWebGL2();\n\n    byteLength = byteLength ?? this.byteLength;\n    const data = new Uint8Array(byteLength);\n    const dstOffset = 0;\n\n    // Use GL.COPY_READ_BUFFER to avoid disturbing other targets and locking type\n    this.gl.bindBuffer(GL.COPY_READ_BUFFER, this.handle);\n    this.gl2.getBufferSubData(GL.COPY_READ_BUFFER, byteOffset, data, dstOffset, byteLength);\n    this.gl.bindBuffer(GL.COPY_READ_BUFFER, null);\n\n    // TODO - update local `data` if offsets are 0\n    // this.debugData = null;\n\n    return data;\n  }\n\n  // PROTECTED METHODS (INTENDED FOR USE BY OTHER FRAMEWORK CODE ONLY)\n\n  _invalidateDebugData() {\n    this.debugData = null;\n  }\n\n  _getWriteTarget() {\n    return this.glTarget;\n    // return this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;\n  }\n\n  _getReadTarget() {\n    return this.glTarget;\n    // return this.device.isWebGL2 ? GL.COPY_READ_BUFFER : this.glTarget;\n  }\n}\n\n// static MAP_READ = 0x01;\n// static MAP_WRITE = 0x02;\n// static COPY_SRC = 0x0004;\n// static COPY_DST = 0x0008;\n// static INDEX = 0x0010;\n// static VERTEX = 0x0020;\n// static UNIFORM = 0x0040;\n// static STORAGE = 0x0080;\n// static INDIRECT = 0x0100;\n// static QUERY_RESOLVE = 0x0200;\n\nfunction getWebGLTarget(\n  usage: number\n): GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER {\n  if (usage & Buffer.INDEX) {\n    return GL.ELEMENT_ARRAY_BUFFER;\n  }\n  if (usage & Buffer.VERTEX) {\n    return GL.ARRAY_BUFFER;\n  }\n  if (usage & Buffer.UNIFORM) {\n    return GL.UNIFORM_BUFFER;\n  }\n\n  // gl.COPY_READ_BUFFER: Buffer for copying from one buffer object to another.\n  // gl.COPY_WRITE_BUFFER: Buffer for copying from one buffer object to another.\n  // gl.TRANSFORM_FEEDBACK_BUFFER: Buffer for transform feedback operations.\n  // gl.PIXEL_PACK_BUFFER: Buffer used for pixel transfer operations.\n  // gl.PIXEL_UNPACK_BUFFER: Buffer used for pixel transfer operations.\n\n  // Binding a buffer for the first time locks the type\n  // In WebGL2, use GL.COPY_WRITE_BUFFER to avoid locking the type\n  return GL.ARRAY_BUFFER;\n}\n\n/** @todo usage is not passed correctly */\nfunction getWebGLUsage(usage: number): GL.STATIC_DRAW | GL.DYNAMIC_DRAW {\n  if (usage & Buffer.INDEX) {\n    return GL.STATIC_DRAW;\n  }\n  if (usage & Buffer.VERTEX) {\n    return GL.STATIC_DRAW;\n  }\n  if (usage & Buffer.UNIFORM) {\n    return GL.DYNAMIC_DRAW;\n  }\n  return GL.STATIC_DRAW;\n}\n"],"mappings":"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"}
+{"version":3,"file":"webgl-buffer.js","names":["Buffer","assert","WEBGLBuffer","constructor","device","props","arguments","length","undefined","gl","gl2","handle","glTarget","glUsage","glIndexType","byteLength","bytesUsed","createBuffer","setSpectorMetadata","data","getWebGLTarget","usage","getWebGLUsage","indexType","_initWithData","byteOffset","_initWithByteLength","bindBuffer","bufferData","bufferSubData","_setDebugData","trackAllocatedMemory","Float32Array","destroy","destroyed","removeStats","trackDeallocatedMemory","deleteBuffer","write","srcOffset","isWebGL2","assertWebGL2","readAsync","readSyncWebGL2","_byteLength","Uint8Array","dstOffset","getBufferSubData","INDEX","VERTEX","UNIFORM"],"sources":["../../../src/adapter/resources/webgl-buffer.ts"],"sourcesContent":["// luma.gl, MIT license\n// Copyright (c) vis.gl contributors\n\nimport type {BufferProps} from '@luma.gl/core';\nimport {Buffer, assert} from '@luma.gl/core';\nimport {GL} from '@luma.gl/constants';\nimport {WebGLDevice} from '../webgl-device';\n\n/** WebGL Buffer interface */\nexport class WEBGLBuffer extends Buffer {\n  readonly device: WebGLDevice;\n  readonly gl: WebGLRenderingContext;\n  readonly gl2: WebGL2RenderingContext | null;\n  readonly handle: WebGLBuffer;\n\n  /** Target in OpenGL defines the type of buffer */\n  readonly glTarget: GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER;\n  /** Usage is a hint on how frequently the buffer will be updates */\n  readonly glUsage: GL.STATIC_DRAW | GL.DYNAMIC_DRAW;\n  /** Index type is needed when issuing draw calls, so we pre-compute it */\n  readonly glIndexType: GL.UNSIGNED_SHORT | GL.UNSIGNED_INT = GL.UNSIGNED_SHORT;\n\n  /** Number of bytes allocated on the GPU for this buffer */\n  byteLength: number;\n  /** Number of bytes used */\n  bytesUsed: number;\n\n  constructor(device: WebGLDevice, props: BufferProps = {}) {\n    super(device, props);\n\n    this.device = device;\n    this.gl = this.device.gl;\n    this.gl2 = this.device.gl2;\n\n    const handle = typeof props === 'object' ? props.handle : undefined;\n    this.handle = handle || this.gl.createBuffer();\n    device.setSpectorMetadata(this.handle, {...this.props, data: typeof this.props.data});\n\n    // - In WebGL1, need to make sure we use GL.ELEMENT_ARRAY_BUFFER when initializing element buffers\n    //   otherwise buffer type will lock to generic (non-element) buffer\n    // - In WebGL2, we can use GL.COPY_READ_BUFFER which avoids locking the type here\n    this.glTarget = getWebGLTarget(this.props.usage);\n    this.glUsage = getWebGLUsage(this.props.usage);\n    this.glIndexType = this.props.indexType === 'uint32' ? GL.UNSIGNED_INT : GL.UNSIGNED_SHORT;\n\n    // Set data: (re)initializes the buffer\n    if (props.data) {\n      this._initWithData(props.data, props.byteOffset, props.byteLength);\n    } else {\n      this._initWithByteLength(props.byteLength || 0);\n    }\n  }\n\n  // PRIVATE METHODS\n\n  /** Allocate a new buffer and initialize to contents of typed array */\n  _initWithData(\n    data: ArrayBuffer | ArrayBufferView,\n    byteOffset: number = 0,\n    byteLength: number = data.byteLength + byteOffset\n  ): void {\n    // const glTarget = this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;\n    const glTarget = this.glTarget;\n    this.gl.bindBuffer(glTarget, this.handle);\n    this.gl.bufferData(glTarget, byteLength, this.glUsage);\n    this.gl.bufferSubData(glTarget, byteOffset, data);\n    this.gl.bindBuffer(glTarget, null);\n\n    this.bytesUsed = byteLength;\n    this.byteLength = byteLength;\n\n    this._setDebugData(data, byteOffset, byteLength);\n    this.trackAllocatedMemory(byteLength);\n  }\n\n  // Allocate a GPU buffer of specified size.\n  _initWithByteLength(byteLength: number): this {\n    assert(byteLength >= 0);\n\n    // Workaround needed for Safari (#291):\n    // gl.bufferData with size equal to 0 crashes. Instead create zero sized array.\n    let data = byteLength;\n    if (byteLength === 0) {\n      // @ts-expect-error\n      data = new Float32Array(0);\n    }\n\n    // const glTarget = this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;\n    const glTarget = this.glTarget;\n\n    this.gl.bindBuffer(glTarget, this.handle);\n    this.gl.bufferData(glTarget, data, this.glUsage);\n    this.gl.bindBuffer(glTarget, null);\n\n    this.bytesUsed = byteLength;\n    this.byteLength = byteLength;\n\n    this._setDebugData(null, 0, byteLength);\n    this.trackAllocatedMemory(byteLength);\n\n    return this;\n  }\n\n  override destroy(): void {\n    if (!this.destroyed && this.handle) {\n      this.removeStats();\n      this.trackDeallocatedMemory();\n      this.gl.deleteBuffer(this.handle);\n      this.destroyed = true;\n      // @ts-expect-error\n      this.handle = null;\n    }\n  }\n\n  override write(data: ArrayBufferView, byteOffset: number = 0): void {\n    const srcOffset = 0;\n    const byteLength = undefined; // data.byteLength;\n\n    // Create the buffer - binding it here for the first time locks the type\n    // In WebGL2, use GL.COPY_WRITE_BUFFER to avoid locking the type\n    const glTarget = this.device.isWebGL2 ? GL.COPY_WRITE_BUFFER : this.glTarget;\n    this.gl.bindBuffer(glTarget, this.handle);\n    // WebGL2: subData supports additional srcOffset and length parameters\n    if (srcOffset !== 0 || byteLength !== undefined) {\n      this.device.assertWebGL2();\n      this.gl2.bufferSubData(glTarget, byteOffset, data, srcOffset, byteLength);\n    } else {\n      this.gl.bufferSubData(glTarget, byteOffset, data);\n    }\n    this.gl.bindBuffer(glTarget, null);\n\n    this._setDebugData(data, byteOffset, data.byteLength);\n  }\n\n  /** Asynchronously read data from the buffer */\n  override async readAsync(byteOffset = 0, byteLength?: number): Promise<Uint8Array> {\n    return this.readSyncWebGL2(byteOffset, byteLength);\n  }\n\n  /** Synchronously read data from the buffer. WebGL only. */\n  override readSyncWebGL2(byteOffset = 0, byteLength?: number): Uint8Array {\n    this.device.assertWebGL2();\n\n    byteLength = byteLength ?? this.byteLength - byteOffset;\n    const data = new Uint8Array(byteLength);\n    const dstOffset = 0;\n\n    // Use GL.COPY_READ_BUFFER to avoid disturbing other targets and locking type\n    this.gl.bindBuffer(GL.COPY_READ_BUFFER, this.handle);\n    this.gl2.getBufferSubData(GL.COPY_READ_BUFFER, byteOffset, data, dstOffset, byteLength);\n    this.gl.bindBuffer(GL.COPY_READ_BUFFER, null);\n\n    // Update local `data` if offsets are 0\n    this._setDebugData(data, byteOffset, byteLength);\n\n    return data;\n  }\n}\n\n/**\n * Returns a WebGL buffer target\n *\n * @param usage\n * static MAP_READ = 0x01;\n * static MAP_WRITE = 0x02;\n * static COPY_SRC = 0x0004;\n * static COPY_DST = 0x0008;\n * static INDEX = 0x0010;\n * static VERTEX = 0x0020;\n * static UNIFORM = 0x0040;\n * static STORAGE = 0x0080;\n * static INDIRECT = 0x0100;\n * static QUERY_RESOLVE = 0x0200;\n * \n * @returns WebGL buffer targe\n * \n * Buffer bind points in WebGL2\n * gl.COPY_READ_BUFFER: Buffer for copying from one buffer object to another.\n * gl.COPY_WRITE_BUFFER: Buffer for copying from one buffer object to another.\n * gl.TRANSFORM_FEEDBACK_BUFFER: Buffer for transform feedback operations.\n * gl.PIXEL_PACK_BUFFER: Buffer used for pixel transfer operations.\n * gl.PIXEL_UNPACK_BUFFER: Buffer used for pixel transfer operations.\n */\nfunction getWebGLTarget(\n  usage: number\n): GL.ARRAY_BUFFER | GL.ELEMENT_ARRAY_BUFFER | GL.UNIFORM_BUFFER {\n  if (usage & Buffer.INDEX) {\n    return GL.ELEMENT_ARRAY_BUFFER;\n  }\n  if (usage & Buffer.VERTEX) {\n    return GL.ARRAY_BUFFER;\n  }\n  if (usage & Buffer.UNIFORM) {\n    return GL.UNIFORM_BUFFER;\n  }\n\n  // Binding a buffer for the first time locks the type\n  // In WebGL2, we can use GL.COPY_WRITE_BUFFER to avoid locking the type\n  return GL.ARRAY_BUFFER;\n}\n\n/** @todo usage is not passed correctly */\nfunction getWebGLUsage(usage: number): GL.STATIC_DRAW | GL.DYNAMIC_DRAW {\n  if (usage & Buffer.INDEX) {\n    return GL.STATIC_DRAW;\n  }\n  if (usage & Buffer.VERTEX) {\n    return GL.STATIC_DRAW;\n  }\n  if (usage & Buffer.UNIFORM) {\n    return GL.DYNAMIC_DRAW;\n  }\n  return GL.STATIC_DRAW;\n}\n"],"mappings":"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"}

package/dist/dist.dev.js

@@ -1051,14 +1051,20 @@ var __exports__ = (() => {
       this.usage = props.usage || 0;
       this.indexType = deducedProps.indexType;
     }
-    write(data, byteOffset) {
+    readSyncWebGL2(byteOffset, byteLength) {
       throw new Error("not implemented");
     }
-    readAsync(byteOffset, byteLength) {
-      throw new Error("not implemented");
-    }
-    getData() {
-      throw new Error("not implemented");
+    debugData = new ArrayBuffer(0);
+    _setDebugData(data, byteOffset, byteLength) {
+      const buffer = ArrayBuffer.isView(data) ? data.buffer : data;
+      const debugDataLength = Math.min(data ? data.byteLength : byteLength, _Buffer.DEBUG_DATA_MAX_LENGTH);
+      if (data === null) {
+        this.debugData = new ArrayBuffer(debugDataLength);
+      } else if (byteOffset === 0 && byteLength === data.byteLength) {
+        this.debugData = buffer.slice(0, debugDataLength);
+      } else {
+        this.debugData = buffer.slice(byteOffset, byteOffset + debugDataLength);
+      }
     }
   };
   var Buffer2 = _Buffer;
@@ -1081,6 +1087,7 @@ var __exports__ = (() => {
   __publicField(Buffer2, "STORAGE", 128);
   __publicField(Buffer2, "INDIRECT", 256);
   __publicField(Buffer2, "QUERY_RESOLVE", 512);
+  __publicField(Buffer2, "DEBUG_DATA_MAX_LENGTH", 32);
 
   // ../core/src/adapter/device.ts
   var _Device = class {
@@ -5099,10 +5106,8 @@ void main(void) {}`;
   }
 
   // src/adapter/resources/webgl-buffer.ts
-  var DEBUG_DATA_LENGTH = 10;
   var WEBGLBuffer = class extends Buffer2 {
     glIndexType = 5123;
-    debugData = null;
     constructor(device, props = {}) {
       super(device, props);
       this.device = device;
@@ -5117,7 +5122,6 @@ void main(void) {}`;
       this.glTarget = getWebGLTarget(this.props.usage);
       this.glUsage = getWebGLUsage(this.props.usage);
       this.glIndexType = this.props.indexType === "uint32" ? 5125 : 5123;
-      this.debugData = null;
       if (props.data) {
         this._initWithData(props.data, props.byteOffset, props.byteLength);
       } else {
@@ -5125,17 +5129,15 @@ void main(void) {}`;
       }
     }
     _initWithData(data, byteOffset = 0, byteLength = data.byteLength + byteOffset) {
-      assert2(ArrayBuffer.isView(data));
-      const glTarget = this._getWriteTarget();
+      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.debugData = data.slice(0, DEBUG_DATA_LENGTH);
       this.bytesUsed = byteLength;
       this.byteLength = byteLength;
+      this._setDebugData(data, byteOffset, byteLength);
       this.trackAllocatedMemory(byteLength);
-      return this;
     }
     _initWithByteLength(byteLength) {
       assert2(byteLength >= 0);
@@ -5143,13 +5145,14 @@ void main(void) {}`;
       if (byteLength === 0) {
         data = new Float32Array(0);
       }
-      const glTarget = this._getWriteTarget();
+      const glTarget = this.glTarget;
       this.gl.bindBuffer(glTarget, this.handle);
       this.gl.bufferData(glTarget, data, this.glUsage);
       this.gl.bindBuffer(glTarget, null);
-      this.debugData = null;
       this.bytesUsed = byteLength;
       this.byteLength = byteLength;
+      this._setDebugData(null, 0, byteLength);
+      this.trackAllocatedMemory(byteLength);
       return this;
     }
     destroy() {
@@ -5173,26 +5176,22 @@ void main(void) {}`;
         this.gl.bufferSubData(glTarget, byteOffset, data);
       }
       this.gl.bindBuffer(glTarget, null);
+      this._setDebugData(data, byteOffset, data.byteLength);
     }
     async readAsync(byteOffset = 0, byteLength) {
+      return this.readSyncWebGL2(byteOffset, byteLength);
+    }
+    readSyncWebGL2(byteOffset = 0, byteLength) {
       this.device.assertWebGL2();
-      byteLength = byteLength ?? this.byteLength;
+      byteLength = 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;
     }
-    _invalidateDebugData() {
-      this.debugData = null;
-    }
-    _getWriteTarget() {
-      return this.glTarget;
-    }
-    _getReadTarget() {
-      return this.glTarget;
-    }
   };
   function getWebGLTarget(usage) {
     if (usage & Buffer2.INDEX) {

package/dist/index.cjs

@@ -2574,7 +2574,6 @@ function convertMinFilterMode(minFilter, mipmapFilter) {
 // src/adapter/resources/webgl-buffer.ts
 var import_core7 = require("@luma.gl/core");
 var import_constants10 = require("@luma.gl/constants");
-var DEBUG_DATA_LENGTH = 10;
 var WEBGLBuffer = class extends import_core7.Buffer {
   device;
   gl;
@@ -2590,8 +2589,6 @@ var WEBGLBuffer = class extends import_core7.Buffer {
   byteLength;
   /** Number of bytes used */
   bytesUsed;
-  /** A partial CPU-side copy of the data in this buffer, for debugging purposes */
-  debugData = null;
   constructor(device, props = {}) {
     super(device, props);
     this.device = device;
@@ -2603,7 +2600,6 @@ var WEBGLBuffer = class extends import_core7.Buffer {
     this.glTarget = getWebGLTarget(this.props.usage);
     this.glUsage = getWebGLUsage(this.props.usage);
     this.glIndexType = this.props.indexType === "uint32" ? import_constants10.GL.UNSIGNED_INT : import_constants10.GL.UNSIGNED_SHORT;
-    this.debugData = null;
     if (props.data) {
       this._initWithData(props.data, props.byteOffset, props.byteLength);
     } else {
@@ -2613,17 +2609,15 @@ var WEBGLBuffer = class extends import_core7.Buffer {
   // PRIVATE METHODS
   /** Allocate a new buffer and initialize to contents of typed array */
   _initWithData(data, byteOffset = 0, byteLength = data.byteLength + byteOffset) {
-    (0, import_core7.assert)(ArrayBuffer.isView(data));
-    const glTarget = this._getWriteTarget();
+    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.debugData = data.slice(0, DEBUG_DATA_LENGTH);
     this.bytesUsed = byteLength;
     this.byteLength = byteLength;
+    this._setDebugData(data, byteOffset, byteLength);
     this.trackAllocatedMemory(byteLength);
-    return this;
   }
   // Allocate a GPU buffer of specified size.
   _initWithByteLength(byteLength) {
@@ -2632,13 +2626,14 @@ var WEBGLBuffer = class extends import_core7.Buffer {
     if (byteLength === 0) {
       data = new Float32Array(0);
     }
-    const glTarget = this._getWriteTarget();
+    const glTarget = this.glTarget;
     this.gl.bindBuffer(glTarget, this.handle);
     this.gl.bufferData(glTarget, data, this.glUsage);
     this.gl.bindBuffer(glTarget, null);
-    this.debugData = null;
     this.bytesUsed = byteLength;
     this.byteLength = byteLength;
+    this._setDebugData(null, 0, byteLength);
+    this.trackAllocatedMemory(byteLength);
     return this;
   }
   destroy() {
@@ -2662,28 +2657,24 @@ var WEBGLBuffer = class extends import_core7.Buffer {
       this.gl.bufferSubData(glTarget, byteOffset, data);
     }
     this.gl.bindBuffer(glTarget, null);
+    this._setDebugData(data, byteOffset, data.byteLength);
   }
-  /** Read data from the buffer */
+  /** Asynchronously read data from the buffer */
   async readAsync(byteOffset = 0, byteLength) {
+    return this.readSyncWebGL2(byteOffset, byteLength);
+  }
+  /** Synchronously read data from the buffer. WebGL only. */
+  readSyncWebGL2(byteOffset = 0, byteLength) {
     this.device.assertWebGL2();
-    byteLength = byteLength ?? this.byteLength;
+    byteLength = byteLength ?? this.byteLength - byteOffset;
     const data = new Uint8Array(byteLength);
     const dstOffset = 0;
     this.gl.bindBuffer(import_constants10.GL.COPY_READ_BUFFER, this.handle);
     this.gl2.getBufferSubData(import_constants10.GL.COPY_READ_BUFFER, byteOffset, data, dstOffset, byteLength);
     this.gl.bindBuffer(import_constants10.GL.COPY_READ_BUFFER, null);
+    this._setDebugData(data, byteOffset, byteLength);
     return data;
   }
-  // PROTECTED METHODS (INTENDED FOR USE BY OTHER FRAMEWORK CODE ONLY)
-  _invalidateDebugData() {
-    this.debugData = null;
-  }
-  _getWriteTarget() {
-    return this.glTarget;
-  }
-  _getReadTarget() {
-    return this.glTarget;
-  }
 };
 function getWebGLTarget(usage) {
   if (usage & import_core7.Buffer.INDEX) {