@solidtv/renderer 1.0.0

package/dist/src/core/textures/ImageTexture.d.ts

@@ -0,0 +1,131 @@
+import type { CoreTextureManager } from '../CoreTextureManager.js';
+import { Texture, TextureType, type TextureData } from './Texture.js';
+/**
+ * Properties of the {@link ImageTexture}
+ */
+export interface ImageTextureProps {
+    /**
+     * Source URL or ImageData for the image to be used as a texture.
+     *
+     * @remarks
+     * The ImageData type is currently only supported internally. End users should
+     * only set this property to a URL string.
+     *
+     * @default ''
+     */
+    src?: string | Blob | ImageData | (() => ImageData | null);
+    /**
+     * Whether to premultiply the alpha channel into the color channels of the
+     * image.
+     *
+     * @remarks
+     * Generally this should be set to `true` (the default). However, if the
+     * texture's associated Shader expects straight (non-premultiplied) colors,
+     * this should be set to `false`.
+     *
+     * @default true
+     */
+    premultiplyAlpha?: boolean | null;
+    /**
+     * `ImageData` textures are not cached unless a `key` is provided
+     */
+    key?: string | null;
+    /**
+     * Width of the image to be used as a texture. If not provided, the image's
+     * natural width will be used.
+     */
+    w?: number | null;
+    /**
+     * Height of the image to be used as a texture. If not provided, the image's
+     * natural height will be used.
+     */
+    h?: number | null;
+    /**
+     * Type, indicate an image type for overriding type detection
+     *
+     * @default null
+     */
+    type?: 'regular' | 'compressed' | 'svg' | null;
+    /**
+     * The width of the rectangle from which the ImageBitmap will be extracted. This value
+     * can be negative. Only works when createImageBitmap is supported on the browser.
+     *
+     * @default null
+     */
+    sw?: number | null;
+    /**
+     * The height of the rectangle from which the ImageBitmap will be extracted. This value
+     * can be negative. Only works when createImageBitmap is supported on the browser.
+     *
+     * @default null
+     */
+    sh?: number | null;
+    /**
+     * The y coordinate of the reference point of the rectangle from which the ImageBitmap
+     * will be extracted. Only used when `sw` and `sh` are provided. And only works when
+     * createImageBitmap is available.
+     *
+     * @default null
+     */
+    sx?: number | null;
+    /**
+     * The x coordinate of the reference point of the rectangle from which the
+     * ImageBitmap will be extracted. Only used when source `sw` width and `sh` height
+     * are provided. Only works when createImageBitmap is supported on the browser.
+     *
+     * @default null
+     */
+    sy?: number | null;
+    /**
+     * Maximum number of times to retry loading the image if it fails.
+     *
+     * @default 5
+     */
+    maxRetryCount?: number;
+}
+/**
+ * Texture consisting of an image loaded from a URL
+ *
+ * @remarks
+ * The ImageTexture's {@link ImageTextureProps.src} prop defines the image URL
+ * to be downloaded.
+ *
+ * By default, the texture's alpha values will be premultiplied into its color
+ * values which is generally the desired setting before they are sent to the
+ * texture's associated {@link Shader}. However, in special cases you may want
+ * the Shader to receive straight (non-premultiplied) values. In that case you
+ * can disable the default behavior by setting the
+ * {@link ImageTextureProps.premultiplyAlpha} prop to `false`.
+ */
+export declare class ImageTexture extends Texture {
+    private platform;
+    props: Required<ImageTextureProps>;
+    type: TextureType;
+    constructor(txManager: CoreTextureManager, props: Required<ImageTextureProps>);
+    hasAlphaChannel(mimeType: string): boolean;
+    loadImageFallback(src: string | Blob, hasAlpha: boolean): Promise<{
+        data: HTMLImageElement | null;
+        premultiplyAlpha: boolean;
+    }>;
+    createImageBitmap(blob: Blob, premultiplyAlpha: boolean | null, sx: number | null, sy: number | null, sw: number | null, sh: number | null): Promise<{
+        data: ImageBitmap | HTMLImageElement;
+        premultiplyAlpha: boolean;
+    }>;
+    loadImage(src: string): Promise<TextureData>;
+    getTextureSource(): Promise<TextureData>;
+    determineImageTypeAndLoadImage(): Promise<TextureData> | {
+        data: null;
+        premultiplyAlpha?: undefined;
+    } | {
+        data: ImageData | null;
+        premultiplyAlpha: boolean | null;
+    };
+    /**
+     * Generates a cache key for the ImageTexture based on the provided props.
+     * @param props - The props used to generate the cache key.
+     * @returns The cache key as a string, or `false` if the key cannot be generated.
+     */
+    static makeCacheKey(props: ImageTextureProps): string | false;
+    static resolveDefaults(props: ImageTextureProps): Required<ImageTextureProps>;
+    static z$__type__Props: ImageTextureProps;
+}

