@lightningtv/renderer 2.16.1

package/dist/src/core/text-rendering/renderers/CanvasTextRenderer.js

@@ -0,0 +1,397 @@
+/*
+ * 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 { EventEmitter } from '../../../common/EventEmitter.js';
+import { assertTruthy } from '../../../utils.js';
+import { getNormalizedRgbaComponents, getNormalizedAlphaComponent, } from '../../lib/utils.js';
+import {} from '../TrFontManager.js';
+import { WebTrFontFace } from '../font-face-types/WebTrFontFace.js';
+import { LightningTextTextureRenderer, } from './LightningTextTextureRenderer.js';
+import { TextRenderer, } from './TextRenderer.js';
+const resolvedGlobal = typeof self === 'undefined' ? globalThis : self;
+/**
+ * Global font set regardless of if run in the main thread or a web worker
+ */
+const globalFontSet = (resolvedGlobal.document?.fonts ||
+    resolvedGlobal.fonts);
+function getFontCssString(props) {
+    const { fontFamily, fontStyle, fontWeight, fontStretch, fontSize } = props;
+    return [fontStyle, fontWeight, fontStretch, `${fontSize}px`, fontFamily].join(' ');
+}
+export class CanvasTextRenderer extends TextRenderer {
+    canvas;
+    context;
+    /**
+     * Font family map used to store web font faces that were added to the
+     * canvas text renderer.
+     */
+    fontFamilies = {};
+    fontFamilyArray = [this.fontFamilies];
+    type = 'canvas';
+    constructor(stage) {
+        super(stage);
+        if (typeof OffscreenCanvas !== 'undefined') {
+            this.canvas = new OffscreenCanvas(0, 0);
+        }
+        else {
+            this.canvas = document.createElement('canvas');
+        }
+        let context = this.canvas.getContext('2d', {
+            willReadFrequently: true,
+        });
+        if (!context) {
+            // A browser may appear to support OffscreenCanvas but not actually support the Canvas '2d' context
+            // Here we try getting the context again after falling back to an HTMLCanvasElement.
+            // See: https://github.com/lightning-js/renderer/issues/26#issuecomment-1750438486
+            this.canvas = document.createElement('canvas');
+            context = this.canvas.getContext('2d', {
+                willReadFrequently: true,
+            });
+        }
+        assertTruthy(context);
+        this.context = context;
+        // Install the default 'san-serif' font face
+        this.addFontFace(new WebTrFontFace({
+            fontFamily: 'sans-serif',
+            descriptors: {},
+            fontUrl: '',
+        }));
+    }
+    //#region Overrides
+    getPropertySetters() {
+        return {
+            fontFamily: (state, value) => {
+                state.props.fontFamily = value;
+                state.fontInfo = undefined;
+                this.invalidateLayoutCache(state);
+            },
+            fontWeight: (state, value) => {
+                state.props.fontWeight = value;
+                state.fontInfo = undefined;
+                this.invalidateLayoutCache(state);
+            },
+            fontStyle: (state, value) => {
+                state.props.fontStyle = value;
+                state.fontInfo = undefined;
+                this.invalidateLayoutCache(state);
+            },
+            fontStretch: (state, value) => {
+                state.props.fontStretch = value;
+                state.fontInfo = undefined;
+                this.invalidateLayoutCache(state);
+            },
+            fontSize: (state, value) => {
+                state.props.fontSize = value;
+                state.fontInfo = undefined;
+                this.invalidateLayoutCache(state);
+            },
+            text: (state, value) => {
+                state.props.text = value;
+                this.invalidateLayoutCache(state);
+            },
+            textAlign: (state, value) => {
+                state.props.textAlign = value;
+                this.invalidateLayoutCache(state);
+            },
+            color: (state, value) => {
+                state.props.color = value;
+                this.invalidateLayoutCache(state);
+            },
+            x: (state, value) => {
+                state.props.x = value;
+            },
+            y: (state, value) => {
+                state.props.y = value;
+            },
+            contain: (state, value) => {
+                state.props.contain = value;
+                this.invalidateLayoutCache(state);
+            },
+            width: (state, value) => {
+                state.props.width = value;
+                // Only invalidate layout cache if we're containing in the horizontal direction
+                if (state.props.contain !== 'none') {
+                    this.invalidateLayoutCache(state);
+                }
+            },
+            height: (state, value) => {
+                state.props.height = value;
+                // Only invalidate layout cache if we're containing in the vertical direction
+                if (state.props.contain === 'both') {
+                    this.invalidateLayoutCache(state);
+                }
+            },
+            offsetY: (state, value) => {
+                state.props.offsetY = value;
+                this.invalidateLayoutCache(state);
+            },
+            scrollY: (state, value) => {
+                state.props.scrollY = value;
+            },
+            letterSpacing: (state, value) => {
+                state.props.letterSpacing = value;
+                this.invalidateLayoutCache(state);
+            },
+            lineHeight: (state, value) => {
+                state.props.lineHeight = value;
+                this.invalidateLayoutCache(state);
+            },
+            maxLines: (state, value) => {
+                state.props.maxLines = value;
+                this.invalidateLayoutCache(state);
+            },
+            textBaseline: (state, value) => {
+                state.props.textBaseline = value;
+                this.invalidateLayoutCache(state);
+            },
+            verticalAlign: (state, value) => {
+                state.props.verticalAlign = value;
+                this.invalidateLayoutCache(state);
+            },
+            overflowSuffix: (state, value) => {
+                state.props.overflowSuffix = value;
+                this.invalidateLayoutCache(state);
+            },
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    canRenderFont(props) {
+        // The canvas renderer can render any font because it automatically
+        // falls back to system fonts. The CanvasTextRenderer should be
+        // checked last if other renderers are preferred.
+        return true;
+    }
+    isFontFaceSupported(fontFace) {
+        return fontFace instanceof WebTrFontFace;
+    }
+    addFontFace(fontFace) {
+        // Make sure the font face is an Canvas font face (it should have already passed
+        // the `isFontFaceSupported` check)
+        assertTruthy(fontFace instanceof WebTrFontFace);
+        const fontFamily = fontFace.fontFamily;
+        // Add the font face to the document
+        // Except for the 'sans-serif' font family, which the Renderer provides
+        // as a special default fallback.
+        if (fontFamily !== 'sans-serif') {
+            // @ts-expect-error `add()` method should be available from a FontFaceSet
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            globalFontSet.add(fontFace.fontFace);
+        }
+        let faceSet = this.fontFamilies[fontFamily];
+        if (!faceSet) {
+            faceSet = new Set();
+            this.fontFamilies[fontFamily] = faceSet;
+        }
+        faceSet.add(fontFace);
+    }
+    createState(props, node) {
+        return {
+            node,
+            props,
+            status: 'initialState',
+            updateScheduled: false,
+            emitter: new EventEmitter(),
+            textureNode: undefined,
+            lightning2TextRenderer: new LightningTextTextureRenderer(this.canvas, this.context),
+            renderInfo: undefined,
+            forceFullLayoutCalc: false,
+            textW: 0,
+            textH: 0,
+            fontInfo: undefined,
+            isRenderable: false,
+            debugData: {
+                updateCount: 0,
+                layoutCount: 0,
+                drawCount: 0,
+                lastLayoutNumCharacters: 0,
+                layoutSum: 0,
+                drawSum: 0,
+                bufferSize: 0,
+            },
+        };
+    }
+    updateState(state) {
+        // On the first update call we need to set the status to loading
+        if (state.status === 'initialState') {
+            this.setStatus(state, 'loading');
+            // check if we're on screen
+            // if (this.isValidOnScreen(state) === true) {
+            //   this.setStatus(state, 'loading');
+            // }
+        }
+        if (state.status === 'loaded') {
+            // If we're loaded, we don't need to do anything
+            return;
+        }
+        // If fontInfo is invalid, we need to establish it
+        if (!state.fontInfo) {
+            return this.loadFont(state);
+        }
+        // If we're waiting for a font face to load, don't render anything
+        if (!state.fontInfo.loaded) {
+            return;
+        }
+        if (!state.renderInfo) {
+            state.renderInfo = this.calculateRenderInfo(state);
+            state.textH = state.renderInfo.lineHeight * state.renderInfo.lines.length;
+            state.textW = state.renderInfo.width;
+            this.renderSingleCanvasPage(state);
+        }
+        // handle scrollable text !!!
+        // if (state.isScrollable === true) {
+        //   return this.renderScrollableCanvasPages(state);
+        // }
+        // handle single page text
+    }
+    renderSingleCanvasPage(state) {
+        assertTruthy(state.renderInfo);
+        const node = state.node;
+        const texture = this.stage.txManager.createTexture('ImageTexture', {
+            premultiplyAlpha: true,
+            src: function (lightning2TextRenderer, renderInfo) {
+                // load the canvas texture
+                assertTruthy(renderInfo);
+                lightning2TextRenderer.draw(renderInfo, {
+                    lines: renderInfo.lines,
+                    lineWidths: renderInfo.lineWidths,
+                });
+                if (this.canvas.width === 0 || this.canvas.height === 0) {
+                    return null;
+                }
+                return this.context.getImageData(0, 0, this.canvas.width, this.canvas.height);
+            }.bind(this, state.lightning2TextRenderer, state.renderInfo),
+        });
+        if (state.textureNode) {
+            // Use the existing texture node
+            state.textureNode.texture = texture;
+            // Update the alpha
+            state.textureNode.alpha = getNormalizedAlphaComponent(state.props.color);
+        }
+        else {
+            // Create a new texture node
+            const textureNode = this.stage.createNode({
+                parent: node,
+                texture,
+                autosize: true,
+                // The alpha channel of the color is ignored when rasterizing the text
+                // texture so we need to pass it directly to the texture node.
+                alpha: getNormalizedAlphaComponent(state.props.color),
+            });
+            state.textureNode = textureNode;
+        }
+        this.setStatus(state, 'loaded');
+    }
+    loadFont = (state) => {
+        const cssString = getFontCssString(state.props);
+        const trFontFace = this.stage.fontManager.resolveFontFace(this.fontFamilyArray, state.props, 'canvas');
+        assertTruthy(trFontFace, `Could not resolve font face for ${cssString}`);
+        state.fontInfo = {
+            fontFace: trFontFace,
+            cssString: cssString,
+            // TODO: For efficiency we would use this here but it's not reliable on WPE -> document.fonts.check(cssString),
+            loaded: false,
+        };
+        // If font is not loaded, set up a handler to update the font info when the font loads
+        if (!state.fontInfo.loaded) {
+            globalFontSet
+                .load(cssString)
+                .then(this.onFontLoaded.bind(this, state, cssString))
+                .catch(this.onFontLoadError.bind(this, state, cssString));
+            return;
+        }
+    };
+    calculateRenderInfo(state) {
+        state.lightning2TextRenderer.settings = {
+            text: state.props.text,
+            textAlign: state.props.textAlign,
+            fontFamily: state.props.fontFamily,
+            trFontFace: state.fontInfo?.fontFace,
+            fontSize: state.props.fontSize,
+            fontStyle: [
+                state.props.fontStretch,
+                state.props.fontStyle,
+                state.props.fontWeight,
+            ].join(' '),
+            textColor: getNormalizedRgbaComponents(state.props.color),
+            offsetY: state.props.offsetY,
+            wordWrap: state.props.contain !== 'none',
+            wordWrapWidth: state.props.contain === 'none' ? undefined : state.props.width,
+            letterSpacing: state.props.letterSpacing,
+            lineHeight: state.props.lineHeight ?? null,
+            maxLines: state.props.maxLines,
+            maxHeight: state.props.contain === 'both'
+                ? state.props.height - state.props.offsetY
+                : null,
+            textBaseline: state.props.textBaseline,
+            verticalAlign: state.props.verticalAlign,
+            overflowSuffix: state.props.overflowSuffix,
+            w: state.props.contain !== 'none' ? state.props.width : undefined,
+        };
+        state.renderInfo = state.lightning2TextRenderer.calculateRenderInfo();
+        return state.renderInfo;
+    }
+    renderQuads() {
+        // Do nothing. The renderer will render the child node(s) that were created
+        // in the state update.
+        return;
+    }
+    destroyState(state) {
+        if (state.status === 'destroyed') {
+            return;
+        }
+        super.destroyState(state);
+        if (state.textureNode) {
+            state.textureNode.destroy();
+            delete state.textureNode;
+        }
+        delete state.renderInfo;
+    }
+    //#endregion Overrides
+    /**
+     * Invalidate the layout cache stored in the state. This will cause the text
+     * to be re-rendered on the next update.
+     *
+     * @remarks
+     * This also invalidates the visible window cache.
+     *
+     * @param state
+     */
+    invalidateLayoutCache(state) {
+        state.renderInfo = undefined;
+        this.setStatus(state, 'loading');
+        this.scheduleUpdateState(state);
+    }
+    onFontLoaded(state, cssString) {
+        if (cssString !== state.fontInfo?.cssString || !state.fontInfo) {
+            return;
+        }
+        state.fontInfo.loaded = true;
+        this.scheduleUpdateState(state);
+    }
+    onFontLoadError(state, cssString, error) {
+        if (cssString !== state.fontInfo?.cssString || !state.fontInfo) {
+            return;
+        }
+        // Font didn't actually load, but we'll log the error and mark it as loaded
+        // because the browser can still render with a fallback font.
+        state.fontInfo.loaded = true;
+        console.error(`CanvasTextRenderer: Error loading font '${state.fontInfo.cssString}'`, error);
+        this.scheduleUpdateState(state);
+    }
+}
+//# sourceMappingURL=CanvasTextRenderer.js.map

package/dist/src/core/text-rendering/renderers/CanvasTextRenderer.js.map

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

package/dist/src/core/text-rendering/renderers/LightningTextTextureRenderer.d.ts

@@ -0,0 +1,120 @@
+import { type RGBA } from '../../lib/utils.js';
+import type { NormalizedFontMetrics } from '../font-face-types/TrFontFace.js';
+import type { WebTrFontFace } from '../font-face-types/WebTrFontFace.js';
+/**
+ * Text Overflow Values
+ */
+export type TextOverflow = 'ellipsis' | 'clip' | (string & Record<never, never>);
+/***
+ * Text Horizontal Align Values
+ */
+export type TextAlign = 'left' | 'center' | 'right';
+/***
+ * Text Baseline Values
+ */
+export type TextBaseline = 'alphabetic' | 'top' | 'hanging' | 'middle' | 'ideographic' | 'bottom';
+/***
+ * Text Vertical Align Values
+ */
+export type TextVerticalAlign = 'top' | 'middle' | 'bottom';
+/**
+ * Text Texture Settings
+ */
+export interface Settings {
+    w: number;
+    h: number;
+    text: string;
+    fontStyle: string;
+    fontSize: number;
+    fontBaselineRatio: number;
+    fontFamily: string | null;
+    trFontFace: WebTrFontFace | null;
+    wordWrap: boolean;
+    wordWrapWidth: number;
+    wordBreak: boolean;
+    textOverflow: TextOverflow | null;
+    lineHeight: number | null;
+    textBaseline: TextBaseline;
+    textAlign: TextAlign;
+    verticalAlign: TextVerticalAlign;
+    offsetY: number | null;
+    maxLines: number;
+    maxHeight: number | null;
+    overflowSuffix: string;
+    precision: number;
+    textColor: RGBA;
+    paddingLeft: number;
+    paddingRight: number;
+    shadow: boolean;
+    shadowColor: RGBA;
+    shadowOffsetX: number;
+    shadowOffsetY: number;
+    shadowBlur: number;
+    highlight: boolean;
+    highlightHeight: number;
+    highlightColor: RGBA;
+    highlightOffset: number;
+    highlightPaddingLeft: number;
+    highlightPaddingRight: number;
+    letterSpacing: number;
+    textIndent: number;
+    cutSx: number;
+    cutSy: number;
+    cutEx: number;
+    cutEy: number;
+    advancedRenderer: boolean;
+    textRenderIssueMargin: number;
+}
+export interface RenderInfo {
+    w: number;
+    h: number;
+    lines: string[];
+    precision: number;
+    remainingText: string;
+    moreTextLines: boolean;
+    width: number;
+    innerWidth: number;
+    height: number;
+    fontSize: number;
+    cutSx: number;
+    cutSy: number;
+    cutEx: number;
+    cutEy: number;
+    lineHeight: number;
+    defLineHeight: number;
+    lineWidths: number[];
+    offsetY: number;
+    paddingLeft: number;
+    paddingRight: number;
+    letterSpacing: number;
+    textIndent: number;
+    metrics: NormalizedFontMetrics;
+}
+export declare class LightningTextTextureRenderer {
+    private _canvas;
+    private _context;
+    private _settings;
+    constructor(canvas: OffscreenCanvas | HTMLCanvasElement, context: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D);
+    set settings(v: Partial<Settings>);
+    get settings(): Settings;
+    getPrecision(): number;
+    setFontProperties(): void;
+    _getFontSetting(): string;
+    _load(): Promise<void> | undefined;
+    calculateRenderInfo(): RenderInfo;
+    draw(renderInfo: RenderInfo, linesOverride?: {
+        lines: string[];
+        lineWidths: number[];
+    }): void;
+    wrapWord(word: string, wordWrapWidth: number, suffix: string): string;
+    /**
+     * Applies newlines to a string to have it optimally fit into the horizontal
+     * bounds set by the Text object's wordWrapWidth property.
+     */
+    wrapText(text: string, wordWrapWidth: number, letterSpacing: number, indent?: number): {
+        l: string[];
+        n: number[];
+    };
+    measureText(word: string, space?: number): number;
+    mergeDefaults(settings: Partial<Settings>): Settings;
+}