@luma.gl/webgl 9.1.0-alpha.1 → 9.1.0-alpha.12

package/src/utils/fill-array.ts

@@ -2,15 +2,15 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import type {NumberArray} from '@math.gl/types';
+import type {NumericArray} from '@math.gl/types';
 
 // Uses copyWithin to significantly speed up typed array value filling
 export function fillArray(options: {
-  target: NumberArray;
-  source: NumberArray;
+  target: NumericArray;
+  source: NumericArray;
   start?: number;
   count?: number;
-}): NumberArray {
+}): NumericArray {
   const {target, source, start = 0, count = 1} = options;
   const length = source.length;
   const total = count * length;

package/src/utils/split-uniforms-and-bindings.ts

@@ -5,7 +5,7 @@
 import type {UniformValue, Binding} from '@luma.gl/core';
 import {isNumericArray} from '@math.gl/types';
 
-export function isUniformValue(value: unknown): boolean {
+export function isUniformValue(value: unknown): value is UniformValue {
   return isNumericArray(value) !== null || typeof value === 'number' || typeof value === 'boolean';
 }
 
@@ -21,9 +21,9 @@ export function splitUniformsAndBindings(
   Object.keys(uniforms).forEach(name => {
     const uniform = uniforms[name];
     if (isUniformValue(uniform)) {
-      result.uniforms[name] = uniform as UniformValue;
+      result.uniforms[name] = uniform;
     } else {
-      result.bindings[name] = uniform as Binding;
+      result.bindings[name] = uniform;
     }
   });
 

package/src/utils/uid.ts

@@ -0,0 +1,16 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+const uidCounters: Record<string, number> = {};
+
+/**
+ * Returns a UID.
+ * @param id= - Identifier base name
+ * @return uid
+ **/
+export function uid(id: string = 'id'): string {
+  uidCounters[id] = uidCounters[id] || 1;
+  const count = uidCounters[id]++;
+  return `${id}-${count}`;
+}

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

@@ -1 +0,0 @@
-{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../src/classic/accessor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AAGtC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAIhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,QAAA,MAAM,uBAAuB;;;;;;;;CAQ5B,CAAC;AAEF,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;CA2E1C;AAGD,OAAO,EAAC,uBAAuB,EAAC,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/classic/clear.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAE,WAAW,EAAC,MAAM,eAAe,CAAC;AAclD;;;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/copy-and-blit.d.ts

@@ -1,63 +0,0 @@
-import { Buffer, Texture, Framebuffer, FramebufferProps } from '@luma.gl/core';
-import { GL } from '@luma.gl/constants';
-import { WEBGLFramebuffer } from "../adapter/resources/webgl-framebuffer.js";
-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): WEBGLFramebuffer;
-//# sourceMappingURL=copy-and-blit.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"copy-and-blit.d.ts","sourceRoot":"","sources":["../../src/classic/copy-and-blit.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAC,EAAE,EAAC,MAAM,oBAAoB,CAAC;AAEtC,OAAO,EAAC,gBAAgB,EAAC,kDAA+C;AAGxE,OAAO,EAAC,WAAW,EAAC,6CAA0C;AAG9D;;;;;;;;;;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,CA+CzC;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,CAiGT;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAU1F"}

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

@@ -1,193 +0,0 @@
-// luma.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-import { 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";
-import { WEBGLTexture } from "../adapter/resources/webgl-texture.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?.glType || 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 WEBGLTexture) {
-        texture = target;
-        width = Number.isFinite(width) ? width : texture.width;
-        height = Number.isFinite(height) ? height : texture.height;
-        texture?.bind(0);
-        // @ts-ignore
-        textureTarget = texture.target;
-    }
-    else {
-        // @ts-ignore
-        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.map

@@ -1 +0,0 @@
-{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../src/classic/format-utils.ts"],"names":[],"mappings":"AAOA,wBAAgB,oBAAoB,CAAC,MAAM,KAAA,qBAmB1C;AAGD,wBAAgB,aAAa,CAAC,IAAI,KAAA,iBAcjC"}

package/dist/classic/typed-array-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typed-array-utils.d.ts","sourceRoot":"","sources":["../../src/classic/typed-array-utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAK,UAAU,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAI/D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,UAAU,GAAG,UAAU,CAuB3E;AAED;;;;;;;GAOG;AAEH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,qBAAqB,CAwBvB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,GAAG,IAAI,CAgBP;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAAG;IACvF,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAaA"}

package/dist/context/state-tracker/track-context-state.d.ts

@@ -1,22 +0,0 @@
-/**
- * Initialize WebGL state caching on a context
- * can be called multiple times to enable/disable
- *
- * @note After calling this function, context state will be cached
- * gl.state.push() and gl.state.pop() will be available for saving,
- * temporarily modifying, and then restoring state.
- */
-export declare function trackContextState(gl: WebGL2RenderingContext, options?: {
-    enable?: boolean;
-    copyState?: boolean;
-    log?: any;
-}): WebGL2RenderingContext;
-/**
- * Saves current WebGL context state onto an internal per-context stack
- */
-export declare function pushContextState(gl: WebGL2RenderingContext): void;
-/**
- * Restores previously saved WebGL context state
- */
-export declare function popContextState(gl: WebGL2RenderingContext): void;
-//# sourceMappingURL=track-context-state.d.ts.map

package/dist/context/state-tracker/track-context-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"track-context-state.d.ts","sourceRoot":"","sources":["../../../src/context/state-tracker/track-context-state.ts"],"names":[],"mappings":"AAkGA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,sBAAsB,EAC1B,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX,GACA,sBAAsB,CAgCxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI,CAOjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI,CAIhE"}

package/src/classic/copy-and-blit.ts

@@ -1,318 +0,0 @@
-// luma.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-
-import {Buffer, Texture, Framebuffer, FramebufferProps} from '@luma.gl/core';
-import {GL} from '@luma.gl/constants';
-
-import {WEBGLFramebuffer} from '../adapter/resources/webgl-framebuffer';
-import {getGLTypeFromTypedArray, getTypedArrayFromGLType} from './typed-array-utils';
-import {glFormatToComponents, glTypeToBytes} from './format-utils';
-import {WEBGLBuffer} from '../adapter/resources/webgl-buffer';
-import {WEBGLTexture} from '../adapter/resources/webgl-texture';
-
-/**
- * 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: Framebuffer | Texture,
-  options?: {
-    sourceX?: number;
-    sourceY?: number;
-    sourceFormat?: number;
-    sourceAttachment?: number;
-    target?: Uint8Array | Uint16Array | Float32Array;
-    // following parameters are auto deduced if not provided
-    sourceWidth?: number;
-    sourceHeight?: number;
-    sourceType?: number;
-  }
-): Uint8Array | Uint16Array | Float32Array {
-  const {
-    sourceX = 0,
-    sourceY = 0,
-    sourceFormat = GL.RGBA,
-    sourceAttachment = GL.COLOR_ATTACHMENT0 // 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 - GL.COLOR_ATTACHMENT0;
-  // assert(attachments[sourceAttachment]);
-
-  // Deduce the type from color attachment if not provided.
-  sourceType =
-    sourceType || framebuffer.colorAttachments[attachment]?.texture?.glType || GL.UNSIGNED_BYTE;
-
-  // 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(GL.FRAMEBUFFER, handle);
-  gl.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, target);
-  // @ts-expect-error
-  gl.bindFramebuffer(GL.FRAMEBUFFER, 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: Framebuffer | Texture,
-  options?: {
-    sourceX?: number;
-    sourceY?: number;
-    sourceFormat?: number;
-    target?: Buffer; // A new Buffer object is created when not provided.
-    targetByteOffset?: number; // byte offset in buffer object
-    // following parameters are auto deduced if not provided
-    sourceWidth?: number;
-    sourceHeight?: number;
-    sourceType?: number;
-  }
-): WEBGLBuffer {
-  const {
-    target,
-    sourceX = 0,
-    sourceY = 0,
-    sourceFormat = GL.RGBA,
-    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 || GL.UNSIGNED_BYTE;
-
-  let webglBufferTarget = target as unknown as WEBGLBuffer | undefined;
-  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 as Texture,
-    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: Framebuffer | Texture,
-  target: Texture | GL,
-  options?: {
-    sourceX?: number;
-    sourceY?: number;
-
-    targetX?: number;
-    targetY?: number;
-    targetZ?: number;
-    targetMipmaplevel?: number;
-    targetInternalFormat?: number;
-
-    width?: number; // defaults to target width
-    height?: number; // defaults to target height
-  }
-): Texture {
-  const {
-    sourceX = 0,
-    sourceY = 0,
-    // attachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer
-    targetMipmaplevel = 0,
-    targetInternalFormat = GL.RGBA
-  } = 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(GL.FRAMEBUFFER, handle);
-  // TODO - support gl.readBuffer (WebGL2 only)
-  // const prevBuffer = gl.readBuffer(attachment);
-  // assert(target);
-  let texture: WEBGLTexture | null = null;
-  let textureTarget: GL;
-  if (target instanceof WEBGLTexture) {
-    texture = target;
-    width = Number.isFinite(width) ? width : texture.width;
-    height = Number.isFinite(height) ? height : texture.height;
-    texture?.bind(0);
-    // @ts-ignore
-    textureTarget = texture.target;
-  } else {
-    // @ts-ignore
-    textureTarget = target;
-  }
-
-  if (!isSubCopy) {
-    device.gl.copyTexImage2D(
-      textureTarget,
-      targetMipmaplevel,
-      targetInternalFormat,
-      sourceX,
-      sourceY,
-      width,
-      height,
-      0 /* border must be 0 */
-    );
-  } else {
-    switch (textureTarget) {
-      case GL.TEXTURE_2D:
-      case GL.TEXTURE_CUBE_MAP:
-        device.gl.copyTexSubImage2D(
-          textureTarget,
-          targetMipmaplevel,
-          targetX,
-          targetY,
-          sourceX,
-          sourceY,
-          width,
-          height
-        );
-        break;
-      case GL.TEXTURE_2D_ARRAY:
-      case GL.TEXTURE_3D:
-        device.gl.copyTexSubImage3D(
-          textureTarget,
-          targetMipmaplevel,
-          targetX,
-          targetY,
-          targetZ,
-          sourceX,
-          sourceY,
-          width,
-          height
-        );
-        break;
-      default:
-    }
-  }
-  if (texture) {
-    texture.unbind();
-  }
-  // @ts-expect-error
-  device.gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);
-  if (deleteFramebuffer) {
-    framebuffer.destroy();
-  }
-  return texture;
-}
-
-function getFramebuffer(source: Texture | Framebuffer): {
-  framebuffer: WEBGLFramebuffer;
-  deleteFramebuffer: boolean;
-} {
-  if (!(source instanceof Framebuffer)) {
-    return {framebuffer: toFramebuffer(source), deleteFramebuffer: true};
-  }
-  return {framebuffer: source as WEBGLFramebuffer, 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: Texture, props?: FramebufferProps): WEBGLFramebuffer {
-  const {device, width, height, id} = texture;
-  const framebuffer = device.createFramebuffer({
-    ...props,
-    id: `framebuffer-for-${id}`,
-    width,
-    height,
-    colorAttachments: [texture]
-  });
-  return framebuffer as WEBGLFramebuffer;
-}
-
-function getPixelArray(
-  pixelArray,
-  type,
-  format,
-  width: number,
-  height: number
-): Uint8Array | Uint16Array | Float32Array {
-  if (pixelArray) {
-    return pixelArray;
-  }
-  // Allocate pixel array if not already available, using supplied type
-  type = type || GL.UNSIGNED_BYTE;
-  const ArrayType = getTypedArrayFromGLType(type, {clamped: false});
-  const components = glFormatToComponents(format);
-  // TODO - check for composite type (components = 1).
-  return new ArrayType(width * height * components) as Uint8Array | Uint16Array | Float32Array;
-}