@lightningjs/renderer 2.14.4 → 2.16.0

package/dist/src/core/text-rendering/canvas/calculateRenderInfo.js

@@ -0,0 +1,188 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2025 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 { calculateFontMetrics } from '../Utils.js';
+import { wrapText, wrapWord, measureText, calcHeight } from './Utils.js';
+import { getFontMetrics, setFontMetrics } from '../CanvasFontHandler.js';
+import { TextAlign, TextBaselineValueToKey } from '../TextRenderer.js';
+export function calculateRenderInfo({ context, settings, }) {
+    const precision = settings.precision;
+    const paddingLeft = settings.paddingLeft * precision;
+    const paddingRight = settings.paddingRight * precision;
+    const fontSize = settings.fontSize * precision;
+    let offsetY = settings.offsetY === null ? null : settings.offsetY * precision;
+    const w = settings.w * precision;
+    const h = settings.h * precision;
+    let wordWrapWidth = settings.wordWrapWidth * precision;
+    const cutSx = settings.cutSx * precision;
+    const cutEx = settings.cutEx * precision;
+    const cutSy = settings.cutSy * precision;
+    const cutEy = settings.cutEy * precision;
+    const letterSpacing = (settings.letterSpacing || 0) * precision;
+    const textIndent = settings.textIndent * precision;
+    const fontFamily = settings.fontFamily;
+    // Set font properties
+    context.font = `${settings.fontStyle} ${fontSize}px ${fontFamily}`;
+    context.textBaseline = TextBaselineValueToKey[settings.textBaseline];
+    let metrics = getFontMetrics(fontFamily);
+    if (metrics === null) {
+        metrics = calculateFontMetrics(context, fontFamily, fontSize);
+        setFontMetrics(fontFamily, metrics);
+    }
+    const defLineHeight = fontSize *
+        (metrics.ascender - metrics.descender + metrics.lineGap) *
+        precision;
+    const lineHeight = settings.lineHeight !== null
+        ? settings.lineHeight * precision
+        : defLineHeight;
+    const maxHeight = settings.maxHeight;
+    const containedMaxLines = maxHeight !== null && lineHeight > 0
+        ? Math.floor(maxHeight / lineHeight)
+        : 0;
+    const setMaxLines = settings.maxLines;
+    const calcMaxLines = containedMaxLines > 0 && setMaxLines > 0
+        ? Math.min(containedMaxLines, setMaxLines)
+        : Math.max(containedMaxLines, setMaxLines);
+    const textOverflow = settings.textOverflow;
+    const wordWrap = settings.wordWrap;
+    // Total width
+    let width = w || 2048 / precision;
+    // Inner width
+    let innerWidth = width - paddingLeft;
+    if (innerWidth < 10) {
+        width += 10 - innerWidth;
+        innerWidth = 10;
+    }
+    if (wordWrapWidth === 0) {
+        wordWrapWidth = innerWidth;
+    }
+    // Text overflow
+    let text = settings.text;
+    if (textOverflow !== null && wordWrap === false) {
+        let suffix;
+        switch (textOverflow) {
+            case 'clip':
+                suffix = '';
+                break;
+            case 'ellipsis':
+                suffix = settings.overflowSuffix;
+                break;
+            default:
+                suffix = String(textOverflow);
+        }
+        text = wrapWord(context, text, wordWrapWidth - textIndent, suffix, letterSpacing);
+    }
+    // Word wrap
+    let linesInfo;
+    if (wordWrap === true) {
+        linesInfo = wrapText(context, text, wordWrapWidth, letterSpacing, textIndent);
+    }
+    else {
+        linesInfo = { l: text.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;
+    if (calcMaxLines > 0 && lines.length > calcMaxLines) {
+        const usedLines = lines.slice(0, calcMaxLines);
+        let otherLines = [];
+        const overflowSuffix = settings.overflowSuffix;
+        if (overflowSuffix.length > 0) {
+            const w = measureText(context, overflowSuffix, letterSpacing);
+            const al = wrapText(context, 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 = calcMaxLines; 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 text width
+    let maxLineWidth = 0;
+    const lineWidths = [];
+    for (let i = 0; i < lines.length; i++) {
+        const lineWidth = measureText(context, lines[i], letterSpacing) +
+            (i === 0 ? textIndent : 0);
+        lineWidths.push(lineWidth);
+        maxLineWidth = Math.max(maxLineWidth, lineWidth);
+    }
+    if (w === 0) {
+        width = maxLineWidth + paddingLeft + paddingRight;
+        innerWidth = maxLineWidth;
+    }
+    if (wordWrap === true &&
+        w > maxLineWidth &&
+        settings.textAlign === TextAlign.left &&
+        lines.length === 1) {
+        width = maxLineWidth + paddingLeft + paddingRight;
+    }
+    let height;
+    if (h > 0) {
+        height = h;
+    }
+    else {
+        height = calcHeight(settings.textBaseline, fontSize, lineHeight, lines.length, offsetY);
+    }
+    if (offsetY === null) {
+        offsetY = fontSize;
+    }
+    return {
+        w: width,
+        h: height,
+        lines,
+        precision,
+        remainingText,
+        moreTextLines,
+        width,
+        innerWidth,
+        height,
+        fontSize,
+        cutSx,
+        cutSy,
+        cutEx,
+        cutEy,
+        lineHeight,
+        defLineHeight,
+        lineWidths,
+        offsetY: offsetY,
+        paddingLeft,
+        paddingRight,
+        letterSpacing,
+        textIndent,
+        metrics,
+    };
+}
+//# sourceMappingURL=calculateRenderInfo.js.map

package/dist/src/core/text-rendering/canvas/calculateRenderInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateRenderInfo.js","sourceRoot":"","sources":["../../../../../src/core/text-rendering/canvas/calculateRenderInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAA8B,MAAM,oBAAoB,CAAC;AAoCnG,MAAM,UAAU,mBAAmB,CAAC,EAClC,OAAO,EACP,QAAQ,GAIT;IACC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACrC,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC;IACrD,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC/C,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC;IAC9E,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;IACjC,IAAI,aAAa,GAAG,QAAQ,CAAC,aAAa,GAAG,SAAS,CAAC;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;IACzC,MAAM,aAAa,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAChE,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;IAEnD,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAW,CAAC;IAExC,sBAAsB;IACtB,OAAO,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,SAAS,IAAI,QAAQ,MAAM,UAAU,EAAE,CAAC;IACnE,OAAO,CAAC,YAAY,GAAG,sBAAsB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAErE,IAAI,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,aAAa,GACjB,QAAQ;QACR,CAAC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;QACxD,SAAS,CAAC;IACZ,MAAM,UAAU,GACd,QAAQ,CAAC,UAAU,KAAK,IAAI;QAC1B,CAAC,CAAC,QAAQ,CAAC,UAAU,GAAG,SAAS;QACjC,CAAC,CAAC,aAAa,CAAC;IAEpB,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACrC,MAAM,iBAAiB,GACrB,SAAS,KAAK,IAAI,IAAI,UAAU,GAAG,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC;QACpC,CAAC,CAAC,CAAC,CAAC;IACR,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACtC,MAAM,YAAY,GAChB,iBAAiB,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAE/C,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAEnC,cAAc;IACd,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,GAAG,SAAS,CAAC;IAClC,cAAc;IACd,IAAI,UAAU,GAAG,KAAK,GAAG,WAAW,CAAC;IACrC,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;QACpB,KAAK,IAAI,EAAE,GAAG,UAAU,CAAC;QACzB,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;IACD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,aAAa,GAAG,UAAU,CAAC;IAC7B,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,GAAW,QAAQ,CAAC,IAAI,CAAC;IACjC,IAAI,YAAY,KAAK,IAAI,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QAChD,IAAI,MAAc,CAAC;QACnB,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,MAAM;gBACT,MAAM,GAAG,EAAE,CAAC;gBACZ,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC;gBACjC,MAAM;YACR;gBACE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,GAAG,QAAQ,CACb,OAAO,EACP,IAAI,EACJ,aAAa,GAAG,UAAU,EAC1B,MAAM,EACN,aAAa,CACd,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,IAAI,SAAuC,CAAC;IAC5C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,SAAS,GAAG,QAAQ,CAClB,OAAO,EACP,IAAI,EACJ,aAAa,EACb,aAAa,EACb,UAAU,CACX,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,GAAa,SAAS,CAAC,CAAC,CAAC;IAElC,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,YAAY,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,UAAU,GAAa,EAAE,CAAC;QAC9B,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC;QAE/C,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;YAC9D,MAAM,EAAE,GAAG,QAAQ,CACjB,OAAO,EACP,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAE,EAChC,aAAa,GAAG,CAAC,EACjB,aAAa,EACb,UAAU,CACX,CAAC;YACF,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,cAAc,EAAE,CAAC;YACjE,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QACD,iCAAiC;QACjC,IAAI,CAAS,CAAC;QACd,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7B,KAAK,CAAC,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;gBAClD,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;QACD,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,aAAa,GAAG,IAAI,CAAC;QACrB,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;IAED,uBAAuB;IACvB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GACb,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,aAAa,CAAC;YAC9C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;QAClD,UAAU,GAAG,YAAY,CAAC;IAC5B,CAAC;IACD,IACE,QAAQ,KAAK,IAAI;QACjB,CAAC,GAAG,YAAY;QAChB,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI;QACrC,KAAK,CAAC,MAAM,KAAK,CAAC,EAClB,CAAC;QACD,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IACpD,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,UAAU,CACjB,QAAQ,CAAC,YAAY,EACrB,QAAQ,EACR,UAAU,EACV,KAAK,CAAC,MAAM,EACZ,OAAO,CACR,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,GAAG,QAAQ,CAAC;IACrB,CAAC;IAED,OAAO;QACL,CAAC,EAAE,KAAK;QACR,CAAC,EAAE,MAAM;QACT,KAAK;QACL,SAAS;QACT,aAAa;QACb,aAAa;QACb,KAAK;QACL,UAAU;QACV,MAAM;QACN,QAAQ;QACR,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,UAAU;QACV,aAAa;QACb,UAAU;QACV,OAAO,EAAE,OAAiB;QAC1B,WAAW;QACX,YAAY;QACZ,aAAa;QACb,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/src/core/text-rendering/canvas/draw.d.ts

@@ -0,0 +1,12 @@
+import type { RenderInfo } from './calculateRenderInfo.js';
+import type { Settings } from './Settings.js';
+export declare const draw: ({ canvas, context, renderInfo, settings, linesOverride, }: {
+    canvas: OffscreenCanvas | HTMLCanvasElement;
+    context: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D;
+    renderInfo: RenderInfo;
+    settings: Settings;
+    linesOverride?: {
+        lines: string[];
+        lineWidths: number[];
+    };
+}) => void;

package/dist/src/core/text-rendering/canvas/draw.js

@@ -0,0 +1,133 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2025 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 { getRgbaString } from '../../lib/utils.js';
+import { calcHeight, measureText } from './Utils.js';
+import { TextAlign, TextBaselineValueToKey, TextVerticalAlign } from '../TextRenderer.js';
+const MAX_TEXTURE_DIMENSION = 4096;
+export const draw = ({ canvas, context, renderInfo, settings, linesOverride, }) => {
+    const fontSize = renderInfo.fontSize;
+    const lineHeight = renderInfo.lineHeight;
+    const precision = settings.precision;
+    const lines = linesOverride?.lines || renderInfo.lines;
+    const lineWidths = linesOverride?.lineWidths || renderInfo.lineWidths;
+    const height = linesOverride !== undefined
+        ? calcHeight(settings.textBaseline, fontSize, lineHeight, linesOverride.lines.length, settings.offsetY === null ? null : settings.offsetY * precision)
+        : renderInfo.height;
+    // Add extra margin to prevent issue with clipped text when scaling.
+    canvas.width = Math.min(Math.ceil(renderInfo.width + settings.textRenderIssueMargin), MAX_TEXTURE_DIMENSION);
+    canvas.height = Math.min(Math.ceil(height), MAX_TEXTURE_DIMENSION);
+    // Canvas context has been reset.
+    context.font = `${settings.fontStyle} ${fontSize}px ${settings.fontFamily}`;
+    context.textBaseline = TextBaselineValueToKey[settings.textBaseline];
+    if (fontSize >= 128) {
+        context.globalAlpha = 0.01;
+        context.fillRect(0, 0, 0.01, 0.01);
+        context.globalAlpha = 1.0;
+    }
+    if (renderInfo.cutSx || renderInfo.cutSy) {
+        context.translate(-renderInfo.cutSx, -renderInfo.cutSy);
+    }
+    let linePositionX;
+    let linePositionY;
+    const drawLines = [];
+    const metrics = renderInfo.metrics;
+    const ascenderPx = metrics ? metrics.ascender * fontSize : fontSize;
+    const bareLineHeightPx = metrics
+        ? (metrics.ascender - metrics.descender) * fontSize
+        : fontSize;
+    for (let i = 0, n = lines.length; i < n; i++) {
+        linePositionX = i === 0 ? renderInfo.textIndent : 0;
+        linePositionY = i * lineHeight + ascenderPx;
+        if (settings.verticalAlign === TextVerticalAlign.middle) {
+            linePositionY += (lineHeight - bareLineHeightPx) / 2;
+        }
+        else if (settings.verticalAlign === TextVerticalAlign.bottom) {
+            linePositionY += lineHeight - bareLineHeightPx;
+        }
+        if (settings.textAlign === TextAlign.right) {
+            linePositionX += renderInfo.innerWidth - lineWidths[i];
+        }
+        else if (settings.textAlign === TextAlign.center) {
+            linePositionX += (renderInfo.innerWidth - lineWidths[i]) / 2;
+        }
+        linePositionX += renderInfo.paddingLeft;
+        drawLines.push({
+            text: lines[i],
+            x: linePositionX,
+            y: linePositionY,
+            w: lineWidths[i],
+        });
+    }
+    // Highlight
+    if (settings.highlight === true) {
+        const color = settings.highlightColor;
+        const hlHeight = settings.highlightHeight * precision || fontSize * 1.5;
+        const offset = settings.highlightOffset * precision;
+        const hlPaddingLeft = settings.highlightPaddingLeft !== null
+            ? settings.highlightPaddingLeft * precision
+            : renderInfo.paddingLeft;
+        const hlPaddingRight = settings.highlightPaddingRight !== null
+            ? settings.highlightPaddingRight * precision
+            : renderInfo.paddingRight;
+        context.fillStyle = getRgbaString(color);
+        for (let i = 0; i < drawLines.length; i++) {
+            const drawLine = drawLines[i];
+            context.fillRect(drawLine.x - hlPaddingLeft, drawLine.y - renderInfo.offsetY + offset, drawLine.w + hlPaddingRight + hlPaddingLeft, hlHeight);
+        }
+    }
+    // Text shadow
+    let prevShadowSettings = null;
+    if (settings.shadow === true) {
+        prevShadowSettings = [
+            context.shadowColor,
+            context.shadowOffsetX,
+            context.shadowOffsetY,
+            context.shadowBlur,
+        ];
+        context.shadowColor = getRgbaString(settings.shadowColor);
+        context.shadowOffsetX = settings.shadowOffsetX * precision;
+        context.shadowOffsetY = settings.shadowOffsetY * precision;
+        context.shadowBlur = settings.shadowBlur * precision;
+    }
+    context.fillStyle = getRgbaString(settings.textColor);
+    for (let i = 0, n = drawLines.length; i < n; i++) {
+        const drawLine = drawLines[i];
+        if (renderInfo.letterSpacing === 0) {
+            context.fillText(drawLine.text, drawLine.x, drawLine.y);
+        }
+        else {
+            const textSplit = drawLine.text.split('');
+            let x = drawLine.x;
+            for (let i = 0, j = textSplit.length; i < j; i++) {
+                context.fillText(textSplit[i], x, drawLine.y);
+                x += measureText(context, textSplit[i], renderInfo.letterSpacing);
+            }
+        }
+    }
+    if (prevShadowSettings) {
+        context.shadowColor = prevShadowSettings[0];
+        context.shadowOffsetX = prevShadowSettings[1];
+        context.shadowOffsetY = prevShadowSettings[2];
+        context.shadowBlur = prevShadowSettings[3];
+    }
+    if (renderInfo.cutSx || renderInfo.cutSy) {
+        context.translate(renderInfo.cutSx, renderInfo.cutSy);
+    }
+};
+//# sourceMappingURL=draw.js.map

package/dist/src/core/text-rendering/canvas/draw.js.map

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

package/dist/src/core/text-rendering/sdf/PeekableGenerator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A wrapper Generator class that makes a generator peekable.
+ */
+export declare class PeekableIterator<T = unknown, TReturn = any, TNext = unknown> implements Iterator<T, TReturn, TNext> {
+    private iterator;
+    private peekBuffer;
+    private _lastIndex;
+    constructor(iterator: Iterator<T, TReturn, TNext>, indexBase?: number);
+    next(): IteratorResult<T, TReturn>;
+    peek(): IteratorResult<T, TReturn>;
+    get lastIndex(): number;
+}

package/dist/src/core/text-rendering/sdf/PeekableGenerator.js

@@ -0,0 +1,61 @@
+/*
+ * 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.
+ */
+/**
+ * A wrapper Generator class that makes a generator peekable.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class PeekableIterator {
+    iterator;
+    peekBuffer = [];
+    _lastIndex = -1;
+    constructor(iterator, indexBase = 0) {
+        this.iterator = iterator;
+        this.iterator = iterator;
+        this._lastIndex = indexBase - 1;
+        this.peekBuffer = [];
+    }
+    next() {
+        const nextResult = this.peekBuffer.length > 0
+            ? // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                this.peekBuffer.pop()
+            : this.iterator.next();
+        if (nextResult.done === true) {
+            this._lastIndex = -1;
+        }
+        else {
+            this._lastIndex++;
+        }
+        return nextResult;
+    }
+    peek() {
+        if (this.peekBuffer.length > 0) {
+            // We know that the buffer is not empty, so we can safely use the
+            // non-null assertion operator
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            return this.peekBuffer[0];
+        }
+        const result = this.iterator.next();
+        this.peekBuffer.push(result);
+        return result;
+    }
+    get lastIndex() {
+        return this._lastIndex;
+    }
+}
+//# sourceMappingURL=PeekableGenerator.js.map

package/dist/src/core/text-rendering/sdf/PeekableGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeekableGenerator.js","sourceRoot":"","sources":["../../../../../src/core/text-rendering/sdf/PeekableGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,8DAA8D;AAC9D,MAAM,OAAO,gBAAgB;IAMP;IAHZ,UAAU,GAAiC,EAAE,CAAC;IAC9C,UAAU,GAAG,CAAC,CAAC,CAAC;IAExB,YAAoB,QAAqC,EAAE,SAAS,GAAG,CAAC;QAApD,aAAQ,GAAR,QAAQ,CAA6B;QACvD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,IAAI;QACF,MAAM,UAAU,GACd,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,oEAAoE;gBACpE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAG;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3B,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,iEAAiE;YACjE,8BAA8B;YAC9B,oEAAoE;YACpE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/src/core/text-rendering/sdf/SimpleFontShaper.d.ts

@@ -0,0 +1,45 @@
+import type { PeekableIterator } from './PeekableGenerator.js';
+/**
+ * Minimal glyph info for performance-focused text shaping
+ */
+export interface SimpleGlyphInfo {
+    /**
+     * Whether the character was successfully mapped to a glyph
+     */
+    mapped: boolean;
+    /**
+     * Unicode codepoint
+     */
+    codepoint: number;
+    /**
+     * How much to advance horizontally after rendering this glyph
+     */
+    xAdvance: number;
+}
+/**
+ * Minimal font shaper properties
+ */
+export interface FontShaperProps {
+    /**
+     * Font family name
+     */
+    fontFamily: string;
+    /**
+     * Font size in pixels
+     */
+    fontSize: number;
+    /**
+     * Letter spacing in pixels
+     */
+    letterSpacing: number;
+}
+/**
+ * Functional font shaper interface
+ */
+export interface FontShaper {
+    shapeText: (props: FontShaperProps, codepoints: PeekableIterator<number>) => Generator<SimpleGlyphInfo, void>;
+}
+/**
+ * Create a simple SDF font shaper
+ */
+export declare const createSdfFontShaper: () => FontShaper;

package/dist/src/core/text-rendering/sdf/SimpleFontShaper.js

@@ -0,0 +1,69 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2025 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 * as SdfFontHandler from '../SdfFontHandler.js';
+/**
+ * Create a simple SDF font shaper
+ */
+export const createSdfFontShaper = () => ({
+    shapeText: function* (props, codepoints) {
+        // Host paths on top
+        const fontFamily = props.fontFamily;
+        const fontSize = props.fontSize;
+        const letterSpacing = props.letterSpacing;
+        const fontData = SdfFontHandler.getFontData(fontFamily);
+        if (fontData === null)
+            return;
+        const fontScale = fontSize / fontData.common.lineHeight;
+        let prevCodepoint = 0;
+        while (true) {
+            const result = codepoints.next();
+            if (result.done)
+                break;
+            const codepoint = result.value;
+            if (!codepoint)
+                continue;
+            // Get glyph data
+            const glyph = SdfFontHandler.getGlyph(fontFamily, codepoint);
+            if (glyph === null) {
+                yield {
+                    mapped: false,
+                    codepoint,
+                    xAdvance: 0,
+                };
+                continue;
+            }
+            // Calculate advance with kerning
+            let advance = glyph.xadvance * fontScale;
+            // Add kerning if there's a previous character
+            if (prevCodepoint !== 0) {
+                const kerning = SdfFontHandler.getKerning(fontFamily, prevCodepoint, codepoint);
+                advance += kerning * fontScale;
+            }
+            // Add letter spacing
+            advance += letterSpacing;
+            yield {
+                mapped: true,
+                codepoint,
+                xAdvance: advance,
+            };
+            prevCodepoint = codepoint;
+        }
+    },
+});
+//# sourceMappingURL=SimpleFontShaper.js.map

package/dist/src/core/text-rendering/sdf/SimpleFontShaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleFontShaper.js","sourceRoot":"","sources":["../../../../../src/core/text-rendering/sdf/SimpleFontShaper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAgDvD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAe,EAAE,CAAC,CAAC;IACpD,SAAS,EAAE,QAAQ,CAAC,EAClB,KAAsB,EACtB,UAAoC;QAEpC,oBAAoB;QACpB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAE1C,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO;QAE9B,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;QACxD,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM;YAEvB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;YAC/B,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,iBAAiB;YACjB,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC7D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM;oBACJ,MAAM,EAAE,KAAK;oBACb,SAAS;oBACT,QAAQ,EAAE,CAAC;iBACZ,CAAC;gBACF,SAAS;YACX,CAAC;YAED,iCAAiC;YACjC,IAAI,OAAO,GAAG,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC;YAEzC,8CAA8C;YAC9C,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CACvC,UAAU,EACV,aAAa,EACb,SAAS,CACV,CAAC;gBACF,OAAO,IAAI,OAAO,GAAG,SAAS,CAAC;YACjC,CAAC;YAED,qBAAqB;YACrB,OAAO,IAAI,aAAa,CAAC;YAEzB,MAAM;gBACJ,MAAM,EAAE,IAAI;gBACZ,SAAS;gBACT,QAAQ,EAAE,OAAO;aAClB,CAAC;YAEF,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

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

@@ -4,7 +4,7 @@
  * @module
  */
 export declare const EPSILON = 0.000001;
-export declare let ARRAY_TYPE: Float32ArrayConstructor | ArrayConstructor;
+export declare let ARRAY_TYPE: ArrayConstructor | Float32ArrayConstructor;
 export declare const RANDOM: () => number;
 export declare const ANGLE_ORDER = "zyx";
 export declare const setMatrixArrayType: (type: Float32ArrayConstructor | ArrayConstructor) => void;

package/dist/src/main-api/Renderer.d.ts

@@ -113,6 +113,21 @@ export interface RendererMainSettings {
      * @defaultValue `0` (disabled)
      */
     fpsUpdateInterval?: number;
+    /**
+     * Target FPS for the global render loop
+     *
+     * @remarks
+     * Controls the maximum frame rate of the entire rendering system.
+     * When set to 0, no throttling is applied (use display refresh rate).
+     * When set to a positive number, the global requestAnimationFrame loop
+     * will be throttled to this target FPS, affecting all animations and rendering.
+     *
+     * This provides global performance control for the entire application,
+     * useful for managing performance on lower-end devices.
+     *
+     * @defaultValue `0` (no throttling, use display refresh rate)
+     */
+    targetFPS?: number;
     /**
      * Include context call (i.e. WebGL) information in FPS updates
      *
@@ -493,5 +508,36 @@ export declare class RendererMain extends EventEmitter {
      * @param color - The color to set as the clear color.
      */
     setClearColor(color: number): void;
+    /**
+     * Gets the target FPS for the global render loop
+     *
+     * @returns The current target FPS (0 means no throttling)
+     *
+     * @remarks
+     * This controls the maximum frame rate of the entire rendering system.
+     * When 0, the system runs at display refresh rate.
+     */
+    get targetFPS(): number;
+    /**
+     * Sets the target FPS for the global render loop
+     *
+     * @param fps - The target FPS to set for the global render loop.
+     *              Set to 0 or a negative value to disable throttling.
+     *
+     * @remarks
+     * This setting affects the entire rendering system immediately.
+     * All animations, rendering, and frame updates will be throttled
+     * to this target FPS. Provides global performance control.
+     *
+     * @example
+     * ```typescript
+     * // Set global target to 30fps for better performance
+     * renderer.targetFPS = 30;
+     *
+     * // Disable global throttling (use display refresh rate)
+     * renderer.targetFPS = 0;
+     * ```
+     */
+    set targetFPS(fps: number);
 }
 export {};