@itwin/core-backend 5.0.0-dev.90 → 5.0.0-dev.93

package/lib/esm/TextAnnotationLayout.js

@@ -0,0 +1,513 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ElementGeometry
+ */
+import { TextStyleSettings } from "@itwin/core-common";
+import { Geometry, Range2d } from "@itwin/core-geometry";
+import { assert } from "@itwin/core-bentley";
+import * as LineBreaker from "linebreak";
+/**
+ * Lays out the contents of a TextBlock into a series of lines containing runs.
+ * Each paragraph is decomposed into a series of lines.
+ * Each series of consecutive non-linebreak runs within a paragraph is concatenated into one line.
+ * If the document specifies a width > 0, individual lines are split to try to avoid exceeding that width.
+ * Individual TextRuns can be split onto multiple lines at word boundaries if necessary. Individual FractionRuns are never split.
+ * @see [[computeLayoutTextBlockResult]]
+ * @internal
+ */
+export function layoutTextBlock(args) {
+    const findFontId = args.findFontId ?? ((name, type) => args.iModel.fonts.findId({ name, type }) ?? 0);
+    const computeTextRange = args.computeTextRange ?? ((x) => args.iModel.computeRangesForText(x));
+    // ###TODO finding text styles in workspaces.
+    const findTextStyle = args.findTextStyle ?? (() => TextStyleSettings.fromJSON());
+    return new TextBlockLayout(args.textBlock, new LayoutContext(args.textBlock, computeTextRange, findTextStyle, findFontId));
+}
+/**
+ * Gets the result of laying out the the contents of a TextBlock into a series of lines containing runs.
+ * The visual layout accounts for the [TextStyle]($common)s, fonts, and [TextBlock.width]($common). It applies word-wrapping if needed.
+ * The layout returned matches the visual layout of the geometry produced by [[produceTextAnnotationGeometry]].
+ * @beta
+ */
+export function computeLayoutTextBlockResult(args) {
+    const layout = layoutTextBlock(args);
+    return layout.toResult();
+}
+;
+/**
+ * Computes the range from the start of a [RunLayoutResult]($common) to the trailing edge of each grapheme.
+ * It is the responsibility of the caller to determine the number and character indexes of the graphemes.
+ * @returns If the [RunLayoutResult]($common)'s source is a [TextRun]($common), it returns an array containing the range of each grapheme.
+ * Otherwise, it returns and empty array.
+ * @beta
+ */
+export function computeGraphemeOffsets(args) {
+    const { textBlock, paragraphIndex, runLayoutResult, graphemeCharIndexes, iModel } = args;
+    const findFontId = args.findFontId ?? ((name, type) => iModel.fonts.findId({ name, type }) ?? 0);
+    const computeTextRange = args.computeTextRange ?? ((x) => iModel.computeRangesForText(x));
+    const findTextStyle = args.findTextStyle ?? (() => TextStyleSettings.fromJSON());
+    const source = textBlock.paragraphs[paragraphIndex].runs[runLayoutResult.sourceRunIndex];
+    if (source.type !== "text" || runLayoutResult.characterCount === 0) {
+        return [];
+    }
+    const style = TextStyleSettings.fromJSON(runLayoutResult.textStyle);
+    const layoutContext = new LayoutContext(textBlock, computeTextRange, findTextStyle, findFontId);
+    const graphemeRanges = [];
+    graphemeCharIndexes.forEach((_, index) => {
+        const nextGraphemeCharIndex = graphemeCharIndexes[index + 1] ?? runLayoutResult.characterCount;
+        graphemeRanges.push(layoutContext.computeRangeForTextRun(style, source, runLayoutResult.characterOffset, nextGraphemeCharIndex).layout);
+    });
+    return graphemeRanges;
+}
+function scaleRange(range, scale) {
+    range.low.scaleInPlace(scale);
+    range.high.scaleInPlace(scale);
+}
+function applyBlockSettings(target, source) {
+    if (source === target) {
+        return target;
+    }
+    const lineSpacingFactor = source.lineSpacingFactor ?? target.lineSpacingFactor;
+    const lineHeight = source.lineHeight ?? target.lineHeight;
+    const widthFactor = source.widthFactor ?? target.widthFactor;
+    if (lineSpacingFactor !== target.lineSpacingFactor || lineHeight !== target.lineHeight || widthFactor !== target.widthFactor) {
+        target = target.clone({ lineSpacingFactor, lineHeight, widthFactor });
+    }
+    return target;
+}
+class LayoutContext {
+    _computeTextRange;
+    _findTextStyle;
+    _findFontId;
+    _textStyles = new Map();
+    _fontIds = new Map();
+    blockSettings;
+    constructor(block, _computeTextRange, _findTextStyle, _findFontId) {
+        this._computeTextRange = _computeTextRange;
+        this._findTextStyle = _findTextStyle;
+        this._findFontId = _findFontId;
+        const settings = this.findTextStyle(block.styleName);
+        this.blockSettings = applyBlockSettings(settings, block.styleOverrides);
+    }
+    findFontId(name) {
+        let fontId = this._fontIds.get(name);
+        if (undefined === fontId) {
+            this._fontIds.set(name, fontId = this._findFontId(name));
+        }
+        return fontId;
+    }
+    findTextStyle(name) {
+        let style = this._textStyles.get(name);
+        if (undefined === style) {
+            this._textStyles.set(name, style = this._findTextStyle(name));
+        }
+        return style;
+    }
+    createRunSettings(run) {
+        let settings = this.findTextStyle(run.styleName);
+        if (run.overridesStyle) {
+            settings = settings.clone(run.styleOverrides);
+        }
+        return applyBlockSettings(settings, this.blockSettings);
+    }
+    computeRangeForText(chars, style, baselineShift) {
+        if (chars.length === 0) {
+            return {
+                layout: new Range2d(0, 0, 0, style.lineHeight),
+                justification: new Range2d(),
+            };
+        }
+        const fontId = this.findFontId(style.fontName);
+        const { layout, justification } = this._computeTextRange({
+            chars,
+            fontId,
+            baselineShift,
+            bold: style.isBold,
+            italic: style.isItalic,
+            lineHeight: this.blockSettings.lineHeight,
+            widthFactor: this.blockSettings.widthFactor,
+        });
+        if ("none" !== baselineShift) {
+            const isSub = "subscript" === baselineShift;
+            const scale = isSub ? style.subScriptScale : style.superScriptScale;
+            const offsetFactor = isSub ? style.subScriptOffsetFactor : style.superScriptOffsetFactor;
+            const offset = { x: 0, y: style.lineHeight * offsetFactor };
+            scaleRange(layout, scale);
+            layout.cloneTranslated(offset, layout);
+            scaleRange(justification, scale);
+            justification.cloneTranslated(offset, justification);
+        }
+        return { layout, justification };
+    }
+    computeRangeForTextRun(style, run, charOffset, numChars) {
+        return this.computeRangeForText(run.content.substring(charOffset, charOffset + numChars), style, run.baselineShift);
+    }
+    computeRangeForFractionRun(style, source) {
+        const numerator = this.computeRangeForText(source.numerator, style, "none").layout;
+        scaleRange(numerator, style.stackedFractionScale);
+        const denominator = this.computeRangeForText(source.denominator, style, "none").layout;
+        scaleRange(denominator, style.stackedFractionScale);
+        const numLen = numerator.xLength();
+        const denomLen = denominator.xLength();
+        switch (style.stackedFractionType) {
+            case "horizontal": {
+                if (numLen > denomLen) {
+                    denominator.cloneTranslated({ x: (numLen - denomLen) / 2, y: 0 }, denominator);
+                }
+                else {
+                    numerator.cloneTranslated({ x: (denomLen - numLen) / 2, y: 0 }, numerator);
+                }
+                numerator.cloneTranslated({ x: 0, y: 1.5 * denominator.yLength() }, numerator);
+                break;
+            }
+            case "diagonal": {
+                numerator.cloneTranslated({ x: 0, y: denominator.yLength() }, numerator);
+                denominator.cloneTranslated({ x: numLen, y: 0 }, denominator);
+                break;
+            }
+        }
+        const layout = numerator.clone();
+        layout.extendRange(denominator);
+        return { layout, numerator, denominator };
+    }
+}
+function split(source) {
+    if (source.length === 0) {
+        return [];
+    }
+    let index = 0;
+    const segments = [];
+    const breaker = new LineBreaker(source);
+    for (let brk = breaker.nextBreak(); brk; brk = breaker.nextBreak()) {
+        segments.push({
+            segment: source.slice(index, brk.position),
+            index,
+        });
+        index = brk.position;
+    }
+    return segments;
+}
+/** @internal */
+export class RunLayout {
+    source;
+    charOffset;
+    numChars;
+    range;
+    justificationRange;
+    denominatorRange;
+    numeratorRange;
+    offsetFromLine;
+    style;
+    fontId;
+    constructor(props) {
+        this.source = props.source;
+        this.charOffset = props.charOffset;
+        this.numChars = props.numChars;
+        this.range = props.range;
+        this.justificationRange = props.justificationRange;
+        this.denominatorRange = props.denominatorRange;
+        this.numeratorRange = props.numeratorRange;
+        this.offsetFromLine = props.offsetFromLine;
+        this.style = props.style;
+        this.fontId = props.fontId;
+    }
+    static create(source, context) {
+        const style = context.createRunSettings(source);
+        const fontId = context.findFontId(style.fontName);
+        const charOffset = 0;
+        const offsetFromLine = { x: 0, y: 0 };
+        let numChars = 0;
+        let range, justificationRange, numeratorRange, denominatorRange;
+        switch (source.type) {
+            case "text": {
+                numChars = source.content.length;
+                const ranges = context.computeRangeForTextRun(style, source, charOffset, numChars);
+                range = ranges.layout;
+                justificationRange = ranges.justification;
+                break;
+            }
+            case "fraction": {
+                numChars = 1;
+                const ranges = context.computeRangeForFractionRun(style, source);
+                range = ranges.layout;
+                numeratorRange = ranges.numerator;
+                denominatorRange = ranges.denominator;
+                break;
+            }
+            default: {
+                // We do this so that blank lines space correctly without special casing later.
+                range = new Range2d(0, 0, 0, style.lineHeight);
+                break;
+            }
+        }
+        return new RunLayout({ source, charOffset, numChars, range, justificationRange, denominatorRange, numeratorRange, offsetFromLine, style, fontId });
+    }
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify() {
+        return this.source.type === "text" ? this.source.content.substring(this.charOffset, this.charOffset + this.numChars) : this.source.stringify();
+    }
+    canWrap() {
+        return this.source.type === "text";
+    }
+    cloneForWrap(args) {
+        assert(this.canWrap());
+        return new RunLayout({
+            ...this,
+            charOffset: args.charOffset,
+            numChars: args.numChars,
+            range: args.ranges.layout,
+            justificationRange: args.ranges.justification,
+            offsetFromLine: { ...this.offsetFromLine },
+        });
+    }
+    split(context) {
+        assert(this.charOffset === 0, "cannot re-split a run");
+        if (!this.canWrap() || this.charOffset > 0) {
+            return [this];
+        }
+        const myText = this.source.content.substring(this.charOffset, this.charOffset + this.numChars);
+        const segments = split(myText);
+        if (segments.length <= 1) {
+            return [this];
+        }
+        return segments.map((segment) => {
+            return this.cloneForWrap({
+                ranges: context.computeRangeForText(segment.segment, this.style, this.source.baselineShift),
+                charOffset: segment.index,
+                numChars: segment.segment.length,
+            });
+        });
+    }
+    toResult(paragraph) {
+        const result = {
+            sourceRunIndex: paragraph.runs.indexOf(this.source),
+            fontId: this.fontId,
+            characterOffset: this.charOffset,
+            characterCount: this.numChars,
+            range: this.range.toJSON(),
+            offsetFromLine: this.offsetFromLine,
+            textStyle: this.style.toJSON(),
+        };
+        if (this.justificationRange) {
+            result.justificationRange = this.justificationRange.toJSON();
+        }
+        if (this.numeratorRange) {
+            result.numeratorRange = this.numeratorRange.toJSON();
+        }
+        if (this.denominatorRange) {
+            result.denominatorRange = this.denominatorRange.toJSON();
+        }
+        return result;
+    }
+}
+/** @internal */
+export class LineLayout {
+    source;
+    range = new Range2d(0, 0, 0, 0);
+    justificationRange = new Range2d(0, 0, 0, 0);
+    offsetFromDocument = { x: 0, y: 0 };
+    _runs = [];
+    constructor(source) {
+        this.source = source;
+    }
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify() {
+        const runs = this._runs.map((run) => run.stringify());
+        return `${runs.join("")}`;
+    }
+    get runs() { return this._runs; }
+    get isEmpty() { return this._runs.length === 0; }
+    get back() {
+        assert(!this.isEmpty);
+        return this._runs[this._runs.length - 1];
+    }
+    append(run) {
+        this._runs.push(run);
+        this.computeRanges();
+    }
+    /** Invoked every time a run is appended,. */
+    computeRanges() {
+        this.range.low.setZero();
+        this.range.high.setZero();
+        // Some runs (fractions) are taller than others.
+        // We want to center each run vertically inside the line.
+        let lineHeight = 0;
+        for (const run of this._runs) {
+            lineHeight = Math.max(lineHeight, run.range.yLength());
+        }
+        for (const run of this._runs) {
+            const runHeight = run.range.yLength();
+            const runOffset = { x: this.range.high.x, y: (lineHeight - runHeight) / 2 };
+            run.offsetFromLine = runOffset;
+            const runLayoutRange = run.range.cloneTranslated(runOffset);
+            this.range.extendRange(runLayoutRange);
+            if ("linebreak" !== run.source.type) {
+                const runJustificationRange = run.justificationRange?.cloneTranslated(runOffset);
+                this.justificationRange.extendRange(runJustificationRange ?? runLayoutRange);
+            }
+        }
+    }
+    toResult(textBlock) {
+        return {
+            sourceParagraphIndex: textBlock.paragraphs.indexOf(this.source),
+            runs: this.runs.map((x) => x.toResult(this.source)),
+            range: this.range.toJSON(),
+            justificationRange: this.justificationRange.toJSON(),
+            offsetFromDocument: this.offsetFromDocument,
+        };
+    }
+}
+/**
+ * Describes the layout of a text block as a collection of lines containing runs.
+ * @internal
+ */
+export class TextBlockLayout {
+    source;
+    /** @internal: This is primarily for debugging purposes. This is the range of text geometry */
+    textRange = new Range2d();
+    /** The range including margins of the [[TextBlock]]. */
+    range = new Range2d();
+    lines = [];
+    _context;
+    constructor(source, context) {
+        this._context = context;
+        this.source = source;
+        if (source.width > 0) {
+            this.textRange.low.x = 0;
+            this.textRange.high.x = source.width;
+        }
+        this.populateLines(context);
+        this.justifyLines();
+        this.applyMargins(source.margins);
+    }
+    toResult() {
+        return {
+            lines: this.lines.map((x) => x.toResult(this.source)),
+            range: this.textRange.toJSON(),
+        };
+    }
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify() {
+        return this.lines.map((line) => line.stringify()).join("\n");
+    }
+    get _back() {
+        assert(this.lines.length > 0);
+        return this.lines[this.lines.length - 1];
+    }
+    populateLines(context) {
+        const doc = this.source;
+        if (doc.paragraphs.length === 0) {
+            return;
+        }
+        const doWrap = doc.width > 0;
+        let curLine = new LineLayout(doc.paragraphs[0]);
+        for (let i = 0; i < doc.paragraphs.length; i++) {
+            const paragraph = doc.paragraphs[i];
+            if (i > 0) {
+                curLine = this.flushLine(context, curLine, paragraph);
+            }
+            let runs = paragraph.runs.map((run) => RunLayout.create(run, context));
+            if (doWrap) {
+                runs = runs.map((run) => run.split(context)).flat();
+            }
+            for (const run of runs) {
+                if ("linebreak" === run.source.type) {
+                    curLine.append(run);
+                    curLine = this.flushLine(context, curLine);
+                    continue;
+                }
+                if (!doWrap) {
+                    curLine.append(run);
+                    continue;
+                }
+                const runWidth = run.range.xLength();
+                const lineWidth = curLine.range.xLength();
+                if (runWidth + lineWidth < doc.width || Geometry.isAlmostEqualNumber(runWidth + lineWidth, doc.width, Geometry.smallMetricDistance)) {
+                    curLine.append(run);
+                    continue;
+                }
+                if (curLine.runs.length === 0) {
+                    curLine.append(run);
+                    curLine = this.flushLine(context, curLine);
+                }
+                else {
+                    curLine = this.flushLine(context, curLine);
+                    curLine.append(run);
+                }
+            }
+        }
+        if (curLine.runs.length > 0) {
+            this.flushLine(context, curLine);
+        }
+    }
+    justifyLines() {
+        // We don't want to justify empty text, or a single line of text whose width is 0. By default text is already left justified.
+        if (this.lines.length < 1 || (this.lines.length === 1 && this.source.width === 0) || "left" === this.source.justification) {
+            return;
+        }
+        // This is the minimum width of the document's bounding box.
+        const docWidth = this.source.width;
+        let minOffset = Number.MAX_VALUE;
+        for (const line of this.lines) {
+            const lineWidth = line.justificationRange.xLength();
+            let offset = docWidth - lineWidth;
+            if ("center" === this.source.justification) {
+                offset = offset / 2;
+            }
+            line.offsetFromDocument.x += offset;
+            minOffset = Math.min(offset, minOffset);
+        }
+        if (minOffset < 0) {
+            // Shift left to accommodate lines that exceeded the document's minimum width.
+            this.textRange.low.x += minOffset;
+            this.textRange.high.x += minOffset;
+        }
+    }
+    flushLine(context, line, nextParagraph) {
+        nextParagraph = nextParagraph ?? line.source;
+        // We want to guarantee that each layout line has at least one run.
+        if (line.runs.length === 0) {
+            // If we're empty, there should always be a preceding run, and it should be a line break.
+            if (this.lines.length === 0 || this._back.runs.length === 0) {
+                return new LineLayout(nextParagraph);
+            }
+            const prevRun = this._back.back.source;
+            assert(prevRun.type === "linebreak");
+            if (prevRun.type !== "linebreak") {
+                return new LineLayout(nextParagraph);
+            }
+            line.append(RunLayout.create(prevRun.clone(), context));
+        }
+        // Line origin is its baseline.
+        const lineOffset = { x: 0, y: -line.range.yLength() };
+        // Place it below any existing lines
+        if (this.lines.length > 0) {
+            lineOffset.y += this._back.offsetFromDocument.y;
+            lineOffset.y -= context.blockSettings.lineSpacingFactor * context.blockSettings.lineHeight;
+        }
+        line.offsetFromDocument = lineOffset;
+        // Update document range from computed line range and position
+        this.textRange.extendRange(line.range.cloneTranslated(lineOffset));
+        this.lines.push(line);
+        return new LineLayout(nextParagraph);
+    }
+    applyMargins(margins) {
+        this.range = this.textRange.clone();
+        if (this.range.isNull)
+            return;
+        // Disregard negative margins.
+        const right = margins.right >= 0 ? margins.right : 0;
+        const left = margins.left >= 0 ? margins.left : 0;
+        const top = margins.top >= 0 ? margins.top : 0;
+        const bottom = margins.bottom >= 0 ? margins.bottom : 0;
+        const xHigh = this.textRange.high.x + right;
+        const yHigh = this.textRange.high.y + top;
+        const xLow = this.textRange.low.x - left;
+        const yLow = this.textRange.low.y - bottom;
+        this.range.extendXY(xHigh, yHigh);
+        this.range.extendXY(xLow, yLow);
+    }
+}
+//# sourceMappingURL=TextAnnotationLayout.js.map

