@luma.gl/webgl 9.0.0-alpha.9 → 9.0.0-beta.10

package/dist/classic/accessor.d.ts

@@ -1,5 +1,5 @@
-import { Buffer, AccessorObject } from '@luma.gl/api';
-import GL from '@luma.gl/constants';
+import { Buffer, AccessorObject } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
 declare const DEFAULT_ACCESSOR_VALUES: {
     offset: number;
     stride: number;
@@ -9,7 +9,7 @@ declare const DEFAULT_ACCESSOR_VALUES: {
     normalized: boolean;
     integer: boolean;
 };
-export default class Accessor implements AccessorObject {
+export declare class Accessor implements AccessorObject {
     offset?: number;
     stride?: number;
     type?: number;

package/dist/classic/accessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../src/classic/accessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,EAAE,cAAc,EAAC,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGpC,QAAA,MAAM,uBAAuB;;;;;;;;CAQ5B,CAAC;AASF,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,cAAc;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,MAAM;IAOtE,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAY1D,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,cAAc,EAAE,GAAG,QAAQ;gBAI5C,GAAG,SAAS,EAAE,cAAc,EAAE;IAK1C,QAAQ,IAAI,MAAM;IAOlB,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAKD,OAAO,CAAC,KAAK,GAAE,cAAmB,GAAG,IAAI;CA6E1C;AAGD,OAAO,EAAC,uBAAuB,EAAC,CAAC"}
+{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../src/classic/accessor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,MAAM,EAAE,cAAc,EAAC,MAAM,eAAe,CAAC;AACzE,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AAGtC,QAAA,MAAM,uBAAuB;;;;;;;;CAQ5B,CAAC;AASF,qBAAa,QAAS,YAAW,cAAc;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,MAAM;IAOtE,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAY1D,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,cAAc,EAAE,GAAG,QAAQ;gBAI5C,GAAG,SAAS,EAAE,cAAc,EAAE;IAK1C,QAAQ,IAAI,MAAM;IAOlB,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAKD,OAAO,CAAC,KAAK,GAAE,cAAmB,GAAG,IAAI;CA6E1C;AAGD,OAAO,EAAC,uBAAuB,EAAC,CAAC"}

package/dist/classic/accessor.js

@@ -1,144 +1,149 @@
-import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
-import { assert, checkProps } from '@luma.gl/api';
-import GL from '@luma.gl/constants';
-import { getTypedArrayFromGLType } from './typed-array-utils';
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { assert, checkProps } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
+import { getTypedArrayFromGLType } from "./typed-array-utils.js";
 const DEFAULT_ACCESSOR_VALUES = {
-  offset: 0,
-  stride: 0,
-  type: GL.FLOAT,
-  size: 1,
-  divisor: 0,
-  normalized: false,
-  integer: false
+    offset: 0,
+    stride: 0,
+    type: 5126,
+    size: 1,
+    divisor: 0,
+    normalized: false,
+    integer: false
 };
 const PROP_CHECKS = {
-  deprecatedProps: {
-    instanced: 'divisor',
-    isInstanced: 'divisor'
-  }
-};
-export default class Accessor {
-  static getBytesPerElement(accessor) {
-    const ArrayType = getTypedArrayFromGLType(accessor.type || GL.FLOAT);
-    return ArrayType.BYTES_PER_ELEMENT;
-  }
-
-  static getBytesPerVertex(accessor) {
-    assert(accessor.size);
-    const ArrayType = getTypedArrayFromGLType(accessor.type || GL.FLOAT);
-    return ArrayType.BYTES_PER_ELEMENT * accessor.size;
-  }
-
-  static resolve(...accessors) {
-    return new Accessor(...[DEFAULT_ACCESSOR_VALUES, ...accessors]);
-  }
-
-  constructor(...accessors) {
-    _defineProperty(this, "offset", void 0);
-
-    _defineProperty(this, "stride", void 0);
-
-    _defineProperty(this, "type", void 0);
-
-    _defineProperty(this, "size", void 0);
-
-    _defineProperty(this, "divisor", void 0);
-
-    _defineProperty(this, "normalized", void 0);
-
-    _defineProperty(this, "integer", void 0);
-
-    _defineProperty(this, "buffer", void 0);
-
-    _defineProperty(this, "index", void 0);
-
-    accessors.forEach(accessor => this._assign(accessor));
-    Object.freeze(this);
-  }
-
-  toString() {
-    return JSON.stringify(this);
-  }
-
-  get BYTES_PER_ELEMENT() {
-    return Accessor.getBytesPerElement(this);
-  }
-
-  get BYTES_PER_VERTEX() {
-    return Accessor.getBytesPerVertex(this);
-  }
-
-  _assign(props = {}) {
-    props = checkProps('Accessor', props, PROP_CHECKS);
-
-    if (props.type !== undefined) {
-      this.type = props.type;
-
-      if (props.type === GL.INT || props.type === GL.UNSIGNED_INT) {
-        this.integer = true;
-      }
-    }
-
-    if (props.size !== undefined) {
-      this.size = props.size;
-    }
-
-    if (props.offset !== undefined) {
-      this.offset = props.offset;
+    deprecatedProps: {
+        instanced: 'divisor',
+        isInstanced: 'divisor'
     }
-
-    if (props.stride !== undefined) {
-      this.stride = props.stride;
-    }
-
-    if (props.normalize !== undefined) {
-      this.normalized = props.normalize;
+};
+export class Accessor {
+    offset;
+    stride;
+    type;
+    size;
+    divisor;
+    normalized;
+    integer;
+    buffer;
+    index;
+    static getBytesPerElement(accessor) {
+        // TODO: using `FLOAT` when type is not specified,
+        // ensure this assumption is valid or force API to specify type.
+        const ArrayType = getTypedArrayFromGLType(accessor.type || 5126);
+        return ArrayType.BYTES_PER_ELEMENT;
     }
-
-    if (props.normalized !== undefined) {
-      this.normalized = props.normalized;
+    static getBytesPerVertex(accessor) {
+        assert(accessor.size);
+        // TODO: using `FLOAT` when type is not specified,
+        // ensure this assumption is valid or force API to specify type.
+        const ArrayType = getTypedArrayFromGLType(accessor.type || 5126);
+        return ArrayType.BYTES_PER_ELEMENT * accessor.size;
     }
-
-    if (props.integer !== undefined) {
-      this.integer = props.integer;
+    // Combines (merges) a list of accessors. On top of default values
+    // Usually [programAccessor, bufferAccessor, appAccessor]
+    // All props will be set in the returned object.
+    // TODO check for conflicts between values in the supplied accessors
+    static resolve(...accessors) {
+        return new Accessor(...[DEFAULT_ACCESSOR_VALUES, ...accessors]); // Default values
     }
-
-    if (props.divisor !== undefined) {
-      this.divisor = props.divisor;
+    constructor(...accessors) {
+        accessors.forEach(accessor => this._assign(accessor)); // Merge in sequence
+        Object.freeze(this);
     }
-
-    if (props.buffer !== undefined) {
-      this.buffer = props.buffer;
+    toString() {
+        return JSON.stringify(this);
     }
-
-    if (props.index !== undefined) {
-      if (typeof props.index === 'boolean') {
-        this.index = props.index ? 1 : 0;
-      } else {
-        this.index = props.index;
-      }
+    // ACCESSORS
+    // TODO - remove>
+    get BYTES_PER_ELEMENT() {
+        return Accessor.getBytesPerElement(this);
     }
-
-    if (props.instanced !== undefined) {
-      this.divisor = props.instanced ? 1 : 0;
+    get BYTES_PER_VERTEX() {
+        return Accessor.getBytesPerVertex(this);
     }
-
-    if (props.isInstanced !== undefined) {
-      this.divisor = props.isInstanced ? 1 : 0;
+    // PRIVATE
+    // eslint-disable-next-line complexity, max-statements
+    _assign(props = {}) {
+        props = checkProps('Accessor', props, PROP_CHECKS);
+        if (props.type !== undefined) {
+            this.type = props.type;
+            // Auto-deduce integer type?
+            if (props.type === 5124 || props.type === 5125) {
+                this.integer = true;
+            }
+        }
+        if (props.size !== undefined) {
+            this.size = props.size;
+        }
+        if (props.offset !== undefined) {
+            this.offset = props.offset;
+        }
+        if (props.stride !== undefined) {
+            this.stride = props.stride;
+        }
+        // @ts-expect-error
+        if (props.normalize !== undefined) {
+            // @ts-expect-error
+            this.normalized = props.normalize;
+        }
+        if (props.normalized !== undefined) {
+            this.normalized = props.normalized;
+        }
+        if (props.integer !== undefined) {
+            this.integer = props.integer;
+        }
+        // INSTANCE DIVISOR
+        if (props.divisor !== undefined) {
+            this.divisor = props.divisor;
+        }
+        // Buffer is optional
+        if (props.buffer !== undefined) {
+            this.buffer = props.buffer;
+        }
+        // The binding index (for binding e.g. Transform feedbacks and Uniform buffers)
+        // TODO - should this be part of accessor?
+        if (props.index !== undefined) {
+            if (typeof props.index === 'boolean') {
+                this.index = props.index ? 1 : 0;
+            }
+            else {
+                this.index = props.index;
+            }
+        }
+        // DEPRECATED
+        // @ts-expect-error
+        if (props.instanced !== undefined) {
+            // @ts-expect-error
+            this.divisor = props.instanced ? 1 : 0;
+        }
+        // @ts-expect-error
+        if (props.isInstanced !== undefined) {
+            // @ts-expect-error
+            this.divisor = props.isInstanced ? 1 : 0;
+        }
+        if (this.offset === undefined)
+            delete this.offset;
+        if (this.stride === undefined)
+            delete this.stride;
+        if (this.type === undefined)
+            delete this.type;
+        if (this.size === undefined)
+            delete this.size;
+        if (this.divisor === undefined)
+            delete this.divisor;
+        if (this.normalized === undefined)
+            delete this.normalized;
+        if (this.integer === undefined)
+            delete this.integer;
+        if (this.buffer === undefined)
+            delete this.buffer;
+        if (this.index === undefined)
+            delete this.index;
+        return this;
     }
-
-    if (this.offset === undefined) delete this.offset;
-    if (this.stride === undefined) delete this.stride;
-    if (this.type === undefined) delete this.type;
-    if (this.size === undefined) delete this.size;
-    if (this.divisor === undefined) delete this.divisor;
-    if (this.normalized === undefined) delete this.normalized;
-    if (this.integer === undefined) delete this.integer;
-    if (this.buffer === undefined) delete this.buffer;
-    if (this.index === undefined) delete this.index;
-    return this;
-  }
-
 }
+// TEST EXPORTS
 export { DEFAULT_ACCESSOR_VALUES };
-//# sourceMappingURL=accessor.js.map

package/dist/classic/clear.d.ts

@@ -0,0 +1,22 @@
+import { Device, Framebuffer } from '@luma.gl/core';
+/**
+ * Optionally clears depth, color and stencil buffers
+ * @deprecated Set clear color when creating a RenderPass.
+ */
+export declare function clear(device: Device, options?: {
+    framebuffer?: Framebuffer;
+    color?: any;
+    depth?: any;
+    stencil?: any;
+}): void;
+/**
+ * WebGL2 - clear a specific drawing buffer
+ * @deprecated Set clear color when creating a RenderPass
+ */
+export declare function clearBuffer(device: Device, options?: {
+    framebuffer?: Framebuffer;
+    buffer?: any;
+    drawBuffer?: any;
+    value?: any;
+}): void;
+//# sourceMappingURL=clear.d.ts.map

package/dist/classic/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/classic/clear.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAE,WAAW,EAAS,MAAM,eAAe,CAAC;AAiB1D;;;GAGG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAC,GAC7E,IAAI,CAsCN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAA;CAAC,QA2CnF"}

package/dist/classic/clear.js

@@ -0,0 +1,89 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { assert } from '@luma.gl/core';
+import { withGLParameters } from "../context/state-tracker/with-parameters.js";
+// Should collapse during minification
+const GL_DEPTH_BUFFER_BIT = 0x00000100;
+const GL_STENCIL_BUFFER_BIT = 0x00000400;
+const GL_COLOR_BUFFER_BIT = 0x00004000;
+const GL_COLOR = 0x1800;
+const GL_DEPTH = 0x1801;
+const GL_STENCIL = 0x1802;
+const GL_DEPTH_STENCIL = 0x84f9;
+// Should disappear if asserts are removed
+const ERR_ARGUMENTS = 'clear: bad arguments';
+/**
+ * Optionally clears depth, color and stencil buffers
+ * @deprecated Set clear color when creating a RenderPass.
+ */
+export function clear(device, options) {
+    const { framebuffer = null, color = null, depth = null, stencil = null } = options || {};
+    const parameters = {};
+    if (framebuffer) {
+        parameters.framebuffer = framebuffer;
+    }
+    let clearFlags = 0;
+    if (color) {
+        clearFlags |= GL_COLOR_BUFFER_BIT;
+        if (color !== true) {
+            parameters.clearColor = color;
+        }
+    }
+    if (depth) {
+        clearFlags |= GL_DEPTH_BUFFER_BIT;
+        if (depth !== true) {
+            parameters.clearDepth = depth;
+        }
+    }
+    if (stencil) {
+        clearFlags |= GL_STENCIL_BUFFER_BIT;
+        if (depth !== true) {
+            parameters.clearStencil = depth;
+        }
+    }
+    assert(clearFlags !== 0, ERR_ARGUMENTS);
+    // Temporarily set any clear "colors" and call clear
+    const gl = device.gl;
+    withGLParameters(gl, parameters, () => {
+        gl.clear(clearFlags);
+    });
+}
+/**
+ * WebGL2 - clear a specific drawing buffer
+ * @deprecated Set clear color when creating a RenderPass
+ */
+export function clearBuffer(device, options) {
+    const { framebuffer = null, buffer = GL_COLOR, drawBuffer = 0, value = [0, 0, 0, 0] } = options || {};
+    const gl = device.gl;
+    withGLParameters(gl, { framebuffer }, () => {
+        // Method selection per OpenGL ES 3 docs
+        switch (buffer) {
+            case GL_COLOR:
+                switch (value.constructor) {
+                    case Int32Array:
+                        gl.clearBufferiv(buffer, drawBuffer, value);
+                        break;
+                    case Uint32Array:
+                        gl.clearBufferuiv(buffer, drawBuffer, value);
+                        break;
+                    case Float32Array:
+                    default:
+                        gl.clearBufferfv(buffer, drawBuffer, value);
+                }
+                break;
+            case GL_DEPTH:
+                gl.clearBufferfv(GL_DEPTH, 0, [value]);
+                break;
+            case GL_STENCIL:
+                gl.clearBufferiv(GL_STENCIL, 0, [value]);
+                break;
+            case GL_DEPTH_STENCIL:
+                const [depth, stencil] = value;
+                gl.clearBufferfi(GL_DEPTH_STENCIL, 0, depth, stencil);
+                break;
+            default:
+                assert(false, ERR_ARGUMENTS);
+        }
+    });
+}

package/dist/classic/copy-and-blit.d.ts

@@ -0,0 +1,62 @@
+import { Buffer, Texture, Framebuffer, FramebufferProps } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
+import { WEBGLBuffer } from "../adapter/resources/webgl-buffer.js";
+/**
+ * Copies data from a type  or a Texture object into ArrayBuffer object.
+ * App can provide targetPixelArray or have it auto allocated by this method
+ *  newly allocated by this method unless provided by app.
+ * @deprecated Use CommandEncoder.copyTextureToBuffer and Buffer.read
+ * @note Slow requires roundtrip to GPU
+ *
+ * @param source
+ * @param options
+ * @returns pixel array,
+ */
+export declare function readPixelsToArray(source: Framebuffer | Texture, options?: {
+    sourceX?: number;
+    sourceY?: number;
+    sourceFormat?: number;
+    sourceAttachment?: number;
+    target?: Uint8Array | Uint16Array | Float32Array;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    sourceType?: number;
+}): Uint8Array | Uint16Array | Float32Array;
+/**
+ * Copies data from a Framebuffer or a Texture object into a Buffer object.
+ * NOTE: doesn't wait for copy to be complete, it programs GPU to perform a DMA transffer.
+ * @deprecated Use CommandEncoder
+ * @param source
+ * @param options
+ */
+export declare function readPixelsToBuffer(source: Framebuffer | Texture, options?: {
+    sourceX?: number;
+    sourceY?: number;
+    sourceFormat?: number;
+    target?: Buffer;
+    targetByteOffset?: number;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    sourceType?: number;
+}): WEBGLBuffer;
+/**
+ * Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)
+ * @deprecated Use CommandEncoder
+ */
+export declare function copyToTexture(source: Framebuffer | Texture, target: Texture | GL, options?: {
+    sourceX?: number;
+    sourceY?: number;
+    targetX?: number;
+    targetY?: number;
+    targetZ?: number;
+    targetMipmaplevel?: number;
+    targetInternalFormat?: number;
+    width?: number;
+    height?: number;
+}): Texture;
+/**
+ * Wraps a given texture into a framebuffer object, that can be further used
+ * to read data from the texture object.
+ */
+export declare function toFramebuffer(texture: Texture, props?: FramebufferProps): Framebuffer;
+//# sourceMappingURL=copy-and-blit.d.ts.map

package/dist/classic/copy-and-blit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-and-blit.d.ts","sourceRoot":"","sources":["../../src/classic/copy-and-blit.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAC,MAAM,eAAe,CAAC;AACrF,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AAMtC,OAAO,EAAC,WAAW,EAAC,6CAA0C;AAE9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,GAAG,OAAO,EAC7B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;IAEjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,UAAU,GAAG,WAAW,GAAG,YAAY,CAiDzC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,GAAG,OAAO,EAC7B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,WAAW,CA+Cb;AAED;;;GAGG;AAEH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,OAAO,EAC7B,MAAM,EAAE,OAAO,GAAG,EAAE,EACpB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CA+FT;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAUrF"}

package/dist/classic/copy-and-blit.js

@@ -0,0 +1,191 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { assert, Texture, Framebuffer } from '@luma.gl/core';
+import { GL } from '@luma.gl/constants';
+import { getGLTypeFromTypedArray, getTypedArrayFromGLType } from "./typed-array-utils.js";
+import { glFormatToComponents, glTypeToBytes } from "./format-utils.js";
+/**
+ * Copies data from a type  or a Texture object into ArrayBuffer object.
+ * App can provide targetPixelArray or have it auto allocated by this method
+ *  newly allocated by this method unless provided by app.
+ * @deprecated Use CommandEncoder.copyTextureToBuffer and Buffer.read
+ * @note Slow requires roundtrip to GPU
+ *
+ * @param source
+ * @param options
+ * @returns pixel array,
+ */
+export function readPixelsToArray(source, options) {
+    const { sourceX = 0, sourceY = 0, sourceFormat = 6408, sourceAttachment = 36064 // TODO - support gl.readBuffer
+     } = options || {};
+    let { target = null, 
+    // following parameters are auto deduced if not provided
+    sourceWidth, sourceHeight, sourceType } = options || {};
+    const { framebuffer, deleteFramebuffer } = getFramebuffer(source);
+    assert(framebuffer);
+    const { gl, handle } = framebuffer;
+    sourceWidth = sourceWidth || framebuffer.width;
+    sourceHeight = sourceHeight || framebuffer.height;
+    // TODO - Set and unset gl.readBuffer
+    // if (sourceAttachment === GL.COLOR_ATTACHMENT0 && handle === null) {
+    //   sourceAttachment = GL.FRONT;
+    // }
+    const attachment = sourceAttachment - 36064;
+    // assert(attachments[sourceAttachment]);
+    // Deduce the type from color attachment if not provided.
+    sourceType =
+        sourceType ||
+            framebuffer.colorAttachments[attachment]?.texture?.type || 5121;
+    // Deduce type and allocated pixelArray if needed
+    target = getPixelArray(target, sourceType, sourceFormat, sourceWidth, sourceHeight);
+    // Pixel array available, if necessary, deduce type from it.
+    sourceType = sourceType || getGLTypeFromTypedArray(target);
+    const prevHandle = gl.bindFramebuffer(36160, handle);
+    gl.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, target);
+    // @ts-expect-error
+    gl.bindFramebuffer(36160, prevHandle || null);
+    if (deleteFramebuffer) {
+        framebuffer.destroy();
+    }
+    return target;
+}
+/**
+ * Copies data from a Framebuffer or a Texture object into a Buffer object.
+ * NOTE: doesn't wait for copy to be complete, it programs GPU to perform a DMA transffer.
+ * @deprecated Use CommandEncoder
+ * @param source
+ * @param options
+ */
+export function readPixelsToBuffer(source, options) {
+    const { target, sourceX = 0, sourceY = 0, sourceFormat = 6408, targetByteOffset = 0 } = options || {};
+    // following parameters are auto deduced if not provided
+    let { sourceWidth, sourceHeight, sourceType } = options || {};
+    const { framebuffer, deleteFramebuffer } = getFramebuffer(source);
+    assert(framebuffer);
+    sourceWidth = sourceWidth || framebuffer.width;
+    sourceHeight = sourceHeight || framebuffer.height;
+    // Asynchronous read (PIXEL_PACK_BUFFER) is WebGL2 only feature
+    const webglFramebuffer = framebuffer;
+    // deduce type if not available.
+    sourceType = sourceType || 5121;
+    let webglBufferTarget = target;
+    if (!webglBufferTarget) {
+        // Create new buffer with enough size
+        const components = glFormatToComponents(sourceFormat);
+        const byteCount = glTypeToBytes(sourceType);
+        const byteLength = targetByteOffset + sourceWidth * sourceHeight * components * byteCount;
+        webglBufferTarget = webglFramebuffer.device.createBuffer({ byteLength });
+    }
+    // TODO(donmccurdy): Do we have tests to confirm this is working?
+    const commandEncoder = source.device.createCommandEncoder();
+    commandEncoder.copyTextureToBuffer({
+        source: source,
+        width: sourceWidth,
+        height: sourceHeight,
+        origin: [sourceX, sourceY],
+        destination: webglBufferTarget,
+        byteOffset: targetByteOffset
+    });
+    commandEncoder.destroy();
+    if (deleteFramebuffer) {
+        framebuffer.destroy();
+    }
+    return webglBufferTarget;
+}
+/**
+ * Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)
+ * @deprecated Use CommandEncoder
+ */
+// eslint-disable-next-line complexity, max-statements
+export function copyToTexture(source, target, options) {
+    const { sourceX = 0, sourceY = 0, 
+    // attachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer
+    targetMipmaplevel = 0, targetInternalFormat = 6408 } = options || {};
+    let { targetX, targetY, targetZ, width, // defaults to target width
+    height // defaults to target height
+     } = options || {};
+    const { framebuffer, deleteFramebuffer } = getFramebuffer(source);
+    assert(framebuffer);
+    const webglFramebuffer = framebuffer;
+    const { device, handle } = webglFramebuffer;
+    const isSubCopy = typeof targetX !== 'undefined' ||
+        typeof targetY !== 'undefined' ||
+        typeof targetZ !== 'undefined';
+    targetX = targetX || 0;
+    targetY = targetY || 0;
+    targetZ = targetZ || 0;
+    const prevHandle = device.gl.bindFramebuffer(36160, handle);
+    // TODO - support gl.readBuffer (WebGL2 only)
+    // const prevBuffer = gl.readBuffer(attachment);
+    assert(target);
+    let texture = null;
+    let textureTarget;
+    if (target instanceof Texture) {
+        texture = target;
+        width = Number.isFinite(width) ? width : texture.width;
+        height = Number.isFinite(height) ? height : texture.height;
+        texture.bind(0);
+        textureTarget = texture.target;
+    }
+    else {
+        textureTarget = target;
+    }
+    if (!isSubCopy) {
+        device.gl.copyTexImage2D(textureTarget, targetMipmaplevel, targetInternalFormat, sourceX, sourceY, width, height, 0 /* border must be 0 */);
+    }
+    else {
+        switch (textureTarget) {
+            case 3553:
+            case 34067:
+                device.gl.copyTexSubImage2D(textureTarget, targetMipmaplevel, targetX, targetY, sourceX, sourceY, width, height);
+                break;
+            case 35866:
+            case 32879:
+                device.gl.copyTexSubImage3D(textureTarget, targetMipmaplevel, targetX, targetY, targetZ, sourceX, sourceY, width, height);
+                break;
+            default:
+        }
+    }
+    if (texture) {
+        texture.unbind();
+    }
+    // @ts-expect-error
+    device.gl.bindFramebuffer(36160, prevHandle || null);
+    if (deleteFramebuffer) {
+        framebuffer.destroy();
+    }
+    return texture;
+}
+function getFramebuffer(source) {
+    if (!(source instanceof Framebuffer)) {
+        return { framebuffer: toFramebuffer(source), deleteFramebuffer: true };
+    }
+    return { framebuffer: source, deleteFramebuffer: false };
+}
+/**
+ * Wraps a given texture into a framebuffer object, that can be further used
+ * to read data from the texture object.
+ */
+export function toFramebuffer(texture, props) {
+    const { device, width, height, id } = texture;
+    const framebuffer = device.createFramebuffer({
+        ...props,
+        id: `framebuffer-for-${id}`,
+        width,
+        height,
+        colorAttachments: [texture]
+    });
+    return framebuffer;
+}
+function getPixelArray(pixelArray, type, format, width, height) {
+    if (pixelArray) {
+        return pixelArray;
+    }
+    // Allocate pixel array if not already available, using supplied type
+    type = type || 5121;
+    const ArrayType = getTypedArrayFromGLType(type, { clamped: false });
+    const components = glFormatToComponents(format);
+    // TODO - check for composite type (components = 1).
+    return new ArrayType(width * height * components);
+}

package/dist/classic/format-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function glFormatToComponents(format: any): 0 | 1 | 4 | 2 | 3;
+export declare function glTypeToBytes(type: any): 0 | 1 | 4 | 2;
+//# sourceMappingURL=format-utils.d.ts.map