@lightningjs/renderer 2.13.1 → 2.13.2

package/dist/src/core/renderers/canvas/CanvasRenderer.js

@@ -0,0 +1,212 @@
+import { SubTexture } from '../../textures/SubTexture.js';
+import { TextureType } from '../../textures/Texture.js';
+import { CoreRenderer, } from '../CoreRenderer.js';
+import { CanvasTexture } from './CanvasTexture.js';
+import { parseColor, parseToAbgrString, parseToRgbaString, } from './internal/ColorUtils.js';
+import { assertTruthy } from '../../../utils.js';
+import { CanvasShaderNode } from './CanvasShaderNode.js';
+export class CanvasRenderer extends CoreRenderer {
+    context;
+    canvas;
+    pixelRatio;
+    clearColor;
+    renderToTextureActive = false;
+    activeRttNode = null;
+    parsedColorCache = new Map();
+    constructor(options) {
+        super(options);
+        this.mode = 'canvas';
+        const { canvas } = options;
+        this.canvas = canvas;
+        this.context = canvas.getContext('2d');
+        this.pixelRatio = this.stage.pixelRatio;
+        this.clearColor = this.getParsedColor(this.stage.clearColor);
+    }
+    reset() {
+        this.canvas.width = this.canvas.width; // quick reset canvas
+        const ctx = this.context;
+        if (this.clearColor) {
+            ctx.fillStyle = this.clearColor;
+            ctx.fillRect(0, 0, this.canvas.width, this.canvas.height);
+        }
+        ctx.scale(this.pixelRatio, this.pixelRatio);
+    }
+    render() {
+        // noop
+    }
+    addQuad(quad) {
+        const ctx = this.context;
+        const { tx, ty, ta, tb, tc, td, clippingRect } = quad;
+        let texture = quad.texture;
+        const textureType = texture?.type;
+        assertTruthy(textureType, 'Texture type is not defined');
+        // The Canvas2D renderer only supports image and color textures
+        if (textureType !== TextureType.image &&
+            textureType !== TextureType.color &&
+            textureType !== TextureType.subTexture &&
+            textureType !== TextureType.noise) {
+            return;
+        }
+        if (texture) {
+            if (texture instanceof SubTexture) {
+                texture = texture.parentTexture;
+            }
+            if (texture.state === 'freed') {
+                return;
+            }
+            if (texture.state !== 'loaded') {
+                return;
+            }
+        }
+        const hasTransform = ta !== 1;
+        const hasClipping = clippingRect.width !== 0 && clippingRect.height !== 0;
+        const hasShader = quad.shader !== null;
+        let saveAndRestore = hasTransform === true || hasClipping === true;
+        if (hasShader === true) {
+            saveAndRestore =
+                saveAndRestore || quad.shader.applySNR;
+        }
+        if (saveAndRestore) {
+            ctx.save();
+        }
+        if (hasClipping === true) {
+            const path = new Path2D();
+            const { x, y, width, height } = clippingRect;
+            path.rect(x, y, width, height);
+            ctx.clip(path);
+        }
+        if (hasTransform === true) {
+            // Quad transform:
+            // | ta tb tx |
+            // | tc td ty |
+            // | 0  0  1  |
+            // C2D transform:
+            // | a  c  e  |
+            // | b  d  f  |
+            // | 0  0  1  |
+            const scale = this.pixelRatio;
+            ctx.setTransform(ta, tc, tb, td, tx * scale, ty * scale);
+            ctx.scale(scale, scale);
+            ctx.translate(-tx, -ty);
+        }
+        if (hasShader === true) {
+            let renderContext = () => {
+                this.renderContext(quad);
+            };
+            quad.shader.render(ctx, quad, renderContext);
+            renderContext = null;
+        }
+        else {
+            this.renderContext(quad);
+        }
+        if (saveAndRestore) {
+            ctx.restore();
+        }
+    }
+    renderContext(quad) {
+        const color = quad.colorTl;
+        const textureType = quad.texture?.type;
+        if ((textureType === TextureType.image ||
+            textureType === TextureType.subTexture ||
+            textureType === TextureType.noise) &&
+            quad.texture?.ctxTexture) {
+            const tintColor = parseColor(color);
+            const image = quad.texture.ctxTexture.getImage(tintColor);
+            this.context.globalAlpha = tintColor.a ?? quad.alpha;
+            if (textureType === TextureType.subTexture) {
+                this.context.drawImage(image, quad.texture.props.x, quad.texture.props.y, quad.texture.props.width, quad.texture.props.height, quad.tx, quad.ty, quad.width, quad.height);
+            }
+            else {
+                try {
+                    this.context.drawImage(image, quad.tx, quad.ty, quad.width, quad.height);
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                }
+                catch (error) {
+                    // noop
+                }
+            }
+            this.context.globalAlpha = 1;
+            return;
+        }
+        const hasGradient = quad.colorTl !== quad.colorTr || quad.colorTl !== quad.colorBr;
+        if (textureType === TextureType.color && hasGradient) {
+            let endX = quad.tx;
+            let endY = quad.ty;
+            let endColor;
+            if (quad.colorTl === quad.colorTr) {
+                // vertical
+                endX = quad.tx;
+                endY = quad.ty + quad.height;
+                endColor = quad.colorBr;
+            }
+            else {
+                // horizontal
+                endX = quad.tx + quad.width;
+                endY = quad.ty;
+                endColor = quad.colorTr;
+            }
+            const gradient = this.context.createLinearGradient(quad.tx, quad.ty, endX, endY);
+            gradient.addColorStop(0, this.getParsedColor(color));
+            gradient.addColorStop(1, this.getParsedColor(endColor));
+            this.context.fillStyle = gradient;
+            this.context.fillRect(quad.tx, quad.ty, quad.width, quad.height);
+        }
+        else if (textureType === TextureType.color) {
+            this.context.fillStyle = this.getParsedColor(color);
+            this.context.fillRect(quad.tx, quad.ty, quad.width, quad.height);
+        }
+    }
+    createShaderNode(shaderKey, shaderType, props) {
+        return new CanvasShaderNode(shaderKey, shaderType, this.stage, props);
+    }
+    createShaderProgram(shaderConfig) {
+        return null;
+    }
+    supportsShaderType(shaderType) {
+        return shaderType.render !== undefined;
+    }
+    createCtxTexture(textureSource) {
+        return new CanvasTexture(this.stage.txMemManager, textureSource);
+    }
+    renderRTTNodes() {
+        // noop
+    }
+    removeRTTNode(node) {
+        // noop
+    }
+    renderToTexture(node) {
+        // noop
+    }
+    getBufferInfo() {
+        return null;
+    }
+    getQuadCount() {
+        return null;
+    }
+    getParsedColor(color, isRGBA = false) {
+        let out = this.parsedColorCache.get(color);
+        if (out !== undefined) {
+            return out;
+        }
+        if (isRGBA) {
+            out = parseToRgbaString(color);
+        }
+        else {
+            out = parseToAbgrString(color);
+        }
+        this.parsedColorCache.set(color, out);
+        return out;
+    }
+    /**
+     * Updates the clear color of the canvas renderer.
+     *
+     * @param color - The color to set as the clear color.
+     */
+    updateClearColor(color) {
+        this.clearColor = this.getParsedColor(color);
+    }
+    getDefaultShaderNode() {
+        return null;
+    }
+}
+//# sourceMappingURL=CanvasRenderer.js.map

