@lightningtv/renderer 2.16.1

package/dist/src/core/TextureMemoryManager.d.ts

@@ -0,0 +1,149 @@
+import type { Stage } from './Stage.js';
+import { Texture } from './textures/Texture.js';
+export interface TextureMemoryManagerSettings {
+    /**
+     * Critical Threshold (in bytes)
+     *
+     * @remarks
+     * When the amount of memory used by textures exceeds this threshold,
+     * the Renderer will immediately trigger a Texture Cleanup towards the
+     * Target Threshold Level.
+     *
+     * When set to `0`, the Texture Memory Manager is disabled.
+     *
+     * @defaultValue `124e6` (118 MB)
+     */
+    criticalThreshold: number;
+    /**
+     * Target Threshold Level (as fraction of Critical Threshold)
+     *
+     * @remarks
+     * This value is the fractional level of the Critical Threshold that the
+     * Texture Memory Manager will attempt to maintain by cleaning up textures.
+     * The Texture Memory Manager will attempt to keep the memory usage below
+     * this level by freeing up non-renderable textures.
+     *
+     * Valid Range: 0.0 - 1.0
+     *
+     * @defaultValue `0.5`
+     */
+    targetThresholdLevel: number;
+    /**
+     * Interval between non-aggressive Texture Cleanups (in milliseconds)
+     *
+     * @remarks
+     * Texture Memory Manager will perform a non aggressive Texture Cleanup no more
+     * frequently than this interval when the scene becomes idle.
+     *
+     * @defaultValue `5,000` (5 seconds)
+     */
+    cleanupInterval: number;
+    /**
+     * Whether or not to log debug information
+     *
+     * @defaultValue `false`
+     */
+    debugLogging: boolean;
+    /**
+     * Baseline memory allocation for the Texture Memory Manager
+     *
+     * @remarks
+     * Baseline texture memory is an allocation of memory by simply having a 1080p WebGL context.
+     * This will be used on top of the memory used by textures to determine when to trigger a cleanup.
+     *
+     * @defaultValue `25e6` (25 MB)
+     */
+    baselineMemoryAllocation: number;
+    /**
+     * Do not exceed critical threshold
+     *
+     * @defaultValue `false`
+     */
+    doNotExceedCriticalThreshold: boolean;
+}
+export interface MemoryInfo {
+    criticalThreshold: number;
+    targetThreshold: number;
+    renderableMemUsed: number;
+    memUsed: number;
+    renderableTexturesLoaded: number;
+    loadedTextures: number;
+    baselineMemoryAllocation: number;
+}
+/**
+ * LRU (Least Recently Used) style memory manager for textures
+ *
+ * @remarks
+ * This class is responsible for managing the memory usage of textures
+ * in the Renderer. It keeps track of the memory used by each texture
+ * and triggers a cleanup when the memory usage exceeds a critical
+ * threshold (`criticalThreshold`).
+ *
+ * The cleanup process will free up non-renderable textures until the
+ * memory usage is below a target threshold (`targetThresholdLevel`).
+ *
+ * The memory manager's clean up process will also be triggered when the
+ * scene is idle for a certain amount of time (`cleanupInterval`).
+ */
+export declare class TextureMemoryManager {
+    private stage;
+    private memUsed;
+    private loadedTextures;
+    private orphanedTextures;
+    private criticalThreshold;
+    private targetThreshold;
+    private cleanupInterval;
+    private debugLogging;
+    private lastCleanupTime;
+    private baselineMemoryAllocation;
+    criticalCleanupRequested: boolean;
+    doNotExceedCriticalThreshold: boolean;
+    /**
+     * The current frame time in milliseconds
+     *
+     * @remarks
+     * This is used to determine when to perform Idle Texture Cleanups.
+     *
+     * Set by stage via `updateFrameTime` method.
+     */
+    frameTime: number;
+    constructor(stage: Stage, settings: TextureMemoryManagerSettings);
+    /**
+     * Add a texture to the orphaned textures list
+     *
+     * @param texture - The texture to add to the orphaned textures list
+     */
+    addToOrphanedTextures(texture: Texture): void;
+    /**
+     * Remove a texture from the orphaned textures list
+     *
+     * @param texture - The texture to remove from the orphaned textures list
+     */
+    removeFromOrphanedTextures(texture: Texture): void;
+    /**
+     * Set the memory usage of a texture
+     *
+     * @param texture - The texture to set memory usage for
+     * @param byteSize - The size of the texture in bytes
+     */
+    setTextureMemUse(texture: Texture, byteSize: number): void;
+    checkCleanup(): boolean;
+    checkCriticalCleanup(): boolean;
+    cleanupQuick(critical: boolean): void;
+    /**
+     * Destroy a texture and remove it from the memory manager
+     *
+     * @param texture - The texture to destroy
+     */
+    destroyTexture(texture: Texture): void;
+    cleanupDeep(critical: boolean): void;
+    cleanup(aggressive?: boolean): void;
+    /**
+     * Get the current texture memory usage information
+     *
+     * @remarks
+     * This method is for debugging purposes and returns information about the
+     * current memory usage of the textures in the Renderer.
+     */
+    getMemoryInfo(): MemoryInfo;
+}