package/lib/esm/TextAnnotationLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextAnnotationLayout.js","sourceRoot":"","sources":["../../src/TextAnnotationLayout.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module ElementGeometry\n */\n\nimport { BaselineShift, FontId, FontType, FractionRun, LineLayoutResult, Paragraph, Run, RunLayoutResult, TextBlock, TextBlockLayoutResult, TextBlockMargins, TextRun, TextStyleSettings, TextStyleSettingsProps } from \"@itwin/core-common\";\nimport { Geometry, Range2d } from \"@itwin/core-geometry\";\nimport { IModelDb } from \"./IModelDb\";\nimport { assert, NonFunctionPropertiesOf } from \"@itwin/core-bentley\";\nimport * as LineBreaker from \"linebreak\";\n\n/** @internal */\nexport interface TextLayoutRanges {\n  layout: Range2d;\n  justification: Range2d;\n}\n\n/** Arguments to [[ComputeRangesForTextLayout]].\n * @internal\n */\nexport interface ComputeRangesForTextLayoutArgs {\n  chars: string;\n  bold: boolean;\n  italic: boolean;\n  baselineShift: BaselineShift;\n  fontId: FontId;\n  widthFactor: number;\n  lineHeight: number;\n}\n\n/** A function that uses a font to compute the layout and justification ranges of a string of text.\n * @internal\n */\nexport type ComputeRangesForTextLayout = (args: ComputeRangesForTextLayoutArgs) => TextLayoutRanges;\n\n/** A function that looks up the font Id corresponding to a [FontFamilyDescriptor]($common).\n * If no type is provided, the function can return a font of any type matching `name` (there may be more than one, of different types).\n * @internal\n */\nexport type FindFontId = (name: string, type?: FontType) => FontId;\n\n/** @internal */\nexport type FindTextStyle = (name: string) => TextStyleSettings;\n\n/**\n * Arguments supplied to [[computeLayoutTextBlockResult]].\n * @beta\n */\nexport interface LayoutTextBlockArgs {\n  /** The text block whose extents are to be computed. */\n  textBlock: TextBlock;\n  /** The iModel from which to obtain fonts and [TextStyle]($common)s when laying out glyphs. */\n  iModel: IModelDb;\n  /** @internal chiefly for tests, by default uses IModelJsNative.DgnDb.computeRangesForText. */\n  computeTextRange?: ComputeRangesForTextLayout;\n  /** @internal chiefly for tests, by default looks up styles from a workspace. */\n  findTextStyle?: FindTextStyle;\n  /** @internal chiefly for tests, by default uses IModelDb.fontMap. */\n  findFontId?: FindFontId;\n}\n\n/**\n * Lays out the contents of a TextBlock into a series of lines containing runs.\n * Each paragraph is decomposed into a series of lines.\n * Each series of consecutive non-linebreak runs within a paragraph is concatenated into one line.\n * If the document specifies a width > 0, individual lines are split to try to avoid exceeding that width.\n * Individual TextRuns can be split onto multiple lines at word boundaries if necessary. Individual FractionRuns are never split.\n * @see [[computeLayoutTextBlockResult]]\n * @internal\n */\nexport function layoutTextBlock(args: LayoutTextBlockArgs): TextBlockLayout {\n  const findFontId = args.findFontId ?? ((name, type) => args.iModel.fonts.findId({ name, type }) ?? 0);\n  const computeTextRange = args.computeTextRange ?? ((x) => args.iModel.computeRangesForText(x));\n\n  // ###TODO finding text styles in workspaces.\n  const findTextStyle = args.findTextStyle ?? (() => TextStyleSettings.fromJSON());\n\n  return new TextBlockLayout(args.textBlock, new LayoutContext(args.textBlock, computeTextRange, findTextStyle, findFontId));\n}\n\n/**\n * Gets the result of laying out the the contents of a TextBlock into a series of lines containing runs.\n * The visual layout accounts for the [TextStyle]($common)s, fonts, and [TextBlock.width]($common). It applies word-wrapping if needed.\n * The layout returned matches the visual layout of the geometry produced by [[produceTextAnnotationGeometry]].\n * @beta\n */\nexport function computeLayoutTextBlockResult(args: LayoutTextBlockArgs): TextBlockLayoutResult {\n  const layout = layoutTextBlock(args);\n  return layout.toResult();\n}\n\n/**\n * Arguments supplied to [[computeGraphemeOffsets]].\n * @beta\n */\nexport interface ComputeGraphemeOffsetsArgs extends LayoutTextBlockArgs {\n  /** The index of the [Paragraph]($common) in the text block that contains the run layout result text. */\n  paragraphIndex: number;\n  /** The run layout result for which grapheme ranges will be computed. */\n  runLayoutResult: RunLayoutResult;\n  /** An array of starting character indexes for each grapheme. Each entry represents the index of the first character in a grapheme. */\n  graphemeCharIndexes: number[];\n};\n\n/**\n * Computes the range from the start of a [RunLayoutResult]($common) to the trailing edge of each grapheme.\n * It is the responsibility of the caller to determine the number and character indexes of the graphemes.\n * @returns If the [RunLayoutResult]($common)'s source is a [TextRun]($common), it returns an array containing the range of each grapheme.\n * Otherwise, it returns and empty array.\n * @beta\n */\nexport function computeGraphemeOffsets(args: ComputeGraphemeOffsetsArgs): Range2d[] {\n  const { textBlock, paragraphIndex, runLayoutResult, graphemeCharIndexes, iModel } = args;\n  const findFontId = args.findFontId ?? ((name, type) => iModel.fonts.findId({ name, type }) ?? 0);\n  const computeTextRange = args.computeTextRange ?? ((x) => iModel.computeRangesForText(x));\n  const findTextStyle = args.findTextStyle ?? (() => TextStyleSettings.fromJSON());\n  const source = textBlock.paragraphs[paragraphIndex].runs[runLayoutResult.sourceRunIndex];\n\n  if (source.type !== \"text\" || runLayoutResult.characterCount === 0) {\n    return [];\n  }\n\n  const style = TextStyleSettings.fromJSON(runLayoutResult.textStyle);\n\n  const layoutContext = new LayoutContext(textBlock, computeTextRange, findTextStyle, findFontId);\n  const graphemeRanges: Range2d[] = [];\n\n  graphemeCharIndexes.forEach((_, index) => {\n    const nextGraphemeCharIndex = graphemeCharIndexes[index + 1] ?? runLayoutResult.characterCount;\n    graphemeRanges.push(layoutContext.computeRangeForTextRun(style, source, runLayoutResult.characterOffset, nextGraphemeCharIndex).layout);\n  });\n  return graphemeRanges;\n}\n\nfunction scaleRange(range: Range2d, scale: number): void {\n  range.low.scaleInPlace(scale);\n  range.high.scaleInPlace(scale);\n}\n\nfunction applyBlockSettings(target: TextStyleSettings, source: TextStyleSettings | TextStyleSettingsProps): TextStyleSettings {\n  if (source === target) {\n    return target;\n  }\n\n  const lineSpacingFactor = source.lineSpacingFactor ?? target.lineSpacingFactor;\n  const lineHeight = source.lineHeight ?? target.lineHeight;\n  const widthFactor = source.widthFactor ?? target.widthFactor;\n\n  if (lineSpacingFactor !== target.lineSpacingFactor || lineHeight !== target.lineHeight || widthFactor !== target.widthFactor) {\n    target = target.clone({ lineSpacingFactor, lineHeight, widthFactor });\n  }\n\n  return target;\n}\n\nclass LayoutContext {\n  private readonly _textStyles = new Map<string, TextStyleSettings>();\n  private readonly _fontIds = new Map<string, FontId>();\n  public readonly blockSettings: TextStyleSettings;\n\n  public constructor(block: TextBlock, private readonly _computeTextRange: ComputeRangesForTextLayout, private readonly _findTextStyle: FindTextStyle, private readonly _findFontId: FindFontId) {\n    const settings = this.findTextStyle(block.styleName);\n    this.blockSettings = applyBlockSettings(settings, block.styleOverrides);\n  }\n\n  public findFontId(name: string): FontId {\n    let fontId = this._fontIds.get(name);\n    if (undefined === fontId) {\n      this._fontIds.set(name, fontId = this._findFontId(name));\n    }\n\n    return fontId;\n  }\n\n  public findTextStyle(name: string): TextStyleSettings {\n    let style = this._textStyles.get(name);\n    if (undefined === style) {\n      this._textStyles.set(name, style = this._findTextStyle(name));\n    }\n\n    return style;\n  }\n\n  public createRunSettings(run: Run): TextStyleSettings {\n    let settings = this.findTextStyle(run.styleName);\n    if (run.overridesStyle) {\n      settings = settings.clone(run.styleOverrides);\n    }\n\n    return applyBlockSettings(settings, this.blockSettings);\n  }\n\n  public computeRangeForText(chars: string, style: TextStyleSettings, baselineShift: BaselineShift): TextLayoutRanges {\n    if (chars.length === 0) {\n      return {\n        layout: new Range2d(0, 0, 0, style.lineHeight),\n        justification: new Range2d(),\n      };\n    }\n\n    const fontId = this.findFontId(style.fontName);\n    const { layout, justification } = this._computeTextRange({\n      chars,\n      fontId,\n      baselineShift,\n      bold: style.isBold,\n      italic: style.isItalic,\n      lineHeight: this.blockSettings.lineHeight,\n      widthFactor: this.blockSettings.widthFactor,\n    });\n\n    if (\"none\" !== baselineShift) {\n      const isSub = \"subscript\" === baselineShift;\n      const scale = isSub ? style.subScriptScale : style.superScriptScale;\n      const offsetFactor = isSub ? style.subScriptOffsetFactor : style.superScriptOffsetFactor;\n      const offset = { x: 0, y: style.lineHeight * offsetFactor };\n\n      scaleRange(layout, scale);\n      layout.cloneTranslated(offset, layout);\n\n      scaleRange(justification, scale);\n      justification.cloneTranslated(offset, justification);\n    }\n\n    return { layout, justification };\n  }\n\n  public computeRangeForTextRun(style: TextStyleSettings, run: TextRun, charOffset: number, numChars: number): TextLayoutRanges {\n    return this.computeRangeForText(run.content.substring(charOffset, charOffset + numChars), style, run.baselineShift);\n  }\n\n  public computeRangeForFractionRun(style: TextStyleSettings, source: FractionRun): { layout: Range2d, numerator: Range2d, denominator: Range2d } {\n    const numerator = this.computeRangeForText(source.numerator, style, \"none\").layout;\n    scaleRange(numerator, style.stackedFractionScale);\n\n    const denominator = this.computeRangeForText(source.denominator, style, \"none\").layout;\n    scaleRange(denominator, style.stackedFractionScale);\n\n    const numLen = numerator.xLength();\n    const denomLen = denominator.xLength();\n    switch (style.stackedFractionType) {\n      case \"horizontal\": {\n        if (numLen > denomLen) {\n          denominator.cloneTranslated({ x: (numLen - denomLen) / 2, y: 0 }, denominator);\n        } else {\n          numerator.cloneTranslated({ x: (denomLen - numLen) / 2, y: 0 }, numerator);\n        }\n\n        numerator.cloneTranslated({ x: 0, y: 1.5 * denominator.yLength() }, numerator);\n        break;\n      }\n      case \"diagonal\": {\n        numerator.cloneTranslated({ x: 0, y: denominator.yLength() }, numerator);\n        denominator.cloneTranslated({ x: numLen, y: 0 }, denominator);\n        break;\n      }\n    }\n\n    const layout = numerator.clone();\n    layout.extendRange(denominator);\n    return { layout, numerator, denominator };\n  }\n}\n\ninterface Segment {\n  segment: string;\n  index: number;\n}\n\nfunction split(source: string): Segment[] {\n  if (source.length === 0) {\n    return [];\n  }\n\n  let index = 0;\n  const segments: Segment[] = [];\n  const breaker = new LineBreaker(source);\n  for (let brk = breaker.nextBreak(); brk; brk = breaker.nextBreak()) {\n    segments.push({\n      segment: source.slice(index, brk.position),\n      index,\n    });\n\n    index = brk.position;\n  }\n\n  return segments;\n}\n\n/** @internal */\nexport class RunLayout {\n  public source: Run;\n  public charOffset: number;\n  public numChars: number;\n  public range: Range2d;\n  public justificationRange?: Range2d;\n  public denominatorRange?: Range2d;\n  public numeratorRange?: Range2d;\n  public offsetFromLine: { x: number, y: number };\n  public style: TextStyleSettings;\n  public fontId: FontId;\n\n  private constructor(props: NonFunctionPropertiesOf<RunLayout>) {\n    this.source = props.source;\n    this.charOffset = props.charOffset;\n    this.numChars = props.numChars;\n    this.range = props.range;\n    this.justificationRange = props.justificationRange;\n    this.denominatorRange = props.denominatorRange;\n    this.numeratorRange = props.numeratorRange;\n    this.offsetFromLine = props.offsetFromLine;\n    this.style = props.style;\n    this.fontId = props.fontId;\n  }\n\n  public static create(source: Run, context: LayoutContext): RunLayout {\n    const style = context.createRunSettings(source);\n    const fontId = context.findFontId(style.fontName);\n    const charOffset = 0;\n    const offsetFromLine = { x: 0, y: 0 };\n    let numChars = 0;\n\n    let range, justificationRange, numeratorRange, denominatorRange;\n\n    switch (source.type) {\n      case \"text\": {\n        numChars = source.content.length;\n        const ranges = context.computeRangeForTextRun(style, source, charOffset, numChars);\n        range = ranges.layout;\n        justificationRange = ranges.justification;\n        break;\n      }\n      case \"fraction\": {\n        numChars = 1;\n        const ranges = context.computeRangeForFractionRun(style, source);\n        range = ranges.layout;\n        numeratorRange = ranges.numerator;\n        denominatorRange = ranges.denominator;\n        break;\n      }\n      default: {\n        // We do this so that blank lines space correctly without special casing later.\n        range = new Range2d(0, 0, 0, style.lineHeight);\n        break;\n      }\n    }\n\n    return new RunLayout({ source, charOffset, numChars, range, justificationRange, denominatorRange, numeratorRange, offsetFromLine, style, fontId });\n  }\n\n  /** Compute a string representation, primarily for debugging purposes. */\n  public stringify(): string {\n    return this.source.type === \"text\" ? this.source.content.substring(this.charOffset, this.charOffset + this.numChars) : this.source.stringify();\n  }\n\n  public canWrap(): this is { source: TextRun } {\n    return this.source.type === \"text\";\n  }\n\n  private cloneForWrap(args: { ranges: TextLayoutRanges, charOffset: number, numChars: number }): RunLayout {\n    assert(this.canWrap());\n\n    return new RunLayout({\n      ...this,\n      charOffset: args.charOffset,\n      numChars: args.numChars,\n      range: args.ranges.layout,\n      justificationRange: args.ranges.justification,\n      offsetFromLine: { ...this.offsetFromLine },\n    });\n  }\n\n  public split(context: LayoutContext): RunLayout[] {\n    assert(this.charOffset === 0, \"cannot re-split a run\");\n    if (!this.canWrap() || this.charOffset > 0) {\n      return [this];\n    }\n\n    const myText = this.source.content.substring(this.charOffset, this.charOffset + this.numChars);\n    const segments = split(myText);\n\n    if (segments.length <= 1) {\n      return [this];\n    }\n\n    return segments.map((segment: any) => {\n      return this.cloneForWrap({\n        ranges: context.computeRangeForText(segment.segment, this.style, this.source.baselineShift),\n        charOffset: segment.index,\n        numChars: segment.segment.length,\n      });\n    });\n  }\n\n  public toResult(paragraph: Paragraph): RunLayoutResult {\n    const result: RunLayoutResult = {\n      sourceRunIndex: paragraph.runs.indexOf(this.source),\n      fontId: this.fontId,\n      characterOffset: this.charOffset,\n      characterCount: this.numChars,\n      range: this.range.toJSON(),\n      offsetFromLine: this.offsetFromLine,\n      textStyle: this.style.toJSON(),\n    };\n\n    if (this.justificationRange) {\n      result.justificationRange = this.justificationRange.toJSON();\n    }\n\n    if (this.numeratorRange) {\n      result.numeratorRange = this.numeratorRange.toJSON();\n    }\n\n    if (this.denominatorRange) {\n      result.denominatorRange = this.denominatorRange.toJSON();\n    }\n\n    return result;\n  }\n}\n\n/** @internal */\nexport class LineLayout {\n  public source: Paragraph;\n  public range = new Range2d(0, 0, 0, 0);\n  public justificationRange = new Range2d(0, 0, 0, 0);\n  public offsetFromDocument = { x: 0, y: 0 };\n  private _runs: RunLayout[] = [];\n\n  public constructor(source: Paragraph) {\n    this.source = source;\n  }\n\n  /** Compute a string representation, primarily for debugging purposes. */\n  public stringify(): string {\n    const runs = this._runs.map((run) => run.stringify());\n    return `${runs.join(\"\")}`;\n  }\n\n  public get runs(): ReadonlyArray<RunLayout> { return this._runs; }\n  public get isEmpty() { return this._runs.length === 0; }\n  public get back(): RunLayout {\n    assert(!this.isEmpty);\n    return this._runs[this._runs.length - 1];\n  }\n\n  public append(run: RunLayout): void {\n    this._runs.push(run);\n    this.computeRanges();\n  }\n\n  /** Invoked every time a run is appended,. */\n  private computeRanges(): void {\n    this.range.low.setZero();\n    this.range.high.setZero();\n\n    // Some runs (fractions) are taller than others.\n    // We want to center each run vertically inside the line.\n    let lineHeight = 0;\n    for (const run of this._runs) {\n      lineHeight = Math.max(lineHeight, run.range.yLength());\n    }\n\n    for (const run of this._runs) {\n      const runHeight = run.range.yLength();\n      const runOffset = { x: this.range.high.x, y: (lineHeight - runHeight) / 2 };\n      run.offsetFromLine = runOffset;\n\n      const runLayoutRange = run.range.cloneTranslated(runOffset);\n      this.range.extendRange(runLayoutRange);\n\n      if (\"linebreak\" !== run.source.type) {\n        const runJustificationRange = run.justificationRange?.cloneTranslated(runOffset);\n        this.justificationRange.extendRange(runJustificationRange ?? runLayoutRange);\n      }\n    }\n  }\n\n  public toResult(textBlock: TextBlock): LineLayoutResult {\n    return {\n      sourceParagraphIndex: textBlock.paragraphs.indexOf(this.source),\n      runs: this.runs.map((x) => x.toResult(this.source)),\n      range: this.range.toJSON(),\n      justificationRange: this.justificationRange.toJSON(),\n      offsetFromDocument: this.offsetFromDocument,\n    };\n  }\n}\n\n/**\n * Describes the layout of a text block as a collection of lines containing runs.\n * @internal\n */\nexport class TextBlockLayout {\n  public source: TextBlock;\n\n  /** @internal: This is primarily for debugging purposes. This is the range of text geometry */\n  public textRange = new Range2d();\n\n  /** The range including margins of the [[TextBlock]]. */\n  public range = new Range2d();\n  public lines: LineLayout[] = [];\n  private _context: LayoutContext;\n\n  public constructor(source: TextBlock, context: LayoutContext) {\n    this._context = context;\n    this.source = source;\n\n    if (source.width > 0) {\n      this.textRange.low.x = 0;\n      this.textRange.high.x = source.width;\n    }\n\n    this.populateLines(context);\n    this.justifyLines();\n    this.applyMargins(source.margins);\n  }\n\n  public toResult(): TextBlockLayoutResult {\n    return {\n      lines: this.lines.map((x) => x.toResult(this.source)),\n      range: this.textRange.toJSON(),\n    };\n  }\n\n  /** Compute a string representation, primarily for debugging purposes. */\n  public stringify(): string {\n    return this.lines.map((line) => line.stringify()).join(\"\\n\");\n  }\n\n  private get _back(): LineLayout {\n    assert(this.lines.length > 0);\n    return this.lines[this.lines.length - 1];\n  }\n\n  private populateLines(context: LayoutContext): void {\n    const doc = this.source;\n    if (doc.paragraphs.length === 0) {\n      return;\n    }\n\n    const doWrap = doc.width > 0;\n    let curLine = new LineLayout(doc.paragraphs[0]);\n    for (let i = 0; i < doc.paragraphs.length; i++) {\n      const paragraph = doc.paragraphs[i];\n      if (i > 0) {\n        curLine = this.flushLine(context, curLine, paragraph);\n      }\n\n      let runs = paragraph.runs.map((run) => RunLayout.create(run, context));\n      if (doWrap) {\n        runs = runs.map((run) => run.split(context)).flat();\n      }\n\n      for (const run of runs) {\n        if (\"linebreak\" === run.source.type) {\n          curLine.append(run);\n          curLine = this.flushLine(context, curLine);\n          continue;\n        }\n\n        if (!doWrap) {\n          curLine.append(run);\n          continue;\n        }\n\n        const runWidth = run.range.xLength();\n        const lineWidth = curLine.range.xLength();\n        if (runWidth + lineWidth < doc.width || Geometry.isAlmostEqualNumber(runWidth + lineWidth, doc.width, Geometry.smallMetricDistance)) {\n          curLine.append(run);\n          continue;\n        }\n\n        if (curLine.runs.length === 0) {\n          curLine.append(run);\n          curLine = this.flushLine(context, curLine);\n        } else {\n          curLine = this.flushLine(context, curLine);\n          curLine.append(run);\n        }\n      }\n    }\n\n    if (curLine.runs.length > 0) {\n      this.flushLine(context, curLine);\n    }\n  }\n\n  private justifyLines(): void {\n    // We don't want to justify empty text, or a single line of text whose width is 0. By default text is already left justified.\n    if (this.lines.length < 1 || (this.lines.length === 1 && this.source.width === 0) || \"left\" === this.source.justification) {\n      return;\n    }\n\n    // This is the minimum width of the document's bounding box.\n    const docWidth = this.source.width;\n\n    let minOffset = Number.MAX_VALUE;\n    for (const line of this.lines) {\n      const lineWidth = line.justificationRange.xLength();\n\n      let offset = docWidth - lineWidth;\n      if (\"center\" === this.source.justification) {\n        offset = offset / 2;\n      }\n\n      line.offsetFromDocument.x += offset;\n      minOffset = Math.min(offset, minOffset);\n    }\n\n    if (minOffset < 0) {\n      // Shift left to accommodate lines that exceeded the document's minimum width.\n      this.textRange.low.x += minOffset;\n      this.textRange.high.x += minOffset;\n    }\n  }\n\n  private flushLine(context: LayoutContext, line: LineLayout, nextParagraph?: Paragraph): LineLayout {\n    nextParagraph = nextParagraph ?? line.source;\n\n    // We want to guarantee that each layout line has at least one run.\n    if (line.runs.length === 0) {\n      // If we're empty, there should always be a preceding run, and it should be a line break.\n      if (this.lines.length === 0 || this._back.runs.length === 0) {\n        return new LineLayout(nextParagraph);\n      }\n\n      const prevRun = this._back.back.source;\n      assert(prevRun.type === \"linebreak\");\n      if (prevRun.type !== \"linebreak\") {\n        return new LineLayout(nextParagraph);\n      }\n\n      line.append(RunLayout.create(prevRun.clone(), context));\n    }\n\n    // Line origin is its baseline.\n    const lineOffset = { x: 0, y: -line.range.yLength() };\n\n    // Place it below any existing lines\n    if (this.lines.length > 0) {\n      lineOffset.y += this._back.offsetFromDocument.y;\n      lineOffset.y -= context.blockSettings.lineSpacingFactor * context.blockSettings.lineHeight;\n    }\n\n    line.offsetFromDocument = lineOffset;\n\n    // Update document range from computed line range and position\n    this.textRange.extendRange(line.range.cloneTranslated(lineOffset));\n\n    this.lines.push(line);\n    return new LineLayout(nextParagraph);\n  }\n\n  private applyMargins(margins: TextBlockMargins) {\n    this.range = this.textRange.clone();\n\n    if (this.range.isNull)\n      return;\n\n    // Disregard negative margins.\n    const right = margins.right >= 0 ? margins.right : 0;\n    const left = margins.left >= 0 ? margins.left : 0;\n    const top = margins.top >= 0 ? margins.top : 0;\n    const bottom = margins.bottom >= 0 ? margins.bottom : 0;\n\n    const xHigh = this.textRange.high.x + right;\n    const yHigh = this.textRange.high.y + top;\n    const xLow = this.textRange.low.x - left;\n    const yLow = this.textRange.low.y - bottom;\n\n    this.range.extendXY(xHigh, yHigh);\n    this.range.extendXY(xLow, yLow);\n  }\n}\n"]}

