@luma.gl/engine 9.2.6 → 9.3.0-alpha.2

package/dist/dynamic-texture/dynamic-texture.d.ts

@@ -0,0 +1,95 @@
+import type { TextureProps, SamplerProps, TextureView, Device } from '@luma.gl/core';
+import { Texture, Sampler } from '@luma.gl/core';
+import { type TextureCubeFace, type TextureDataAsyncProps, type Texture1DData, type Texture2DData, type Texture3DData, type TextureArrayData, type TextureCubeData } from "./texture-data.js";
+/**
+ * Properties for a dynamic texture
+ */
+export type DynamicTextureProps = Omit<TextureProps, 'data' | 'mipLevels' | 'width' | 'height'> & TextureDataAsyncProps & {
+    /** Generate mipmaps after creating textures and setting data */
+    mipmaps?: boolean;
+    /** nipLevels can be set to 'auto' to generate max number of mipLevels */
+    mipLevels?: number | 'auto';
+    /** Width - can be auto-calculated when initializing from ExternalImage */
+    width?: number;
+    /** Height - can be auto-calculated when initializing from ExternalImage */
+    height?: number;
+};
+/**
+ * Dynamic Textures
+ *
+ * - Mipmaps - DynamicTexture can generate mipmaps for textures (WebGPU does not provide built-in mipmap generation).
+ *
+ * - Texture initialization and updates - complex textures (2d array textures, cube textures, 3d textures) need multiple images
+ *   `DynamicTexture` provides an API that makes it easy to provide the required data.
+ *
+ * - Texture resizing - Textures are immutable in WebGPU, meaning that they cannot be resized after creation.
+ *   DynamicTexture provides a `resize()` method that internally creates a new texture with the same parameters
+ *   but a different size.
+ *
+ * - Async image data initialization - It is often very convenient to be able to initialize textures with promises
+ *   returned by image or data loading functions, as it allows a callback-free linear style of programming.
+ *
+ * @note GPU Textures are quite complex objects, with many subresources and modes of usage.
+ * The `DynamicTexture` class allows luma.gl to provide some support for working with textures
+ * without accumulating excessive complexity in the core Texture class which is designed as an immutable nature of GPU resource.
+ */
+export declare class DynamicTexture {
+    readonly device: Device;
+    readonly id: string;
+    /** Props with defaults resolved (except `data` which is processed separately) */
+    props: Readonly<Required<DynamicTextureProps>>;
+    /** Created resources */
+    private _texture;
+    private _sampler;
+    private _view;
+    /** Ready when GPU texture has been created and data (if any) uploaded */
+    readonly ready: Promise<Texture>;
+    isReady: boolean;
+    destroyed: boolean;
+    private resolveReady;
+    private rejectReady;
+    get texture(): Texture;
+    get sampler(): Sampler;
+    get view(): TextureView;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+    constructor(device: Device, props: DynamicTextureProps);
+    /** @note Fire and forget; caller can await `ready` */
+    initAsync(originalPropsWithAsyncData: TextureDataAsyncProps): Promise<void>;
+    destroy(): void;
+    generateMipmaps(): void;
+    /** Set sampler or create one from props */
+    setSampler(sampler?: Sampler | SamplerProps): void;
+    /**
+     * Resize by cloning the underlying immutable texture.
+     * Does not copy contents; caller may need to re-upload and/or regenerate mips.
+     */
+    resize(size: {
+        width: number;
+        height: number;
+    }): boolean;
+    /** Convert cube face label to texture slice index. Index can be used with `setTexture2DData()`. */
+    getCubeFaceIndex(face: TextureCubeFace): number;
+    /** Convert cube face label to texture slice index. Index can be used with `setTexture2DData()`. */
+    getCubeArrayFaceIndex(cubeIndex: number, face: TextureCubeFace): number;
+    /** @note experimental: Set multiple mip levels (1D) */
+    setTexture1DData(data: Texture1DData): void;
+    /** @note experimental: Set multiple mip levels (2D), optionally at `z`, slice (depth/array level) index */
+    setTexture2DData(lodData: Texture2DData, z?: number): void;
+    /** 3D: multiple depth slices, each may carry multiple mip levels */
+    setTexture3DData(data: Texture3DData): void;
+    /** 2D array: multiple layers, each may carry multiple mip levels */
+    setTextureArrayData(data: TextureArrayData): void;
+    /** Cube: 6 faces, each may carry multiple mip levels */
+    setTextureCubeData(data: TextureCubeData): void;
+    /** Cube array: multiple cubes (faces×layers), each face may carry multiple mips */
+    private setTextureCubeArrayData;
+    /** Sets multiple mip levels on different `z` slices (depth/array index) */
+    private _setTextureSubresources;
+    /** Recursively resolve all promises in data structures */
+    private _loadAllData;
+    private _checkNotDestroyed;
+    private _checkReady;
+    static defaultProps: Required<DynamicTextureProps>;
+}
+//# sourceMappingURL=dynamic-texture.d.ts.map