package/dist/src/core/textures/ImageTexture.js

@@ -0,0 +1,211 @@
+import { Texture, TextureType } from './Texture.js';
+import { isCompressedTextureContainer, loadCompressedTexture, } from '../lib/textureCompression.js';
+import { convertUrlToAbsolute, dataURIToBlob, isBase64Image, } from '../lib/utils.js';
+import { isSvgImage, loadSvg } from '../lib/textureSvg.js';
+import { fetchJson } from '../lib/utils.js';
+import { ENABLE_COMPRESSED_TEXTURES, isProductionEnvironment, } from '../../utils.js';
+/**
+ * Texture consisting of an image loaded from a URL
+ *
+ * @remarks
+ * The ImageTexture's {@link ImageTextureProps.src} prop defines the image URL
+ * to be downloaded.
+ *
+ * By default, the texture's alpha values will be premultiplied into its color
+ * values which is generally the desired setting before they are sent to the
+ * texture's associated {@link Shader}. However, in special cases you may want
+ * the Shader to receive straight (non-premultiplied) values. In that case you
+ * can disable the default behavior by setting the
+ * {@link ImageTextureProps.premultiplyAlpha} prop to `false`.
+ */
+export class ImageTexture extends Texture {
+    platform;
+    props;
+    type = TextureType.image;
+    constructor(txManager, props) {
+        super(txManager);
+        this.platform = txManager.platform;
+        this.props = props;
+        this.maxRetryCount = props.maxRetryCount;
+    }
+    hasAlphaChannel(mimeType) {
+        return mimeType.indexOf('image/png') !== -1;
+    }
+    async loadImageFallback(src, hasAlpha) {
+        const img = new Image();
+        if (typeof src === 'string' && isBase64Image(src) === false) {
+            img.crossOrigin = 'anonymous';
+        }
+        return new Promise((resolve, reject) => {
+            img.onload = () => {
+                resolve({ data: img, premultiplyAlpha: hasAlpha });
+            };
+            img.onerror = (err) => {
+                const errorMessage = err instanceof Error
+                    ? err.message
+                    : err instanceof Event
+                        ? `Image loading failed for ${img.src}`
+                        : 'Unknown image loading error';
+                reject(new Error(`Image loading failed: ${errorMessage}`));
+            };
+            if (src instanceof Blob) {
+                img.src = URL.createObjectURL(src);
+            }
+            else {
+                img.src = src;
+            }
+        });
+    }
+    async createImageBitmap(blob, premultiplyAlpha, sx, sy, sw, sh) {
+        const hasAlphaChannel = premultiplyAlpha ?? blob.type.includes('image/png');
+        const imageBitmapSupported = this.txManager.imageBitmapSupported;
+        if (imageBitmapSupported.full === true && sw !== null && sh !== null) {
+            // createImageBitmap with crop
+            const bitmap = await this.platform.createImageBitmap(blob, sx || 0, sy || 0, sw, sh, {
+                premultiplyAlpha: hasAlphaChannel ? 'premultiply' : 'none',
+                colorSpaceConversion: 'none',
+                imageOrientation: 'none',
+            });
+            return { data: bitmap, premultiplyAlpha: hasAlphaChannel };
+        }
+        else if (imageBitmapSupported.basic === true) {
+            // basic createImageBitmap without options or crop
+            // this is supported for Chrome v50 to v52/54 that doesn't support options
+            return {
+                data: await this.platform.createImageBitmap(blob),
+                premultiplyAlpha: hasAlphaChannel,
+            };
+        }
+        // default createImageBitmap without crop but with options
+        const bitmap = await this.platform.createImageBitmap(blob, {
+            premultiplyAlpha: hasAlphaChannel ? 'premultiply' : 'none',
+            colorSpaceConversion: 'none',
+            imageOrientation: 'none',
+        });
+        return { data: bitmap, premultiplyAlpha: hasAlphaChannel };
+    }
+    async loadImage(src) {
+        const { premultiplyAlpha, sx, sy, sw, sh } = this.props;
+        if (this.txManager.hasCreateImageBitmap === true) {
+            if (isBase64Image(src) === false &&
+                this.txManager.hasWorker === true &&
+                this.txManager.imageWorkerManager !== null) {
+                return this.txManager.imageWorkerManager.getImage(src, premultiplyAlpha, sx, sy, sw, sh);
+            }
+            let blob;
+            if (isBase64Image(src) === true) {
+                blob = dataURIToBlob(src);
+            }
+            else {
+                blob = await fetchJson(src, 'blob').then((response) => response);
+            }
+            return this.createImageBitmap(blob, premultiplyAlpha, sx, sy, sw, sh);
+        }
+        return this.loadImageFallback(src, premultiplyAlpha ?? true);
+    }
+    async getTextureSource() {
+        let resp;
+        try {
+            resp = await this.determineImageTypeAndLoadImage();
+        }
+        catch (e) {
+            this.setState('failed', e);
+            return {
+                data: null,
+            };
+        }
+        if (resp.data === null) {
+            this.setState('failed', Error('ImageTexture: No image data'));
+            return {
+                data: null,
+            };
+        }
+        return {
+            data: resp.data,
+            premultiplyAlpha: this.props.premultiplyAlpha ?? true,
+        };
+    }
+    determineImageTypeAndLoadImage() {
+        const { src, premultiplyAlpha, type } = this.props;
+        if (src === null) {
+            return {
+                data: null,
+            };
+        }
+        if (typeof src !== 'string') {
+            if (src instanceof Blob) {
+                if (this.txManager.hasCreateImageBitmap === true) {
+                    const { sx, sy, sw, sh } = this.props;
+                    return this.createImageBitmap(src, premultiplyAlpha, sx, sy, sw, sh);
+                }
+                else {
+                    return this.loadImageFallback(src, premultiplyAlpha ?? true);
+                }
+            }
+            if (src instanceof ImageData) {
+                return {
+                    data: src,
+                    premultiplyAlpha,
+                };
+            }
+            return {
+                data: src(),
+                premultiplyAlpha,
+            };
+        }
+        const absoluteSrc = convertUrlToAbsolute(src);
+        if (type === 'regular') {
+            return this.loadImage(absoluteSrc);
+        }
+        if (type === 'svg') {
+            return loadSvg(absoluteSrc, this.props.w, this.props.h, this.props.sx, this.props.sy, this.props.sw, this.props.sh);
+        }
+        if (isSvgImage(src) === true) {
+            return loadSvg(absoluteSrc, this.props.w, this.props.h, this.props.sx, this.props.sy, this.props.sw, this.props.sh);
+        }
+        if (ENABLE_COMPRESSED_TEXTURES &&
+            (type === 'compressed' || isCompressedTextureContainer(src) === true)) {
+            return loadCompressedTexture(absoluteSrc);
+        }
+        // default
+        return this.loadImage(absoluteSrc);
+    }
+    /**
+     * Generates a cache key for the ImageTexture based on the provided props.
+     * @param props - The props used to generate the cache key.
+     * @returns The cache key as a string, or `false` if the key cannot be generated.
+     */
+    static makeCacheKey(props) {
+        // Only cache key-able textures; prioritise key
+        const key = props.key || props.src;
+        if (typeof key !== 'string') {
+            return false;
+        }
+        let cacheKey = `ImageTexture,${key},${props.premultiplyAlpha ?? 'true'},${props.maxRetryCount}`;
+        if (props.sh !== null && props.sw !== null) {
+            cacheKey += ',';
+            cacheKey += props.sx ?? '';
+            cacheKey += props.sy ?? '';
+            cacheKey += props.sw || '';
+            cacheKey += props.sh || '';
+        }
+        return cacheKey;
+    }
+    static resolveDefaults(props) {
+        return {
+            src: props.src ?? '',
+            premultiplyAlpha: props.premultiplyAlpha ?? true, // null,
+            key: props.key ?? null,
+            type: props.type ?? null,
+            w: props.w ?? null,
+            h: props.h ?? null,
+            sx: props.sx ?? null,
+            sy: props.sy ?? null,
+            sw: props.sw ?? null,
+            sh: props.sh ?? null,
+            maxRetryCount: props.maxRetryCount ?? 5,
+        };
+    }
+    static z$__type__Props;
+}
+//# sourceMappingURL=ImageTexture.js.map