package/dist/src/core/renderers/canvas/CanvasRenderer.js.map

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

package/dist/src/core/renderers/canvas/CanvasShaderNode.d.ts

@@ -0,0 +1,21 @@
+import type { CoreNode } from '../../CoreNode.js';
+import type { Stage } from '../../Stage.js';
+import type { QuadOptions } from '../CoreRenderer.js';
+import { CoreShaderNode, type CoreShaderType } from '../CoreShaderNode.js';
+export type CanvasShaderType<T extends object = Record<string, unknown>, C extends object = Record<string, unknown>> = CoreShaderType<T> & {
+    render: (this: CanvasShaderNode<T, C>, ctx: CanvasRenderingContext2D, quad: QuadOptions, renderContext: () => void) => void;
+    update?: (this: CanvasShaderNode<T, C>, node: CoreNode) => void;
+    /**
+     * Set this to true when using ctx functions that scale, clip, rotate, etc..
+     */
+    saveAndRestore?: boolean;
+};
+export declare class CanvasShaderNode<Props extends object = Record<string, unknown>, Computed extends object = Record<string, unknown>> extends CoreShaderNode<Props> {
+    private updater;
+    private valueKey;
+    computed: Partial<Computed>;
+    applySNR: boolean;
+    render: CanvasShaderType<Props>['render'];
+    constructor(shaderKey: string, config: CanvasShaderType<Props>, stage: Stage, props?: Props);
+    toColorString(rgba: number): string;
+}