package/lib/esm/Texture.d.ts

@@ -0,0 +1,58 @@
+/** @packageDocumentation
+ * @module Elements
+ */
+import { Id64String } from "@itwin/core-bentley";
+import { Base64EncodedString, Code, CodeScopeProps, ImageSourceFormat, TextureProps } from "@itwin/core-common";
+import { DefinitionElement } from "./Element";
+import { IModelDb } from "./IModelDb";
+/** A [TextureProps]($common) in which the image data can be specified either as a base-64-encoded string or a Uint8Array.
+ * @see [[Texture]] constructor.
+ * @beta
+ */
+export interface TextureCreateProps extends Omit<TextureProps, "data"> {
+    data: Base64EncodedString | Uint8Array;
+}
+/** Defines a rendering texture that is associated with a Material and applied to surface geometry.
+ * @public
+ */
+export declare class Texture extends DefinitionElement {
+    /** @internal */
+    static get className(): string;
+    format: ImageSourceFormat;
+    data: Uint8Array;
+    description?: string;
+    /** @beta */
+    protected constructor(props: TextureCreateProps, iModel: IModelDb);
+    toJSON(): TextureProps;
+    /** Create a Code for a Texture given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     * @param iModel  The IModelDb
+     * @param scopeModelId The Id of the DefinitionModel that contains the Texture and provides the scope for its name.
+     * @param name The Texture name
+     */
+    static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code;
+    /** Create a texture with the given parameters.
+     * @param iModelDb The iModel to contain the texture.
+     * @param definitionModelId The [[DefinitionModel]] to contain the texture.
+     * @param name The name to serve as the texture's [Code]($common) value.
+     * @param format The format of the image data.
+     * @param data The image data in the format specified by `format`.
+     * @param description An optional description of the texture
+     * @returns The newly constructed Texture element.
+     * @throws [[IModelError]] if unable to create the element.
+     * @see [[insertTexture]] to insert a new texture into the iModel.
+     */
+    static createTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Texture;
+    /** Insert a new texture into a [[DefinitionModel]].
+     * @param iModelDb The iModel to contain the texture.
+     * @param definitionModelId The [[DefinitionModel]] to contain the texture.
+     * @param name The name to serve as the texture's [Code]($common) value.
+     * @param format The format of the image data.
+     * @param data The image data in the format specified by `format`.
+     * @param description An optional description of the texture
+     * @returns The Id of the newly-inserted texture element.
+     * @throws [[IModelError]] if unable to insert the element.
+     * @see [[insertTexture]] to insert a new texture into the iModel.
+     */
+    static insertTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String;
+}
+//# sourceMappingURL=Texture.d.ts.map