package/dist/dynamic-texture/dynamic-texture.d.ts.map

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

package/dist/dynamic-texture/dynamic-texture.js

@@ -0,0 +1,356 @@
+// luma.gl, MIT license
+// Copyright (c) vis.gl contributors
+import { Texture, Sampler, log } from '@luma.gl/core';
+// import {loadImageBitmap} from '../application-utils/load-file';
+import { uid } from "../utils/uid.js";
+import { TEXTURE_CUBE_FACE_MAP, 
+// Helpers
+getTextureSizeFromData, getTexture1DSubresources, getTexture2DSubresources, getTexture3DSubresources, getTextureCubeSubresources, getTextureArraySubresources, getTextureCubeArraySubresources } from "./texture-data.js";
+/**
+ * Dynamic Textures
+ *
+ * - Mipmaps - DynamicTexture can generate mipmaps for textures (WebGPU does not provide built-in mipmap generation).
+ *
+ * - Texture initialization and updates - complex textures (2d array textures, cube textures, 3d textures) need multiple images
+ *   `DynamicTexture` provides an API that makes it easy to provide the required data.
+ *
+ * - Texture resizing - Textures are immutable in WebGPU, meaning that they cannot be resized after creation.
+ *   DynamicTexture provides a `resize()` method that internally creates a new texture with the same parameters
+ *   but a different size.
+ *
+ * - Async image data initialization - It is often very convenient to be able to initialize textures with promises
+ *   returned by image or data loading functions, as it allows a callback-free linear style of programming.
+ *
+ * @note GPU Textures are quite complex objects, with many subresources and modes of usage.
+ * The `DynamicTexture` class allows luma.gl to provide some support for working with textures
+ * without accumulating excessive complexity in the core Texture class which is designed as an immutable nature of GPU resource.
+ */
+export class DynamicTexture {
+    device;
+    id;
+    /** Props with defaults resolved (except `data` which is processed separately) */
+    props;
+    /** Created resources */
+    _texture = null;
+    _sampler = null;
+    _view = null;
+    /** Ready when GPU texture has been created and data (if any) uploaded */
+    ready;
+    isReady = false;
+    destroyed = false;
+    resolveReady = () => { };
+    rejectReady = () => { };
+    get texture() {
+        if (!this._texture)
+            throw new Error('Texture not initialized yet');
+        return this._texture;
+    }
+    get sampler() {
+        if (!this._sampler)
+            throw new Error('Sampler not initialized yet');
+        return this._sampler;
+    }
+    get view() {
+        if (!this._view)
+            throw new Error('View not initialized yet');
+        return this._view;
+    }
+    get [Symbol.toStringTag]() {
+        return 'DynamicTexture';
+    }
+    toString() {
+        return `DynamicTexture:"${this.id}":${this.texture.width}x${this.texture.height}px:(${this.isReady ? 'ready' : 'loading...'})`;
+    }
+    constructor(device, props) {
+        this.device = device;
+        const id = uid('dynamic-texture');
+        // NOTE: We avoid holding on to data to make sure it can be garbage collected.
+        const originalPropsWithAsyncData = props;
+        this.props = { ...DynamicTexture.defaultProps, id, ...props, data: null };
+        this.id = this.props.id;
+        this.ready = new Promise((resolve, reject) => {
+            this.resolveReady = resolve;
+            this.rejectReady = reject;
+        });
+        this.initAsync(originalPropsWithAsyncData);
+    }
+    /** @note Fire and forget; caller can await `ready` */
+    async initAsync(originalPropsWithAsyncData) {
+        try {
+            // TODO - Accept URL string for 2D: turn into ExternalImage promise
+            // const dataProps =
+            //   typeof props.data === 'string' && (props.dimension ?? '2d') === '2d'
+            //     ? ({dimension: '2d', data: loadImageBitmap(props.data)} as const)
+            //     : {};
+            const propsWithSyncData = await this._loadAllData(originalPropsWithAsyncData);
+            this._checkNotDestroyed();
+            // Deduce size when not explicitly provided
+            // TODO - what about depth?
+            const deduceSize = () => {
+                if (this.props.width && this.props.height) {
+                    return { width: this.props.width, height: this.props.height };
+                }
+                const size = getTextureSizeFromData(propsWithSyncData);
+                if (size) {
+                    return size;
+                }
+                return { width: this.props.width || 1, height: this.props.height || 1 };
+            };
+            const size = deduceSize();
+            if (!size || size.width <= 0 || size.height <= 0) {
+                throw new Error(`${this} size could not be determined or was zero`);
+            }
+            // Create a minimal TextureProps and validate via `satisfies`
+            const baseTextureProps = {
+                ...this.props,
+                ...size,
+                mipLevels: 1, // temporary; updated below
+                data: undefined
+            };
+            // Compute mip levels (auto clamps to max)
+            const maxMips = this.device.getMipLevelCount(baseTextureProps.width, baseTextureProps.height);
+            const desired = this.props.mipLevels === 'auto'
+                ? maxMips
+                : Math.max(1, Math.min(maxMips, this.props.mipLevels ?? 1));
+            const finalTextureProps = { ...baseTextureProps, mipLevels: desired };
+            this._texture = this.device.createTexture(finalTextureProps);
+            this._sampler = this.texture.sampler;
+            this._view = this.texture.view;
+            // Upload data if provided
+            if (propsWithSyncData.data) {
+                switch (propsWithSyncData.dimension) {
+                    case '1d':
+                        this.setTexture1DData(propsWithSyncData.data);
+                        break;
+                    case '2d':
+                        this.setTexture2DData(propsWithSyncData.data);
+                        break;
+                    case '3d':
+                        this.setTexture3DData(propsWithSyncData.data);
+                        break;
+                    case '2d-array':
+                        this.setTextureArrayData(propsWithSyncData.data);
+                        break;
+                    case 'cube':
+                        this.setTextureCubeData(propsWithSyncData.data);
+                        break;
+                    case 'cube-array':
+                        this.setTextureCubeArrayData(propsWithSyncData.data);
+                        break;
+                    default: {
+                        throw new Error(`Unhandled dimension ${propsWithSyncData.dimension}`);
+                    }
+                }
+            }
+            if (this.props.mipmaps) {
+                this.generateMipmaps();
+            }
+            this.isReady = true;
+            this.resolveReady(this.texture);
+            log.info(0, `${this} created`)();
+        }
+        catch (e) {
+            const err = e instanceof Error ? e : new Error(String(e));
+            this.rejectReady(err);
+            throw err;
+        }
+    }
+    destroy() {
+        if (this._texture) {
+            this._texture.destroy();
+            this._texture = null;
+            this._sampler = null;
+            this._view = null;
+        }
+        this.destroyed = true;
+    }
+    generateMipmaps() {
+        // Call the WebGL-style mipmap generation helper
+        // WebGL implementation generates mipmaps, WebGPU logs a warning
+        if (this.device.type === 'webgl') {
+            this.texture.generateMipmapsWebGL();
+        }
+        else {
+            log.warn('Mipmap generation not yet implemented on WebGPU: your texture data will not be correctly initialized');
+        }
+    }
+    /** Set sampler or create one from props */
+    setSampler(sampler = {}) {
+        this._checkReady();
+        const s = sampler instanceof Sampler ? sampler : this.device.createSampler(sampler);
+        this.texture.setSampler(s);
+        this._sampler = s;
+    }
+    /**
+     * Resize by cloning the underlying immutable texture.
+     * Does not copy contents; caller may need to re-upload and/or regenerate mips.
+     */
+    resize(size) {
+        this._checkReady();
+        if (size.width === this.texture.width && size.height === this.texture.height) {
+            return false;
+        }
+        const prev = this.texture;
+        this._texture = prev.clone(size);
+        this._sampler = this.texture.sampler;
+        this._view = this.texture.view;
+        prev.destroy();
+        log.info(`${this} resized`);
+        return true;
+    }
+    /** Convert cube face label to texture slice index. Index can be used with `setTexture2DData()`. */
+    getCubeFaceIndex(face) {
+        const index = TEXTURE_CUBE_FACE_MAP[face];
+        if (index === undefined)
+            throw new Error(`Invalid cube face: ${face}`);
+        return index;
+    }
+    /** Convert cube face label to texture slice index. Index can be used with `setTexture2DData()`. */
+    getCubeArrayFaceIndex(cubeIndex, face) {
+        return 6 * cubeIndex + this.getCubeFaceIndex(face);
+    }
+    /** @note experimental: Set multiple mip levels (1D) */
+    setTexture1DData(data) {
+        this._checkReady();
+        if (this.texture.props.dimension !== '1d') {
+            throw new Error(`${this} is not 1d`);
+        }
+        const subresources = getTexture1DSubresources(data);
+        this._setTextureSubresources(subresources);
+    }
+    /** @note experimental: Set multiple mip levels (2D), optionally at `z`, slice (depth/array level) index */
+    setTexture2DData(lodData, z = 0) {
+        this._checkReady();
+        if (this.texture.props.dimension !== '2d') {
+            throw new Error(`${this} is not 2d`);
+        }
+        const subresources = getTexture2DSubresources(z, lodData);
+        this._setTextureSubresources(subresources);
+    }
+    /** 3D: multiple depth slices, each may carry multiple mip levels */
+    setTexture3DData(data) {
+        if (this.texture.props.dimension !== '3d') {
+            throw new Error(`${this} is not 3d`);
+        }
+        const subresources = getTexture3DSubresources(data);
+        this._setTextureSubresources(subresources);
+    }
+    /** 2D array: multiple layers, each may carry multiple mip levels */
+    setTextureArrayData(data) {
+        if (this.texture.props.dimension !== '2d-array') {
+            throw new Error(`${this} is not 2d-array`);
+        }
+        const subresources = getTextureArraySubresources(data);
+        this._setTextureSubresources(subresources);
+    }
+    /** Cube: 6 faces, each may carry multiple mip levels */
+    setTextureCubeData(data) {
+        if (this.texture.props.dimension !== 'cube') {
+            throw new Error(`${this} is not cube`);
+        }
+        const subresources = getTextureCubeSubresources(data);
+        this._setTextureSubresources(subresources);
+    }
+    /** Cube array: multiple cubes (faces×layers), each face may carry multiple mips */
+    setTextureCubeArrayData(data) {
+        if (this.texture.props.dimension !== 'cube-array') {
+            throw new Error(`${this} is not cube-array`);
+        }
+        const subresources = getTextureCubeArraySubresources(data);
+        this._setTextureSubresources(subresources);
+    }
+    /** Sets multiple mip levels on different `z` slices (depth/array index) */
+    _setTextureSubresources(subresources) {
+        // If user supplied multiple mip levels, warn if auto-mips also requested
+        // if (lodArray.length > 1 && this.props.mipmaps !== false) {
+        //   log.warn(
+        //     `Texture ${this.id}: provided multiple LODs and also requested mipmap generation.`
+        //   )();
+        // }
+        for (const subresource of subresources) {
+            const { z, mipLevel } = subresource;
+            switch (subresource.type) {
+                case 'external-image':
+                    const { image, flipY } = subresource;
+                    this.texture.copyExternalImage({ image, z, mipLevel, flipY });
+                    break;
+                case 'texture-data':
+                    const { data } = subresource;
+                    // TODO - we are throwing away some of the info in data.
+                    // Did we not need it in the first place? Can we use it to validate?
+                    this.texture.copyImageData({ data: data.data, z, mipLevel });
+                    break;
+                default:
+                    throw new Error('Unsupported 2D mip-level payload');
+            }
+        }
+    }
+    // ------------------ helpers ------------------
+    /** Recursively resolve all promises in data structures */
+    async _loadAllData(props) {
+        const syncData = await awaitAllPromises(props.data);
+        const dimension = (props.dimension ?? '2d');
+        return { dimension, data: syncData ?? null };
+    }
+    _checkNotDestroyed() {
+        if (this.destroyed) {
+            log.warn(`${this} already destroyed`);
+        }
+    }
+    _checkReady() {
+        if (!this.isReady) {
+            log.warn(`${this} Cannot perform this operation before ready`);
+        }
+    }
+    static defaultProps = {
+        ...Texture.defaultProps,
+        dimension: '2d',
+        data: null,
+        mipmaps: false
+    };
+}
+// HELPERS
+/** Resolve all promises in a nested data structure */
+async function awaitAllPromises(x) {
+    x = await x;
+    if (Array.isArray(x)) {
+        return await Promise.all(x.map(awaitAllPromises));
+    }
+    if (x && typeof x === 'object' && x.constructor === Object) {
+        const object = x;
+        const values = await Promise.all(Object.values(object));
+        const keys = Object.keys(object);
+        const resolvedObject = {};
+        for (let i = 0; i < keys.length; i++) {
+            resolvedObject[keys[i]] = values[i];
+        }
+        return resolvedObject;
+    }
+    return x;
+}
+// /** @note experimental: Set multiple mip levels (2D), optionally at `z`, slice (depth/array level) index */
+// setTexture2DData(lodData: Texture2DData, z: number = 0): void {
+//   this._checkReady();
+//   const lodArray = this._normalizeTexture2DData(lodData);
+//   // If user supplied multiple mip levels, warn if auto-mips also requested
+//   if (lodArray.length > 1 && this.props.mipmaps !== false) {
+//     log.warn(
+//       `Texture ${this.id}: provided multiple LODs and also requested mipmap generation.`
+//     )();
+//   }
+//   for (let mipLevel = 0; mipLevel < lodArray.length; mipLevel++) {
+//     const imageData = lodArray[mipLevel];
+//     if (this.device.isExternalImage(imageData)) {
+//       this.texture.copyExternalImage({image: imageData, z, mipLevel, flipY: true});
+//     } else if (this._isTextureImageData(imageData)) {
+//       this.texture.copyImageData({data: imageData.data, z, mipLevel});
+//     } else {
+//       throw new Error('Unsupported 2D mip-level payload');
+//     }
+//   }
+// }
+// /** Normalize 2D layer payload into an array of mip-level items */
+// private _normalizeTexture2DData(data: Texture2DData): (TextureImageData | ExternalImage)[] {
+//   return Array.isArray(data) ? data : [data];
+// }
+//# sourceMappingURL=dynamic-texture.js.map