package/dist/src/core/textures/ImageTexture.js.map

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

package/dist/src/core/textures/NoiseTexture.d.ts

@@ -0,0 +1,43 @@
+import type { CoreTextureManager } from '../CoreTextureManager.js';
+import { Texture, TextureType, type TextureData } from './Texture.js';
+/**
+ * Properties of the {@link NoiseTexture}
+ */
+export interface NoiseTextureProps {
+    /**
+     * Width of texture
+     *
+     * @default 128
+     */
+    w?: number;
+    /**
+     * Height of texture
+     *
+     * @default 128
+     */
+    h?: number;
+    /**
+     * A number value that can be varied to force new textures to be generated
+     *
+     * @default 0
+     */
+    cacheId?: number;
+}
+/**
+ * Texture consisting of a random grid of greyscale pixels
+ *
+ * @remarks
+ * The width and height of the NoiseTexture are defined by it's
+ * {@link NoiseTextureProps.width} and {@link NoiseTextureProps.height}
+ * properties. The {@link NoiseTextureProps.cacheId} prop can be varied in order
+ * to bypass cache and get newly randomized texture data.
+ */
+export declare class NoiseTexture extends Texture {
+    props: Required<NoiseTextureProps>;
+    type: TextureType;
+    constructor(txManager: CoreTextureManager, props: Required<NoiseTextureProps>);
+    getTextureSource(): Promise<TextureData>;
+    static makeCacheKey(props: NoiseTextureProps): string | false;
+    static resolveDefaults(props: NoiseTextureProps): Required<NoiseTextureProps>;
+    static z$__type__Props: NoiseTextureProps;
+}