package/dist/src/core/TextureMemoryManager.js

@@ -0,0 +1,271 @@
+/*
+ * 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 { isProductionEnvironment } from '../utils.js';
+import { getTimeStamp } from './platform.js';
+import { Texture, TextureType } from './textures/Texture.js';
+import { bytesToMb } from './utils.js';
+/**
+ * LRU (Least Recently Used) style memory manager for textures
+ *
+ * @remarks
+ * This class is responsible for managing the memory usage of textures
+ * in the Renderer. It keeps track of the memory used by each texture
+ * and triggers a cleanup when the memory usage exceeds a critical
+ * threshold (`criticalThreshold`).
+ *
+ * The cleanup process will free up non-renderable textures until the
+ * memory usage is below a target threshold (`targetThresholdLevel`).
+ *
+ * The memory manager's clean up process will also be triggered when the
+ * scene is idle for a certain amount of time (`cleanupInterval`).
+ */
+export class TextureMemoryManager {
+    stage;
+    memUsed = 0;
+    loadedTextures = new Map();
+    orphanedTextures = [];
+    criticalThreshold;
+    targetThreshold;
+    cleanupInterval;
+    debugLogging;
+    lastCleanupTime = 0;
+    baselineMemoryAllocation;
+    criticalCleanupRequested = false;
+    doNotExceedCriticalThreshold;
+    /**
+     * The current frame time in milliseconds
+     *
+     * @remarks
+     * This is used to determine when to perform Idle Texture Cleanups.
+     *
+     * Set by stage via `updateFrameTime` method.
+     */
+    frameTime = 0;
+    constructor(stage, settings) {
+        this.stage = stage;
+        const { criticalThreshold, doNotExceedCriticalThreshold } = settings;
+        this.doNotExceedCriticalThreshold = doNotExceedCriticalThreshold || false;
+        this.criticalThreshold = Math.round(criticalThreshold);
+        const targetFraction = Math.max(0, Math.min(1, settings.targetThresholdLevel));
+        this.cleanupInterval = settings.cleanupInterval;
+        this.debugLogging = settings.debugLogging;
+        this.baselineMemoryAllocation = Math.round(settings.baselineMemoryAllocation);
+        this.targetThreshold = Math.max(Math.round(criticalThreshold * targetFraction), this.baselineMemoryAllocation);
+        this.memUsed = Math.round(settings.baselineMemoryAllocation);
+        if (settings.debugLogging) {
+            let lastMemUse = 0;
+            setInterval(() => {
+                if (lastMemUse !== this.memUsed) {
+                    lastMemUse = this.memUsed;
+                    console.log(`[TextureMemoryManager] Memory used: ${bytesToMb(this.memUsed)} mb / ${bytesToMb(this.criticalThreshold)} mb (${((this.memUsed / this.criticalThreshold) *
+                        100).toFixed(1)}%)`);
+                }
+            }, 1000);
+        }
+        // If the threshold is 0, we disable the memory manager by replacing the
+        // setTextureMemUse method with a no-op function.
+        if (criticalThreshold === 0) {
+            this.setTextureMemUse = () => { };
+        }
+    }
+    /**
+     * Add a texture to the orphaned textures list
+     *
+     * @param texture - The texture to add to the orphaned textures list
+     */
+    addToOrphanedTextures(texture) {
+        // if the texture is already in the orphaned textures list add it at the end
+        if (this.orphanedTextures.includes(texture)) {
+            this.removeFromOrphanedTextures(texture);
+        }
+        // If the texture can be cleaned up, add it to the orphaned textures list
+        if (texture.preventCleanup === false) {
+            this.orphanedTextures.push(texture);
+        }
+    }
+    /**
+     * Remove a texture from the orphaned textures list
+     *
+     * @param texture - The texture to remove from the orphaned textures list
+     */
+    removeFromOrphanedTextures(texture) {
+        const index = this.orphanedTextures.indexOf(texture);
+        if (index !== -1) {
+            this.orphanedTextures.splice(index, 1);
+        }
+    }
+    /**
+     * Set the memory usage of a texture
+     *
+     * @param texture - The texture to set memory usage for
+     * @param byteSize - The size of the texture in bytes
+     */
+    setTextureMemUse(texture, byteSize) {
+        if (this.loadedTextures.has(texture)) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            this.memUsed -= this.loadedTextures.get(texture);
+        }
+        if (byteSize === 0) {
+            this.loadedTextures.delete(texture);
+            return;
+        }
+        else {
+            this.memUsed += byteSize;
+            this.loadedTextures.set(texture, byteSize);
+        }
+        if (this.memUsed > this.criticalThreshold) {
+            this.criticalCleanupRequested = true;
+        }
+    }
+    checkCleanup() {
+        return (this.criticalCleanupRequested ||
+            (this.memUsed > this.targetThreshold &&
+                this.frameTime - this.lastCleanupTime >= this.cleanupInterval));
+    }
+    checkCriticalCleanup() {
+        return this.memUsed > this.criticalThreshold;
+    }
+    cleanupQuick(critical) {
+        // Free non-renderable textures until we reach the target threshold
+        const memTarget = this.targetThreshold;
+        const timestamp = getTimeStamp();
+        while (this.memUsed >= memTarget &&
+            this.orphanedTextures.length > 0 &&
+            (critical || getTimeStamp() - timestamp < 10)) {
+            const texture = this.orphanedTextures.shift();
+            if (texture === undefined) {
+                continue;
+            }
+            if (texture.renderable === true) {
+                // If the texture is renderable, we can't free it up
+                continue;
+            }
+            // Skip textures that are in transitional states - we only want to clean up
+            // textures that are in a stable state (loaded, failed, or freed)
+            if (texture.state === 'initial' ||
+                Texture.TRANSITIONAL_TEXTURE_STATES.includes(texture.state)) {
+                continue;
+            }
+            this.destroyTexture(texture);
+        }
+    }
+    /**
+     * Destroy a texture and remove it from the memory manager
+     *
+     * @param texture - The texture to destroy
+     */
+    destroyTexture(texture) {
+        if (this.debugLogging === true) {
+            console.log(`[TextureMemoryManager] Destroying texture. State: ${texture.state}`);
+        }
+        const txManager = this.stage.txManager;
+        txManager.removeTextureFromQueue(texture);
+        txManager.removeTextureFromCache(texture);
+        texture.destroy();
+        this.removeFromOrphanedTextures(texture);
+        this.loadedTextures.delete(texture);
+    }
+    cleanupDeep(critical) {
+        // Free non-renderable textures until we reach the target threshold
+        const memTarget = critical ? this.criticalThreshold : this.targetThreshold;
+        // Filter for textures that are candidates for cleanup
+        // note: This is an expensive operation, so we only do it in deep cleanup
+        const cleanupCandidates = [...this.loadedTextures.keys()].filter((texture) => {
+            return ((texture.type === TextureType.image ||
+                texture.type === TextureType.noise ||
+                texture.type === TextureType.renderToTexture) &&
+                texture.renderable === false &&
+                texture.preventCleanup === false &&
+                texture.state !== 'initial' &&
+                !Texture.TRANSITIONAL_TEXTURE_STATES.includes(texture.state));
+        });
+        while (this.memUsed >= memTarget && cleanupCandidates.length > 0) {
+            const texture = cleanupCandidates.shift();
+            if (texture === undefined) {
+                continue;
+            }
+            this.destroyTexture(texture);
+        }
+    }
+    cleanup(aggressive = false) {
+        const critical = this.criticalCleanupRequested;
+        this.lastCleanupTime = this.frameTime;
+        if (critical === true) {
+            this.stage.queueFrameEvent('criticalCleanup', {
+                memUsed: this.memUsed,
+                criticalThreshold: this.criticalThreshold,
+            });
+        }
+        if (this.debugLogging === true) {
+            console.log(`[TextureMemoryManager] Cleaning up textures. Critical: ${critical}. Aggressive: ${aggressive}`);
+        }
+        // Note: We skip textures in transitional states during cleanup:
+        // - 'initial': These textures haven't started loading yet
+        // - 'fetching': These textures are in the process of being fetched
+        // - 'fetched': These textures have been fetched but not yet uploaded to GPU
+        // - 'loading': These textures are being uploaded to the GPU
+        //
+        // For 'failed' and 'freed' states, we only remove them from the tracking
+        // arrays without trying to free GPU resources that don't exist.
+        // try a quick cleanup first
+        this.cleanupQuick(critical);
+        // if we're still above the target threshold, do a deep cleanup
+        if (aggressive === true && this.memUsed >= this.criticalThreshold) {
+            this.cleanupDeep(critical);
+        }
+        if (this.memUsed >= this.criticalThreshold) {
+            this.stage.queueFrameEvent('criticalCleanupFailed', {
+                memUsed: this.memUsed,
+                criticalThreshold: this.criticalThreshold,
+            });
+            if (this.debugLogging === true || isProductionEnvironment() === false) {
+                console.warn(`[TextureMemoryManager] Memory usage above critical threshold after cleanup: ${this.memUsed}`);
+            }
+        }
+        else {
+            this.criticalCleanupRequested = false;
+        }
+    }
+    /**
+     * Get the current texture memory usage information
+     *
+     * @remarks
+     * This method is for debugging purposes and returns information about the
+     * current memory usage of the textures in the Renderer.
+     */
+    getMemoryInfo() {
+        let renderableTexturesLoaded = 0;
+        const renderableMemUsed = [...this.loadedTextures.keys()].reduce((acc, texture) => {
+            renderableTexturesLoaded += texture.renderable ? 1 : 0;
+            // Get the memory used by the texture, defaulting to 0 if not found
+            const textureMemory = this.loadedTextures.get(texture) ?? 0;
+            return acc + (texture.renderable ? textureMemory : 0);
+        }, this.baselineMemoryAllocation);
+        return {
+            criticalThreshold: this.criticalThreshold,
+            targetThreshold: this.targetThreshold,
+            renderableMemUsed,
+            memUsed: this.memUsed,
+            renderableTexturesLoaded,
+            loadedTextures: this.loadedTextures.size,
+            baselineMemoryAllocation: this.baselineMemoryAllocation,
+        };
+    }
+}
+//# sourceMappingURL=TextureMemoryManager.js.map