package/dist/dynamic-texture/dynamic-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-texture.js","sourceRoot":"","sources":["../../src/dynamic-texture/dynamic-texture.ts"],"names":[],"mappings":"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"}

package/dist/dynamic-texture/texture-data.d.ts

@@ -0,0 +1,137 @@
+import type { TypedArray, TextureFormat, ExternalImage } from '@luma.gl/core';
+export type TextureImageSource = ExternalImage;
+/**
+ * One mip level
+ * Basic data structure is similar to `ImageData`
+ * additional optional fields can describe compressed texture data.
+ */
+export type TextureImageData = {
+    /** WebGPU style format string. Defaults to 'rgba8unorm' */
+    format?: TextureFormat;
+    /** Typed Array with the bytes of the image. @note beware row byte alignment requirements */
+    data: TypedArray;
+    /** Width of the image, in pixels, @note beware row byte alignment requirements */
+    width: number;
+    /** Height of the image, in rows */
+    height: number;
+};
+/**
+ * A single mip-level can be initialized by data or an ImageBitmap etc
+ * @note in the WebGPU spec a mip-level is called a subresource
+ */
+export type TextureMipLevelData = TextureImageData | TextureImageSource;
+/**
+ * Texture data for one image "slice" (which can consist of multiple miplevels)
+ * Thus data for one slice be a single mip level or an array of miplevels
+ * @note in the WebGPU spec each cross-section image in a 3D texture is called a "slice",
+ * in a array texture each image in the array is called an array "layer"
+ * luma.gl calls one image in a GPU texture a "slice" regardless of context.
+ */
+export type TextureSliceData = TextureMipLevelData | TextureMipLevelData[];
+/** Names of cube texture faces */
+export type TextureCubeFace = '+X' | '-X' | '+Y' | '-Y' | '+Z' | '-Z';
+/** Array of cube texture faces. @note: index in array is the face index */
+export declare const TEXTURE_CUBE_FACES: readonly ["+X", "-X", "+Y", "-Y", "+Z", "-Z"];
+/** Map of cube texture face names to face indexes */
+export declare const TEXTURE_CUBE_FACE_MAP: {
+    readonly '+X': 0;
+    readonly '-X': 1;
+    readonly '+Y': 2;
+    readonly '-Y': 3;
+    readonly '+Z': 4;
+    readonly '-Z': 5;
+};
+/** @todo - Define what data type is supported for 1D textures. TextureImageData with height = 1 */
+export type Texture1DData = TextureSliceData;
+/** Texture data can be one or more mip levels */
+export type Texture2DData = TextureSliceData;
+/** 6 face textures */
+export type TextureCubeData = Record<TextureCubeFace, TextureSliceData>;
+/** Array of textures */
+export type Texture3DData = TextureSliceData[];
+/** Array of textures */
+export type TextureArrayData = TextureSliceData[];
+/** Array of 6 face textures */
+export type TextureCubeArrayData = Record<TextureCubeFace, TextureSliceData>[];
+type TextureData = Texture1DData | Texture3DData | TextureArrayData | TextureCubeArrayData | TextureCubeData;
+/** Sync data props */
+export type TextureDataProps = {
+    dimension: '1d';
+    data: Texture1DData | null;
+} | {
+    dimension?: '2d';
+    data: Texture2DData | null;
+} | {
+    dimension: '3d';
+    data: Texture3DData | null;
+} | {
+    dimension: '2d-array';
+    data: TextureArrayData | null;
+} | {
+    dimension: 'cube';
+    data: TextureCubeData | null;
+} | {
+    dimension: 'cube-array';
+    data: TextureCubeArrayData | null;
+};
+/** Async data props */
+export type TextureDataAsyncProps = {
+    dimension: '1d';
+    data?: Promise<Texture1DData> | Texture1DData | null;
+} | {
+    dimension?: '2d';
+    data?: Promise<Texture2DData> | Texture2DData | null;
+} | {
+    dimension: '3d';
+    data?: Promise<Texture3DData> | Texture3DData | null;
+} | {
+    dimension: '2d-array';
+    data?: Promise<TextureArrayData> | TextureArrayData | null;
+} | {
+    dimension: 'cube';
+    data?: Promise<TextureCubeData> | TextureCubeData | null;
+} | {
+    dimension: 'cube-array';
+    data?: Promise<TextureCubeArrayData> | TextureCubeArrayData | null;
+};
+/** Describes data for one sub resource (one mip level of one slice (depth or array layer)) */
+export type TextureSubresource = {
+    /** slice (depth or array layer)) */
+    z: number;
+    /** mip level (0 - max mip levels) */
+    mipLevel: number;
+} & ({
+    type: 'external-image';
+    image: ExternalImage;
+    /** @deprecated is this an appropriate place for this flag? */
+    flipY?: boolean;
+} | {
+    type: 'texture-data';
+    data: TextureImageData;
+});
+/** Check if texture data is a typed array */
+export declare function isTextureSliceData(data: TextureData): data is TextureImageData;
+export declare function getFirstMipLevel(layer: TextureSliceData | null): TextureMipLevelData | null;
+export declare function getTextureSizeFromData(props: TextureDataProps): {
+    width: number;
+    height: number;
+} | null;
+/** Resolve size for a single mip-level datum */
+/** Convert cube face label to depth index */
+export declare function getCubeFaceIndex(face: TextureCubeFace): number;
+/** Convert cube face label to texture slice index. Index can be used with `setTexture2DData()`. */
+export declare function getCubeArrayFaceIndex(cubeIndex: number, face: TextureCubeFace): number;
+/** Experimental: Set multiple mip levels (1D) */
+export declare function getTexture1DSubresources(data: Texture1DData): TextureSubresource[];
+/** Experimental: Set multiple mip levels (2D), optionally at `z` (depth/array index) */
+export declare function getTexture2DSubresources(slice: number, lodData: Texture2DData): TextureSubresource[];
+/** 3D: multiple depth slices, each may carry multiple mip levels */
+export declare function getTexture3DSubresources(data: Texture3DData): TextureSubresource[];
+/** 2D array: multiple layers, each may carry multiple mip levels */
+export declare function getTextureArraySubresources(data: TextureArrayData): TextureSubresource[];
+/** Cube: 6 faces, each may carry multiple mip levels */
+export declare function getTextureCubeSubresources(data: TextureCubeData): TextureSubresource[];
+/** Cube array: multiple cubes (faces×layers), each face may carry multiple mips */
+export declare function getTextureCubeArraySubresources(data: TextureCubeArrayData): TextureSubresource[];
+export {};
+//# sourceMappingURL=texture-data.d.ts.map

package/dist/dynamic-texture/texture-data.d.ts.map

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