package/dist/src/core/renderers/canvas/CanvasShaderNode.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2023 Comcast Cable Communications Management, LLC
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CoreShaderNode } from '../CoreShaderNode.js';
+export class CanvasShaderNode extends CoreShaderNode {
+    updater = undefined;
+    valueKey = '';
+    computed = {};
+    applySNR;
+    render;
+    constructor(shaderKey, config, stage, props) {
+        super(shaderKey, config, stage, props);
+        this.applySNR = config.saveAndRestore || false;
+        this.render = config.render;
+        if (config.update !== undefined) {
+            this.updater = config.update;
+            if (this.props === undefined) {
+                this.updater(this.node, this.props);
+                return;
+            }
+            this.update = () => {
+                const prevKey = this.valueKey;
+                this.valueKey = '';
+                for (const key in this.resolvedProps) {
+                    this.valueKey += `${key}:${this.resolvedProps[key]};`;
+                }
+                if (prevKey === this.valueKey) {
+                    return;
+                }
+                if (prevKey.length > 0) {
+                    this.stage.shManager.mutateShaderValueUsage(prevKey, -1);
+                }
+                const computed = this.stage.shManager.getShaderValues(this.valueKey);
+                if (computed !== undefined) {
+                    this.computed = computed;
+                }
+                this.computed = {};
+                this.updater(this.node);
+                this.stage.shManager.setShaderValues(this.valueKey, this.computed);
+            };
+        }
+    }
+    toColorString(rgba) {
+        return this.stage.renderer.getParsedColor(rgba, true);
+    }
+}
+//# sourceMappingURL=CanvasShaderNode.js.map

package/dist/src/core/renderers/canvas/CanvasShaderNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasShaderNode.js","sourceRoot":"","sources":["../../../../../src/core/renderers/canvas/CanvasShaderNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAE,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAoB3E,MAAM,OAAO,gBAGX,SAAQ,cAAqB;IACrB,OAAO,GACb,SAAS,CAAC;IACJ,QAAQ,GAAW,EAAE,CAAC;IAC9B,QAAQ,GAAsB,EAAE,CAAC;IACjC,QAAQ,CAAU;IAClB,MAAM,CAAoC;IAE1C,YACE,SAAiB,EACjB,MAA+B,EAC/B,KAAY,EACZ,KAAa;QAEb,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAO,CAAC;YAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,IAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE;gBACjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAC9B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;gBACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACrC,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAE,GAAG,CAAC;gBACzD,CAAC;gBAED,IAAI,OAAO,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC9B,OAAO;gBACT,CAAC;gBAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC3D,CAAC;gBAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,eAAe,CACnD,IAAI,CAAC,QAAQ,CACa,CAAC;gBAC7B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,IAAI,CAAC,QAAQ,GAAG,QAAoB,CAAC;gBACvC,CAAC;gBACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;gBACnB,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,IAAgB,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrE,CAAC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAQ,IAAI,CAAC,KAAK,CAAC,QAA2B,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/src/core/renderers/canvas/CanvasTexture.d.ts

@@ -0,0 +1,16 @@
+import { CoreContextTexture } from '../CoreContextTexture.js';
+import { type IParsedColor } from './internal/ColorUtils.js';
+export declare class CanvasTexture extends CoreContextTexture {
+    protected image: ImageBitmap | HTMLCanvasElement | HTMLImageElement | undefined;
+    protected tintCache: {
+        key: string;
+        image: HTMLCanvasElement;
+    } | undefined;
+    load(): void;
+    free(): void;
+    updateMemSize(): void;
+    hasImage(): boolean;
+    getImage(color: IParsedColor): ImageBitmap | HTMLCanvasElement | HTMLImageElement;
+    protected tintTexture(source: ImageBitmap | HTMLCanvasElement | HTMLImageElement, color: string): HTMLCanvasElement;
+    private onLoadRequest;
+}