package/dist/src/core/TextureMemoryManager.js.map

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

package/dist/src/core/animations/AnimationManager.d.ts

@@ -0,0 +1,7 @@
+import { CoreAnimation } from './CoreAnimation.js';
+export declare class AnimationManager {
+    activeAnimations: Set<CoreAnimation>;
+    registerAnimation(animation: CoreAnimation): void;
+    unregisterAnimation(animation: CoreAnimation): void;
+    update(dt: number): void;
+}

package/dist/src/core/animations/AnimationManager.js

@@ -0,0 +1,34 @@
+/*
+ * 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 { CoreAnimation } from './CoreAnimation.js';
+export class AnimationManager {
+    activeAnimations = new Set();
+    registerAnimation(animation) {
+        this.activeAnimations.add(animation);
+    }
+    unregisterAnimation(animation) {
+        this.activeAnimations.delete(animation);
+    }
+    update(dt) {
+        this.activeAnimations.forEach((animation) => {
+            animation.update(dt);
+        });
+    }
+}
+//# sourceMappingURL=AnimationManager.js.map

package/dist/src/core/animations/AnimationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationManager.js","sourceRoot":"","sources":["../../../../src/core/animations/AnimationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAO,gBAAgB;IAC3B,gBAAgB,GAAuB,IAAI,GAAG,EAAE,CAAC;IAEjD,iBAAiB,CAAC,SAAwB;QACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,mBAAmB,CAAC,SAAwB;QAC1C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAC1C,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/core/animations/CoreAnimation.d.ts

@@ -0,0 +1,38 @@
+import { type CoreNode, type CoreNodeAnimateProps } from '../CoreNode.js';
+import { EventEmitter } from '../../common/EventEmitter.js';
+export interface AnimationSettings {
+    duration: number;
+    delay: number;
+    easing: string;
+    loop: boolean;
+    repeat: number;
+    repeatDelay: number;
+    stopMethod: 'reverse' | 'reset' | false;
+}
+type PropValues = {
+    start: number;
+    target: number;
+};
+type PropValuesMap = Record<string, Record<string, PropValues>>;
+export declare class CoreAnimation extends EventEmitter {
+    private node;
+    private props;
+    settings: AnimationSettings;
+    private progress;
+    private delayFor;
+    private delay;
+    private timingFunction;
+    propValuesMap: PropValuesMap;
+    dynPropValuesMap: PropValuesMap | undefined;
+    constructor(node: CoreNode, props: Partial<CoreNodeAnimateProps>, settings: Partial<AnimationSettings>);
+    reset(): void;
+    private restoreValues;
+    restore(): void;
+    private reverseValues;
+    reverse(): void;
+    private applyEasing;
+    updateValue(propName: string, propValue: number, startValue: number, easing: string | undefined): number;
+    private updateValues;
+    update(dt: number): void;
+}
+export {};