@lightningjs/renderer 3.0.0-beta1 → 3.0.0-beta10

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

@@ -0,0 +1,366 @@
+/*
+ * 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 * as CanvasFontHandler from './CanvasFontHandler.js';
+import {} from './canvas/calculateRenderInfo.js';
+import { calcHeight, measureText, wrapText, wrapWord } from './canvas/Utils.js';
+import { normalizeCanvasColor } from '../lib/colorCache.js';
+import { isZeroWidthSpace } from './Utils.js';
+const MAX_TEXTURE_DIMENSION = 4096;
+const type = 'canvas';
+let canvas = null;
+let context = null;
+// Separate canvas and context for text measurements
+let measureCanvas = null;
+let measureContext = null;
+// Cache for text layout calculations
+const layoutCache = new Map();
+// Initialize the Text Renderer
+const init = (stage) => {
+    // Drawing canvas and context
+    canvas = stage.platform.createCanvas();
+    context = canvas.getContext('2d', { willReadFrequently: true });
+    // Separate measuring canvas and context
+    measureCanvas = stage.platform.createCanvas();
+    measureContext = measureCanvas.getContext('2d');
+    // Set up a minimal size for the measuring canvas since we only use it for measurements
+    measureCanvas.width = 1;
+    measureCanvas.height = 1;
+    CanvasFontHandler.init(context);
+};
+/**
+ * Canvas text renderer
+ *
+ * @param stage - Stage instance for font resolution
+ * @param props - Text rendering properties
+ * @returns Object containing ImageData and dimensions
+ */
+const renderText = (stage, props) => {
+    assertTruthy(canvas, 'Canvas is not initialized');
+    assertTruthy(context, 'Canvas context is not available');
+    // Extract already normalized properties
+    const { text, fontFamily, fontStyle, fontSize, textAlign, lineHeight: propLineHeight, maxLines, textBaseline, verticalAlign, overflowSuffix, maxWidth, maxHeight, offsetY, letterSpacing, } = props;
+    // Performance optimization constants
+    const precision = 1;
+    const paddingLeft = 0;
+    const paddingRight = 0;
+    const textIndent = 0;
+    const textRenderIssueMargin = 0;
+    const textColor = 0xffffffff;
+    // Determine word wrap behavior
+    const wordWrap = maxWidth > 0;
+    const textOverflow = overflowSuffix ? 'ellipsis' : null;
+    // Calculate scaled values
+    const scaledFontSize = fontSize * precision;
+    const scaledOffsetY = offsetY * precision;
+    const scaledLetterSpacing = letterSpacing * precision;
+    // Get font metrics and calculate line height
+    context.font = `${fontStyle} ${scaledFontSize}px ${fontFamily}`;
+    context.textBaseline = textBaseline;
+    const metrics = CanvasFontHandler.getFontMetrics(fontFamily, scaledFontSize);
+    const lineHeight = propLineHeight === 0
+        ? scaledFontSize *
+            (metrics.ascender - metrics.descender + metrics.lineGap) *
+            precision
+        : propLineHeight;
+    // Calculate max lines constraint
+    const containedMaxLines = maxHeight !== null ? Math.floor(maxHeight / lineHeight) : 0;
+    const computedMaxLines = calculateMaxLines(containedMaxLines, maxLines);
+    // Calculate initial width and inner width
+    let width = maxWidth || 2048 / precision;
+    let innerWidth = width - paddingLeft;
+    if (innerWidth < 10) {
+        width += 10 - innerWidth;
+        innerWidth = 10;
+    }
+    const finalWordWrapWidth = maxWidth === 0 ? innerWidth : maxWidth;
+    // Calculate text layout using cached helper function
+    const layout = calculateTextLayout(text, fontFamily, scaledFontSize, fontStyle, wordWrap, finalWordWrapWidth, scaledLetterSpacing, textIndent, computedMaxLines, overflowSuffix, textOverflow);
+    // Calculate final dimensions
+    const dimensions = calculateTextDimensions(layout, paddingLeft, paddingRight, textBaseline, scaledFontSize, lineHeight, scaledOffsetY, maxWidth, maxHeight, wordWrap, textAlign);
+    // Set up canvas dimensions
+    canvas.width = Math.min(Math.ceil(dimensions.width + textRenderIssueMargin), MAX_TEXTURE_DIMENSION);
+    canvas.height = Math.min(Math.ceil(dimensions.height), MAX_TEXTURE_DIMENSION);
+    // Reset font context after canvas resize
+    context.font = `${fontStyle} ${scaledFontSize}px ${fontFamily}`;
+    context.textBaseline = textBaseline;
+    // Performance optimization for large fonts
+    if (scaledFontSize >= 128) {
+        context.globalAlpha = 0.01;
+        context.fillRect(0, 0, 0.01, 0.01);
+        context.globalAlpha = 1.0;
+    }
+    // Calculate drawing positions
+    const drawLines = calculateDrawPositions(layout.lines, layout.lineWidths, textAlign, verticalAlign, innerWidth, paddingLeft, textIndent, lineHeight, metrics, scaledFontSize);
+    // Render text to canvas
+    renderTextToCanvas(context, drawLines, scaledLetterSpacing, textColor, fontStyle, scaledFontSize, fontFamily);
+    width = dimensions.width;
+    const height = lineHeight * layout.lines.length;
+    // Extract image data
+    let imageData = null;
+    if (canvas.width > 0 && canvas.height > 0) {
+        imageData = context.getImageData(0, 0, width, height);
+    }
+    return {
+        imageData,
+        width,
+        height,
+    };
+};
+/**
+ * Calculate the effective max lines constraint
+ */
+function calculateMaxLines(containedMaxLines, maxLines) {
+    if (containedMaxLines > 0 && maxLines > 0) {
+        return containedMaxLines < maxLines ? containedMaxLines : maxLines;
+    }
+    else {
+        return containedMaxLines > maxLines ? containedMaxLines : maxLines;
+    }
+}
+/**
+ * Generate a cache key for text layout calculations
+ */
+function generateLayoutCacheKey(text, fontFamily, fontSize, fontStyle, wordWrap, wordWrapWidth, letterSpacing, maxLines, overflowSuffix) {
+    return `${text}-${fontFamily}-${fontSize}-${fontStyle}-${wordWrap}-${wordWrapWidth}-${letterSpacing}-${maxLines}-${overflowSuffix}`;
+}
+/**
+ * Calculate text dimensions and wrapping
+ */
+function calculateTextLayout(text, fontFamily, fontSize, fontStyle, wordWrap, wordWrapWidth, letterSpacing, textIndent, maxLines, overflowSuffix, textOverflow) {
+    assertTruthy(measureContext, 'Measure context is not available');
+    // Check cache first
+    const cacheKey = generateLayoutCacheKey(text, fontFamily, fontSize, fontStyle, wordWrap, wordWrapWidth, letterSpacing, maxLines, overflowSuffix);
+    const cached = layoutCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    // Set font context for measurements on the dedicated measuring context
+    measureContext.font = `${fontStyle} ${fontSize}px ${fontFamily}`;
+    // Handle text overflow for non-wrapped text
+    let processedText = text;
+    if (textOverflow !== null && wordWrap === false) {
+        let suffix;
+        if (textOverflow === 'clip') {
+            suffix = '';
+        }
+        else if (textOverflow === 'ellipsis') {
+            suffix = overflowSuffix;
+        }
+        else {
+            suffix = textOverflow;
+        }
+        processedText = wrapWord(measureContext, text, wordWrapWidth - textIndent, suffix, letterSpacing);
+    }
+    // Word wrap
+    let linesInfo;
+    if (wordWrap === true) {
+        linesInfo = wrapText(measureContext, processedText, wordWrapWidth, letterSpacing, textIndent);
+    }
+    else {
+        linesInfo = { l: processedText.split(/(?:\r\n|\r|\n)/), n: [] };
+        const n = linesInfo.l.length;
+        for (let i = 0; i < n - 1; i++) {
+            linesInfo.n.push(i);
+        }
+    }
+    let lines = linesInfo.l;
+    let remainingText = '';
+    let moreTextLines = false;
+    // Handle max lines constraint
+    if (maxLines > 0 && lines.length > maxLines) {
+        const usedLines = lines.slice(0, maxLines);
+        let otherLines = [];
+        if (overflowSuffix.length > 0) {
+            const w = measureText(measureContext, overflowSuffix, letterSpacing);
+            const al = wrapText(measureContext, usedLines[usedLines.length - 1] || '', wordWrapWidth - w, letterSpacing, textIndent);
+            usedLines[usedLines.length - 1] = `${al.l[0] || ''}${overflowSuffix}`;
+            otherLines = [al.l.length > 1 ? al.l[1] || '' : ''];
+        }
+        else {
+            otherLines = [''];
+        }
+        // Re-assemble the remaining text
+        let i;
+        const n = lines.length;
+        let j = 0;
+        const m = linesInfo.n.length;
+        for (i = maxLines; i < n; i++) {
+            otherLines[j] += `${otherLines[j] ? ' ' : ''}${lines[i] ?? ''}`;
+            if (i + 1 < m && linesInfo.n[i + 1] !== undefined) {
+                j++;
+            }
+        }
+        remainingText = otherLines.join('\n');
+        moreTextLines = true;
+        lines = usedLines;
+    }
+    // Calculate line widths using the dedicated measuring context
+    let maxLineWidth = 0;
+    const lineWidths = [];
+    for (let i = 0; i < lines.length; i++) {
+        const lineWidth = measureText(measureContext, lines[i] || '', letterSpacing) +
+            (i === 0 ? textIndent : 0);
+        lineWidths.push(lineWidth);
+        maxLineWidth = Math.max(maxLineWidth, lineWidth);
+    }
+    const result = {
+        lines,
+        lineWidths,
+        maxLineWidth,
+        remainingText,
+        moreTextLines,
+    };
+    // Cache the result
+    layoutCache.set(cacheKey, result);
+    return result;
+}
+/**
+ * Calculate text dimensions based on layout
+ */
+function calculateTextDimensions(layout, paddingLeft, paddingRight, textBaseline, fontSize, lineHeight, offsetY, initialWidth, initialHeight, wordWrap, textAlign) {
+    let width = initialWidth;
+    let height = initialHeight;
+    // Calculate width
+    if (initialWidth === 0) {
+        width = layout.maxLineWidth + paddingLeft + paddingRight;
+    }
+    // Adjust width for single-line left-aligned wrapped text
+    if (wordWrap === true &&
+        width > layout.maxLineWidth &&
+        textAlign === 'left' &&
+        layout.lines.length === 1) {
+        width = layout.maxLineWidth + paddingLeft + paddingRight;
+    }
+    // Calculate height if not provided
+    if (height === 0) {
+        height = calcHeight(textBaseline, fontSize, lineHeight, layout.lines.length, offsetY);
+    }
+    return { width, height };
+}
+/**
+ * Calculate drawing positions for text lines
+ */
+function calculateDrawPositions(lines, lineWidths, textAlign, verticalAlign, innerWidth, paddingLeft, textIndent, lineHeight, metrics, fontSize) {
+    const drawLines = [];
+    const ascenderPx = metrics.ascender * fontSize;
+    const bareLineHeightPx = (metrics.ascender - metrics.descender) * fontSize;
+    for (let i = 0, n = lines.length; i < n; i++) {
+        let linePositionX = i === 0 ? textIndent : 0;
+        let linePositionY = i * lineHeight + ascenderPx;
+        // Vertical alignment
+        if (verticalAlign == 'middle') {
+            linePositionY += (lineHeight - bareLineHeightPx) / 2;
+        }
+        else if (verticalAlign == 'bottom') {
+            linePositionY += lineHeight - bareLineHeightPx;
+        }
+        // Horizontal alignment
+        const lineWidth = lineWidths[i];
+        if (lineWidth !== undefined) {
+            if (textAlign === 'right') {
+                linePositionX += innerWidth - lineWidth;
+            }
+            else if (textAlign === 'center') {
+                linePositionX += (innerWidth - lineWidth) / 2;
+            }
+        }
+        linePositionX += paddingLeft;
+        const lineText = lines[i];
+        if (lineText !== undefined) {
+            drawLines.push({
+                text: lineText,
+                x: linePositionX,
+                y: linePositionY,
+                w: lineWidth || 0,
+            });
+        }
+    }
+    return drawLines;
+}
+/**
+ * Render text lines to canvas
+ */
+function renderTextToCanvas(context, drawLines, letterSpacing, textColor, fontStyle, fontSize, fontFamily) {
+    assertTruthy(measureContext, 'Measure context is not available');
+    context.fillStyle = normalizeCanvasColor(textColor);
+    // Sync font settings to measure context if we need to use it for letter spacing
+    if (letterSpacing > 0) {
+        measureContext.font = `${fontStyle} ${fontSize}px ${fontFamily}`;
+    }
+    for (let i = 0, n = drawLines.length; i < n; i++) {
+        const drawLine = drawLines[i];
+        if (drawLine) {
+            if (letterSpacing === 0) {
+                context.fillText(drawLine.text, drawLine.x, drawLine.y);
+            }
+            else {
+                const textSplit = drawLine.text.split('');
+                let x = drawLine.x;
+                for (let j = 0, k = textSplit.length; j < k; j++) {
+                    const char = textSplit[j];
+                    if (char) {
+                        // Skip zero-width spaces for rendering but keep them in the text flow
+                        if (isZeroWidthSpace(char)) {
+                            continue;
+                        }
+                        context.fillText(char, x, drawLine.y);
+                        // Use the dedicated measuring context for letter spacing calculations
+                        x += measureText(measureContext, char, letterSpacing);
+                    }
+                }
+            }
+        }
+    }
+}
+/**
+ * Clear layout cache for memory management
+ */
+const clearLayoutCache = () => {
+    layoutCache.clear();
+};
+/**
+ * Add quads for rendering (Canvas doesn't use quads)
+ */
+const addQuads = () => {
+    // Canvas renderer doesn't use quad-based rendering
+    // Return null for interface compatibility
+    return null;
+};
+/**
+ * Render quads for Canvas renderer (Canvas doesn't use quad-based rendering)
+ */
+const renderQuads = () => {
+    // Canvas renderer doesn't use quad-based rendering
+    // This method is for interface compatibility only
+};
+/**
+ * Canvas Text Renderer - implements TextRenderer interface
+ */
+const CanvasTextRenderer = {
+    type,
+    font: CanvasFontHandler,
+    renderText,
+    addQuads,
+    renderQuads,
+    init,
+    clearLayoutCache,
+};
+export default CanvasTextRenderer;
+//# sourceMappingURL=CanvasTextRenderer.js.map

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

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