package/dist/src/core/renderers/canvas/CanvasTexture.js

@@ -0,0 +1,123 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { assertTruthy } from '../../../utils.js';
+import { CoreContextTexture } from '../CoreContextTexture.js';
+import { formatRgba } from './internal/ColorUtils.js';
+export class CanvasTexture extends CoreContextTexture {
+    image;
+    tintCache;
+    load() {
+        this.textureSource.setState('loading');
+        this.onLoadRequest()
+            .then((size) => {
+            this.textureSource.setState('loaded', size);
+            this.textureSource.freeTextureData();
+            this.updateMemSize();
+        })
+            .catch((err) => {
+            this.textureSource.setState('failed', err);
+            this.textureSource.freeTextureData();
+        });
+    }
+    free() {
+        this.image = undefined;
+        this.tintCache = undefined;
+        this.textureSource.setState('freed');
+        this.setTextureMemUse(0);
+        this.textureSource.freeTextureData();
+    }
+    updateMemSize() {
+        // Counting memory usage for:
+        // - main image
+        // - tinted image
+        const mult = this.tintCache ? 8 : 4;
+        if (this.textureSource.dimensions) {
+            const { width, height } = this.textureSource.dimensions;
+            this.setTextureMemUse(width * height * mult);
+        }
+    }
+    hasImage() {
+        return this.image !== undefined;
+    }
+    getImage(color) {
+        const image = this.image;
+        assertTruthy(image, 'Attempt to get unloaded image texture');
+        if (color.isWhite) {
+            if (this.tintCache) {
+                this.tintCache = undefined;
+                this.updateMemSize();
+            }
+            return image;
+        }
+        const key = formatRgba(color);
+        if (this.tintCache?.key === key) {
+            return this.tintCache.image;
+        }
+        const tintedImage = this.tintTexture(image, key);
+        this.tintCache = {
+            key,
+            image: tintedImage,
+        };
+        this.updateMemSize();
+        return tintedImage;
+    }
+    tintTexture(source, color) {
+        const { width, height } = source;
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d');
+        if (ctx) {
+            // fill with target color
+            ctx.fillStyle = color;
+            ctx.globalCompositeOperation = 'copy';
+            ctx.fillRect(0, 0, width, height);
+            // multiply with image, resulting in non-transparent tinted image
+            ctx.globalCompositeOperation = 'multiply';
+            ctx.drawImage(source, 0, 0, width, height, 0, 0, width, height);
+            // apply original image alpha
+            ctx.globalCompositeOperation = 'destination-in';
+            ctx.drawImage(source, 0, 0, width, height, 0, 0, width, height);
+        }
+        return canvas;
+    }
+    async onLoadRequest() {
+        assertTruthy(this.textureSource?.textureData?.data, 'Texture data is null');
+        const { data } = this.textureSource.textureData;
+        // TODO: canvas from text renderer should be able to provide the canvas directly
+        // instead of having to re-draw it into a new canvas...
+        if (data instanceof ImageData) {
+            const canvas = document.createElement('canvas');
+            canvas.width = data.width;
+            canvas.height = data.height;
+            const ctx = canvas.getContext('2d');
+            if (ctx)
+                ctx.putImageData(data, 0, 0);
+            this.image = canvas;
+            return { width: data.width, height: data.height };
+        }
+        else if ((typeof ImageBitmap !== 'undefined' && data instanceof ImageBitmap) ||
+            data instanceof HTMLImageElement) {
+            this.image = data;
+            return { width: data.width, height: data.height };
+        }
+        return { width: 0, height: 0 };
+    }
+}
+//# sourceMappingURL=CanvasTexture.js.map

package/dist/src/core/renderers/canvas/CanvasTexture.js.map

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

package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.d.ts