package/dist/src/core/textures/NoiseTexture.js

@@ -0,0 +1,50 @@
+import { Texture, TextureType } from './Texture.js';
+/**
+ * Texture consisting of a random grid of greyscale pixels
+ *
+ * @remarks
+ * The width and height of the NoiseTexture are defined by it's
+ * {@link NoiseTextureProps.width} and {@link NoiseTextureProps.height}
+ * properties. The {@link NoiseTextureProps.cacheId} prop can be varied in order
+ * to bypass cache and get newly randomized texture data.
+ */
+export class NoiseTexture extends Texture {
+    props;
+    type = TextureType.noise;
+    constructor(txManager, props) {
+        super(txManager);
+        this.props = props;
+    }
+    async getTextureSource() {
+        const { w, h } = this.props;
+        const size = w * h * 4;
+        const pixelData8 = new Uint8ClampedArray(size);
+        for (let i = 0; i < size; i += 4) {
+            const v = Math.floor(Math.random() * 256);
+            pixelData8[i] = v;
+            pixelData8[i + 1] = v;
+            pixelData8[i + 2] = v;
+            pixelData8[i + 3] = 255;
+        }
+        // Noise Texture data ready - dimensions will be set during upload
+        return {
+            data: new ImageData(pixelData8, w, h),
+        };
+    }
+    static makeCacheKey(props) {
+        if (props.cacheId === undefined) {
+            return false;
+        }
+        const resolvedProps = NoiseTexture.resolveDefaults(props);
+        return `NoiseTexture,${resolvedProps.w},${resolvedProps.h},${resolvedProps.cacheId}`;
+    }
+    static resolveDefaults(props) {
+        return {
+            w: props.w ?? 128,
+            h: props.h ?? 128,
+            cacheId: props.cacheId ?? 0,
+        };
+    }
+    static z$__type__Props;
+}
+//# sourceMappingURL=NoiseTexture.js.map

package/dist/src/core/textures/NoiseTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoiseTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/NoiseTexture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AA0BtE;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAa,SAAQ,OAAO;IACvC,KAAK,CAA8B;IAEnB,IAAI,GAAgB,WAAW,CAAC,KAAK,CAAC;IAEtD,YACE,SAA6B,EAC7B,KAAkC;QAElC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEQ,KAAK,CAAC,gBAAgB;QAC7B,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;YAC1C,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAClB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAC1B,CAAC;QAED,kEAAkE;QAClE,OAAO;YACL,IAAI,EAAE,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,YAAY,CAAC,KAAwB;QACnD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,aAAa,GAAG,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,gBAAgB,aAAa,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;IACvF,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAAwB;QAExB,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;YACjB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;YACjB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAoB;CAC3C"}

package/dist/src/core/textures/RenderTexture.d.ts