package/dist/src/core/text-rendering/SdfFontHandler.d.ts

@@ -0,0 +1,137 @@
+import type { FontFamilyMap, FontMetrics, NormalizedFontMetrics, TrProps, FontLoadOptions } from './TextRenderer.js';
+import type { ImageTexture } from '../textures/ImageTexture.js';
+import type { Stage } from '../Stage.js';
+/**
+ * SDF Font Data structure matching msdf-bmfont-xml output
+ */
+export interface SdfFontData {
+    pages: string[];
+    chars: Array<{
+        id: number;
+        char: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        xoffset: number;
+        yoffset: number;
+        xadvance: number;
+        page: number;
+        chnl: number;
+    }>;
+    kernings: Array<{
+        first: number;
+        second: number;
+        amount: number;
+    }>;
+    info: {
+        face: string;
+        size: number;
+        bold: number;
+        italic: number;
+        charset: string[];
+        unicode: number;
+        stretchH: number;
+        smooth: number;
+        aa: number;
+        padding: [number, number, number, number];
+        spacing: [number, number];
+        outline: number;
+    };
+    common: {
+        lineHeight: number;
+        base: number;
+        scaleW: number;
+        scaleH: number;
+        pages: number;
+        packed: number;
+        alphaChnl: number;
+        redChnl: number;
+        greenChnl: number;
+        blueChnl: number;
+    };
+    distanceField: {
+        fieldType: 'sdf' | 'msdf';
+        distanceRange: number;
+    };
+    lightningMetrics?: FontMetrics;
+}
+/**
+ * Check if the SDF font handler can render a font
+ * @param {TrProps} trProps - Text rendering properties
+ * @returns {boolean} True if the font can be rendered
+ */
+export declare const canRenderFont: (trProps: TrProps) => boolean;
+/**
+ * Load SDF font from JSON + PNG atlas
+ * @param {Object} options - Font loading options
+ * @param {string} options.fontFamily - Font family name
+ * @param {string} options.fontUrl - JSON font data URL (atlasDataUrl)
+ * @param {string} options.atlasUrl - PNG atlas texture URL
+ * @param {FontMetrics} options.metrics - Optional font metrics
+ */
+export declare const loadFont: (stage: Stage, options: FontLoadOptions) => Promise<void>;
+/**
+ * Get the font families map for resolving fonts
+ */
+export declare const getFontFamilies: () => FontFamilyMap;
+/**
+ * Initialize the SDF font handler
+ */
+export declare const init: (c?: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D) => void;
+export declare const type = "sdf";
+/**
+ * Check if a font is already loaded by font family
+ */
+export declare const isFontLoaded: (fontFamily: string) => boolean;
+/**
+ * Get normalized font metrics for a font family
+ */
+export declare const getFontMetrics: (fontFamily: string, fontSize: number) => NormalizedFontMetrics;
+/**
+ * Set font metrics for a font family
+ */
+export declare const setFontMetrics: (fontFamily: string, metrics: NormalizedFontMetrics) => void;
+/**
+ * Get glyph data for a character in a specific font
+ * @param {string} fontFamily - Font family name
+ * @param {number} codepoint - Character codepoint
+ * @returns {Object|null} Glyph data or null if not found
+ */
+export declare const getGlyph: (fontFamily: string, codepoint: number) => SdfFontData["chars"][0] | null;
+/**
+ * Get kerning value between two glyphs
+ * @param {string} fontFamily - Font family name
+ * @param {number} firstGlyph - First glyph ID
+ * @param {number} secondGlyph - Second glyph ID
+ * @returns {number} Kerning value or 0
+ */
+export declare const getKerning: (fontFamily: string, firstGlyph: number, secondGlyph: number) => number;
+/**
+ * Get atlas texture for a font family
+ * @param {string} fontFamily - Font family name
+ * @returns {ImageTexture|null} Atlas texture or null
+ */
+export declare const getAtlas: (fontFamily: string) => ImageTexture | null;
+/**
+ * Get font data for a font family
+ * @param {string} fontFamily - Font family name
+ * @returns {SdfFontData|null} Font data or null
+ */
+export declare const getFontData: (fontFamily: string) => SdfFontData | null;
+/**
+ * Get maximum character height for a font family
+ * @param {string} fontFamily - Font family name
+ * @returns {number} Max character height or 0
+ */
+export declare const getMaxCharHeight: (fontFamily: string) => number;
+/**
+ * Get all loaded font families
+ * @returns {string[]} Array of font family names
+ */
+export declare const getLoadedFonts: () => string[];
+/**
+ * Unload a font and free resources
+ * @param {string} fontFamily - Font family name
+ */
+export declare const unloadFont: (fontFamily: string) => void;