@@ -0,0 +1,12 @@
+import type { Dimensions } from '../../../common/CommonTypes.js';
+import type { TextureMemoryManager } from '../../TextureMemoryManager.js';
+import type { WebGlContextWrapper } from '../../lib/WebGlContextWrapper.js';
+import type { RenderTexture } from '../../textures/RenderTexture.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+export declare class WebGlCtxRenderTexture extends WebGlCtxTexture {
+    textureSource: RenderTexture;
+    framebuffer: WebGLFramebuffer | null;
+    constructor(glw: WebGlContextWrapper, memManager: TextureMemoryManager, textureSource: RenderTexture);
+    onLoadRequest(): Promise<Dimensions>;
+    free(): void;
+}

package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.js

@@ -0,0 +1,55 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2024 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { assertTruthy } from '../../../utils.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+export class WebGlCtxRenderTexture extends WebGlCtxTexture {
+    framebuffer = null;
+    constructor(glw, memManager, textureSource) {
+        super(glw, memManager, textureSource);
+    }
+    async onLoadRequest() {
+        const { glw } = this;
+        const nativeTexture = (this._nativeCtxTexture =
+            this.createNativeCtxTexture());
+        const { width, height } = this.textureSource;
+        // Create Framebuffer object
+        this.framebuffer = glw.createFramebuffer();
+        // Set the dimensions of the render texture
+        glw.texImage2D(0, glw.RGBA, width, height, 0, glw.RGBA, glw.UNSIGNED_BYTE, null);
+        // Update the texture memory manager
+        this.setTextureMemUse(width * height * 4);
+        // Bind the framebuffer
+        glw.bindFramebuffer(this.framebuffer);
+        // Attach the texture to the framebuffer
+        glw.framebufferTexture2D(glw.COLOR_ATTACHMENT0, nativeTexture, 0);
+        // Unbind the framebuffer
+        glw.bindFramebuffer(null);
+        return {
+            width,
+            height,
+        };
+    }
+    free() {
+        super.free();
+        // Delete the framebuffer
+        this.glw.deleteFramebuffer(this.framebuffer);
+        this.framebuffer = null;
+    }
+}
+//# sourceMappingURL=WebGlCtxRenderTexture.js.map

package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGlCtxRenderTexture.js","sourceRoot":"","sources":["../../../../../src/core/renderers/webgl/WebGlCtxRenderTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAGjD,WAAW,GAA4B,IAAI,CAAC;IAEnD,YACE,GAAwB,EACxB,UAAgC,EAChC,aAA4B;QAE5B,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACxC,CAAC;IAEQ,KAAK,CAAC,aAAa;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,iBAAiB;YAC3C,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;QACjC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QAE7C,4BAA4B;QAC5B,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAE3C,2CAA2C;QAC3C,GAAG,CAAC,UAAU,CACZ,CAAC,EACD,GAAG,CAAC,IAAI,EACR,KAAK,EACL,MAAM,EACN,CAAC,EACD,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,aAAa,EACjB,IAAI,CACL,CAAC;QAEF,oCAAoC;QACpC,IAAI,CAAC,gBAAgB,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QAE1C,uBAAuB;QACvB,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEtC,wCAAwC;QACxC,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,iBAAiB,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;QAElE,yBAAyB;QACzB,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE1B,OAAO;YACL,KAAK;YACL,MAAM;SACP,CAAC;IACJ,CAAC;IAEQ,IAAI;QACX,KAAK,CAAC,IAAI,EAAE,CAAC;QAEb,yBAAyB;QACzB,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.d.ts

@@ -0,0 +1,9 @@
+import type { Dimensions } from '../../../common/CommonTypes.js';
+import type { TextureMemoryManager } from '../../TextureMemoryManager.js';
+import type { WebGlContextWrapper } from '../../lib/WebGlContextWrapper.js';
+import type { SubTexture } from '../../textures/SubTexture.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+export declare class WebGlCtxSubTexture extends WebGlCtxTexture {
+    constructor(glw: WebGlContextWrapper, memManager: TextureMemoryManager, textureSource: SubTexture);
+    onLoadRequest(): Promise<Dimensions>;
+}