@@ -0,0 +1,29 @@
+import type { CoreTextureManager } from '../CoreTextureManager.js';
+import { Texture, TextureType, type TextureData } from './Texture.js';
+/**
+ * Properties of the {@link RenderTexture}
+ */
+export interface RenderTextureProps {
+    /**
+     * WebGL Texture width
+     * @default 256
+     */
+    w?: number;
+    /**
+     * WebGL Texture height
+     * @default 256
+     */
+    h?: number;
+}
+export declare class RenderTexture extends Texture {
+    props: Required<RenderTextureProps>;
+    type: TextureType;
+    constructor(txManager: CoreTextureManager, props: Required<RenderTextureProps>);
+    get w(): number;
+    set w(value: number);
+    get h(): number;
+    set h(value: number);
+    getTextureSource(): Promise<TextureData>;
+    static resolveDefaults(props: RenderTextureProps): Required<RenderTextureProps>;
+    static z$__type__Props: RenderTextureProps;
+}

package/dist/src/core/textures/RenderTexture.js

@@ -0,0 +1,36 @@
+import { Texture, TextureType } from './Texture.js';
+export class RenderTexture extends Texture {
+    props;
+    type = TextureType.renderToTexture;
+    constructor(txManager, props) {
+        super(txManager);
+        this.props = props;
+    }
+    get w() {
+        return this.props.w;
+    }
+    set w(value) {
+        this.props.w = value;
+    }
+    get h() {
+        return this.props.h;
+    }
+    set h(value) {
+        this.props.h = value;
+    }
+    async getTextureSource() {
+        // Render texture data ready - dimensions will be set during upload
+        return {
+            data: null,
+            premultiplyAlpha: null,
+        };
+    }
+    static resolveDefaults(props) {
+        return {
+            w: props.w || 256,
+            h: props.h || 256,
+        };
+    }
+    static z$__type__Props;
+}
+//# sourceMappingURL=RenderTexture.js.map

package/dist/src/core/textures/RenderTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/RenderTexture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAmBtE,MAAM,OAAO,aAAc,SAAQ,OAAO;IACxC,KAAK,CAA+B;IAEpB,IAAI,GAAgB,WAAW,CAAC,eAAe,CAAC;IAEhE,YACE,SAA6B,EAC7B,KAAmC;QAEnC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAEQ,KAAK,CAAC,gBAAgB;QAC7B,mEAAmE;QACnE,OAAO;YACL,IAAI,EAAE,IAAI;YACV,gBAAgB,EAAE,IAAI;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAAyB;QAEzB,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;YACjB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAqB;CAC5C"}

package/dist/src/core/textures/SubTexture.d.ts

@@ -0,0 +1,61 @@
+import type { CoreTextureManager } from '../CoreTextureManager.js';
+import { Texture, TextureType, type TextureData } from './Texture.js';
+/**
+ * Properties of the {@link SubTexture}
+ */
+export interface SubTextureProps {
+    /**
+     * The texture that this sub-texture is a sub-region of.
+     */
+    texture: Texture;
+    /**
+     * The x pixel position of the top-left of the sub-texture within the parent
+     * texture.
+     *
+     * @default 0
+     */
+    x?: number;
+    /**
+     * The y pixel position of the top-left sub-texture within the parent
+     * texture.
+     *
+     * @default 0
+     **/
+    y?: number;
+    /**
+     * The width of the sub-texture in pixels.
+     *
+     * @default 0
+     */
+    w?: number;
+    /**
+     * The height of the sub-texture in pixels
+     **/
+    h?: number;
+}
+/**
+ * A Texture that is a sub-region of another Texture.
+ *
+ * @remarks
+ * The parent texture can be a Sprite Sheet/Texture Atlas and set using the
+ * {@link SubTextureProps.texture} prop. The sub-region relative to the parent
+ * texture is defined with the {@link SubTextureProps.x},
+ * {@link SubTextureProps.y}, {@link SubTextureProps.w}, and
+ * {@link SubTextureProps.h} pixel values.
+ */
+export declare class SubTexture extends Texture {
+    props: Required<SubTextureProps>;
+    parentTexture: Texture;
+    type: TextureType;
+    subtextureId: string;
+    constructor(txManager: CoreTextureManager, props: Required<SubTextureProps>);
+    private onParentTxLoaded;
+    private onParentTxFailed;
+    private onParentTxLoading;
+    private onParentTxFreed;
+    onChangeIsRenderable(isRenderable: boolean): void;
+    getTextureSource(): Promise<TextureData>;
+    static makeCacheKey(props: SubTextureProps): string | false;
+    static resolveDefaults(props: SubTextureProps): Required<SubTextureProps>;
+    static z$__type__Props: SubTextureProps;
+}