package/dist/src/{main-api/texture-usage-trackers/TextureUsageTracker.js → core/renderers/webgl/WebGlCtxSubTexture.js}

@@ -16,13 +16,23 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/**
- * Texture Usage Tracker for Usage Based Texture Garbage Collection
- */
-export class TextureUsageTracker {
-    releaseCallback;
-    constructor(releaseCallback) {
-        this.releaseCallback = releaseCallback;
+import { assertTruthy } from '../../../utils.js';
+import { WebGlCtxTexture } from './WebGlCtxTexture.js';
+export class WebGlCtxSubTexture extends WebGlCtxTexture {
+    constructor(glw, memManager, textureSource) {
+        super(glw, memManager, textureSource);
+    }
+    async onLoadRequest() {
+        const props = this.textureSource.textureData;
+        assertTruthy(props, 'SubTexture must have texture data');
+        if (props.data instanceof Uint8Array) {
+            // its a 1x1 Color Texture
+            return { width: 1, height: 1 };
+        }
+        return {
+            width: props.data?.width || 0,
+            height: props.data?.height || 0,
+        };
     }
 }
-//# sourceMappingURL=TextureUsageTracker.js.map
+//# sourceMappingURL=WebGlCtxSubTexture.js.map

package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGlCtxSubTexture.js","sourceRoot":"","sources":["../../../../../src/core/renderers/webgl/WebGlCtxSubTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YACE,GAAwB,EACxB,UAAgC,EAChC,aAAyB;QAEzB,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACxC,CAAC;IAEQ,KAAK,CAAC,aAAa;QAC1B,MAAM,KAAK,GAAI,IAAI,CAAC,aAA4B,CAAC,WAAW,CAAC;QAC7D,YAAY,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QAEzD,IAAI,KAAK,CAAC,IAAI,YAAY,UAAU,EAAE,CAAC;YACrC,0BAA0B;YAC1B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACjC,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;SAChC,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/renderers/webgl/WebGlCtxTexture.d.ts

@@ -0,0 +1,57 @@
+import type { Dimensions } from '../../../common/CommonTypes.js';
+import type { TextureMemoryManager } from '../../TextureMemoryManager.js';
+import type { WebGlContextWrapper } from '../../lib/WebGlContextWrapper.js';
+import type { Texture } from '../../textures/Texture.js';
+import { CoreContextTexture } from '../CoreContextTexture.js';
+/**
+ * A wrapper around a WebGLTexture that handles loading the texture data
+ * from a Texture source and uploading it to the GPU as well as freeing
+ * the uploaded texture.
+ *
+ * @remarks
+ * When accessing the ctxTexture property, the texture will be loaded if
+ * it hasn't been already. ctxTexture will always return a valid WebGLTexture
+ * and trigger the loading/uploading of the texture's data if it hasn't been
+ * loaded yet.
+ */
+export declare class WebGlCtxTexture extends CoreContextTexture {
+    protected glw: WebGlContextWrapper;
+    protected _nativeCtxTexture: WebGLTexture | null;
+    private _w;
+    private _h;
+    constructor(glw: WebGlContextWrapper, memManager: TextureMemoryManager, textureSource: Texture);
+    get ctxTexture(): WebGLTexture | null;
+    get w(): number;
+    get h(): number;
+    /**
+     * Load the texture data from the Texture source and upload it to the GPU
+     *
+     * @remarks
+     * This method is called automatically when accessing the ctxTexture property
+     * if the texture hasn't been loaded yet. But it can also be called manually
+     * to force the texture to be pre-loaded prior to accessing the ctxTexture
+     * property.
+     */
+    load(): void;
+    /**
+     * Called when the texture data needs to be loaded and uploaded to a texture
+     */
+    onLoadRequest(): Promise<Dimensions>;
+    /**
+     * Free the WebGLTexture from the GPU
+     *
+     * @returns
+     */
+    free(): void;
+    /**
+     * Create native context texture
+     *
+     * @remarks
+     * When this method returns the returned texture will be bound to the GL context state.
+     *
+     * @param width
+     * @param height
+     * @returns
+     */
+    protected createNativeCtxTexture(): WebGLTexture | null;
+}