@itwin/core-backend 5.1.0-dev.4 → 5.1.0-dev.41

package/lib/esm/annotations/FrameGeometry.js

@@ -0,0 +1,245 @@
+/*---------------------------------------------------------------------------------------------
+* 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 { BackgroundFill, ColorDef, FillDisplay } from "@itwin/core-common";
+import { Angle, AngleSweep, Arc3d, LineString3d, Loop, Path, Point3d, Vector2d } from "@itwin/core-geometry";
+/**
+ * Based on the frame style, this method will construct and append [[GeometryParams]] (for line style) and a [[Loop]] (for the frame shape) to the builder.
+ * @param builder that will be appended to in place
+ * @param category to which the frame belongs, used for the [[GeometryParams]].
+ * @param frame
+ * @param range to enclose with the frame
+ * @param transform that transform the range to world coordinates
+ * @returns `true` if any geometry was appended to the builder
+* @beta
+ */
+export function appendFrameToBuilder(builder, frame, range, transform, geomParams) {
+    if (undefined === frame.shape || frame.shape === "none") {
+        return false;
+    }
+    const params = geomParams.clone();
+    if (frame.fill === undefined) {
+        params.fillDisplay = FillDisplay.Never;
+    }
+    else if (frame.fill === "background") {
+        params.backgroundFill = BackgroundFill.Solid;
+        params.fillDisplay = FillDisplay.Blanking;
+    }
+    else if (frame.fill !== "subcategory") {
+        params.fillColor = ColorDef.fromJSON(frame.fill);
+        params.lineColor = params.fillColor;
+        params.fillDisplay = FillDisplay.Blanking;
+    }
+    if (frame.border !== "subcategory") {
+        params.lineColor = ColorDef.fromJSON(frame.border);
+        params.weight = frame.borderWeight;
+    }
+    const frameGeometry = computeFrame({ frame: frame.shape, range, transform });
+    if (!builder.appendGeometryParamsChange(params) || !builder.appendGeometryQuery(frameGeometry)) {
+        return false;
+    }
+    // The tile generator does not produce an outline for shapes with blanking fill. We must add the outline separately.
+    if (params.fillDisplay === FillDisplay.Blanking) {
+        const outlineParams = params.clone();
+        outlineParams.fillDisplay = FillDisplay.Never;
+        if (!builder.appendGeometryParamsChange(outlineParams) || !builder.appendGeometryQuery(frameGeometry)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Computes the frame geometry based on the provided frame shape and range.
+ * @returns a [Loop]($geometry) or [Path]($geometry) (if it's just a line) that represents the frame geometry
+ * @beta
+ */
+export function computeFrame(args) {
+    switch (args.frame) {
+        case "line": return computeLine(args.range, args.transform);
+        case "rectangle": return computeRectangle(args.range, args.transform);
+        case "circle": return computeCircle(args.range, args.transform);
+        case "equilateralTriangle": return computeTriangle(args.range, args.transform);
+        case "diamond": return computeDiamond(args.range, args.transform);
+        case "square": return computeSquare(args.range, args.transform);
+        case "pentagon": return computePolygon(5, args.range, args.transform, 90);
+        case "hexagon": return computePolygon(6, args.range, args.transform);
+        case "octagon": return computePolygon(8, args.range, args.transform, 180 / 8); // or pi/8 in radians
+        case "capsule": return computeCapsule(args.range, args.transform);
+        case "roundedRectangle": return computeRoundedRectangle(args.range, args.transform);
+        default: return computeRectangle(args.range, args.transform);
+    }
+}
+/**
+ * Computes points along the edges of the frame geometry based on the provided frame shape, range, and interval factors.
+ * These can be used for snapping or attaching leaders.
+ * @returns an array of [[Point3d]] that represent the points along the edges of the frame geometry. Returns `undefined` if the loop created by `computeFrame` is empty.
+ * @beta
+ */
+export function computeIntervalPoints({ frame, range, transform, lineIntervalFactor = 0.5, arcIntervalFactor = 0.25 }) {
+    const points = [];
+    const curves = computeFrame({ frame, range, transform }).collectCurvePrimitives(undefined, false, true);
+    curves.forEach((curve) => {
+        const end = curve instanceof Arc3d ? arcIntervalFactor : lineIntervalFactor;
+        for (let interval = 0; interval <= 1; interval += end) {
+            points.push(curve.fractionToPoint(interval));
+        }
+    });
+    return points;
+}
+/** Line - currently just adds an underline. Once we have leaders, this method may change. */
+const computeLine = (range, transform) => {
+    const points = [Point3d.create(range.low.x, range.low.y), Point3d.create(range.high.x, range.low.y)];
+    const frame = LineString3d.createPoints(points);
+    return Path.create(frame.cloneTransformed(transform));
+};
+/** Rectangle - simplest frame */
+const computeRectangle = (range, transform) => {
+    const points = range.corners3d(true);
+    const frame = LineString3d.createPoints(points);
+    return Loop.create(frame.cloneTransformed(transform));
+};
+/** Rounded Rectangle: each corner will be turned into an arc with the radius of the arc being the @param radiusFactor * the height (yLength) of the range */
+const computeRoundedRectangle = (range, transform, radiusFactor = 0.25) => {
+    const radius = range.yLength() * radiusFactor * Math.sqrt(2);
+    // We're going to circumscribe the range with our rounded edges. The corners of the range will fall on 45 degree angles.
+    const radiusOffsetFactor = range.yLength() * radiusFactor;
+    // These values are the origins of the circles
+    const inLeft = range.low.x + radiusOffsetFactor;
+    const inRight = range.high.x - radiusOffsetFactor;
+    const inBottom = range.low.y + radiusOffsetFactor;
+    const inTop = range.high.y - radiusOffsetFactor;
+    // These values exist on the circles
+    const exLeft = inLeft - radius;
+    const exRight = inRight + radius;
+    const exBottom = inBottom - radius;
+    const exTop = inTop + radius;
+    const q1 = AngleSweep.createStartEndDegrees(0, 90);
+    const q2 = AngleSweep.createStartEndDegrees(90, 180);
+    const q3 = AngleSweep.createStartEndDegrees(180, 270);
+    const q4 = AngleSweep.createStartEndDegrees(270, 360);
+    const curves = [
+        LineString3d.create([Point3d.create(inLeft, exTop), Point3d.create(inRight, exTop)]), // top
+        Arc3d.createXY(Point3d.create(inLeft, inTop), radius, q2), // top left
+        LineString3d.create([Point3d.create(exLeft, inBottom), Point3d.create(exLeft, inTop)]), // left
+        Arc3d.createXY(Point3d.create(inLeft, inBottom), radius, q3), // bottom left
+        LineString3d.create([Point3d.create(inLeft, exBottom), Point3d.create(inRight, exBottom)]), // bottom
+        Arc3d.createXY(Point3d.create(inRight, inBottom), radius, q4), // bottom right
+        LineString3d.create([Point3d.create(exRight, inBottom), Point3d.create(exRight, inTop)]), // right
+        Arc3d.createXY(Point3d.create(inRight, inTop), radius, q1), // top right
+    ];
+    return Loop.createArray(curves.map((curve) => curve.cloneTransformed(transform)));
+};
+/** Circle */
+const computeCircle = (range, transform) => {
+    const radius = range.low.distance(range.high) / 2;
+    const frame = Arc3d.createXY(Point3d.createFrom(range.center), radius);
+    return Loop.create(frame.cloneTransformed(transform));
+};
+/** Equilateral Triangle */
+const computeTriangle = (range, transform) => {
+    const xLength = range.xLength();
+    const yLength = range.yLength();
+    const center = range.center;
+    const points = [];
+    const magnitude = (xLength > yLength) ? (xLength * Math.sqrt(3) + yLength) / 2 : (yLength * Math.sqrt(3) + xLength) / 2;
+    const v1 = Vector2d.create(0, magnitude);
+    const vectors = [
+        v1, // top
+        v1.rotateXY(Angle.createDegrees(120)), // left
+        v1.rotateXY(Angle.createDegrees(240)), // right
+        v1 // top
+    ];
+    vectors.forEach((v) => {
+        points.push(Point3d.create(center.x + v.x, center.y + v.y));
+    });
+    const frame = LineString3d.createPoints(points);
+    return Loop.create(frame.cloneTransformed(transform));
+};
+/** Diamond (square rotated 45 degrees) */
+const computeDiamond = (range, transform) => {
+    const offset = (range.xLength() + range.yLength()) / 2;
+    const center = range.center;
+    const points = [
+        Point3d.createFrom({ x: center.x, y: center.y + offset }), // top
+        Point3d.createFrom({ x: center.x + offset, y: center.y }), // right
+        Point3d.createFrom({ x: center.x, y: center.y - offset }), // bottom
+        Point3d.createFrom({ x: center.x - offset, y: center.y }), // left
+        Point3d.createFrom({ x: center.x, y: center.y + offset }), // top
+    ];
+    const frame = LineString3d.createPoints(points);
+    return Loop.create(frame.cloneTransformed(transform));
+};
+/** Square */
+const computeSquare = (range, transform) => {
+    // Extend range
+    const xLength = range.xLength() / 2;
+    const yLength = range.yLength() / 2;
+    const center = range.center;
+    if (xLength > yLength) {
+        range.extendPoint({ x: center.x, y: center.y + xLength });
+        range.extendPoint({ x: center.x, y: center.y - xLength });
+    }
+    else {
+        range.extendPoint({ x: center.x + yLength, y: center.y });
+        range.extendPoint({ x: center.x - yLength, y: center.y });
+    }
+    const points = range.corners3d(true);
+    const frame = LineString3d.createPoints(points);
+    return Loop.create(frame.cloneTransformed(transform));
+};
+/** Capsule (or pill shape) */
+const computeCapsule = (range, transform) => {
+    const height = range.yLength();
+    const radius = height * (Math.sqrt(2) / 2);
+    // We're going to circumscribe the range with our rounded edges. The corners of the range will fall on 45 degree angles.
+    const radiusOffsetFactor = height / 2;
+    // These values are the origins of the circles
+    const inLeft = range.low.x + radiusOffsetFactor;
+    const inRight = range.high.x - radiusOffsetFactor;
+    const inBottom = range.low.y + radiusOffsetFactor;
+    const inTop = range.high.y - radiusOffsetFactor;
+    // These values exist on the circles
+    const exBottom = inBottom - radius;
+    const exTop = inTop + radius;
+    const leftHalfCircle = AngleSweep.createStartEndDegrees(90, 270);
+    const rightHalfCircle = AngleSweep.createStartEndDegrees(-90, 90);
+    const curves = [
+        LineString3d.create([Point3d.create(inLeft, exTop), Point3d.create(inRight, exTop)]), // top
+        Arc3d.createXY(Point3d.create(inLeft, range.center.y), radius, leftHalfCircle), // left
+        LineString3d.create([Point3d.create(inLeft, exBottom), Point3d.create(inRight, exBottom)]), // bottom
+        Arc3d.createXY(Point3d.create(inRight, range.center.y), radius, rightHalfCircle), // right
+    ];
+    return Loop.createArray(curves.map((curve) => curve.cloneTransformed(transform)));
+};
+/** Regular polygon with n sides: note, this a generic method that can be used to create any polygon, but the frame will not be as tightly encapsulating. */
+const computePolygon = (n, range, transform, angleOffset = 0) => {
+    // These are math terms: cspell:ignore inradius circumradius
+    if (n < 3)
+        throw new Error("A polygon must have at least 3 sides.");
+    // We're assuming the polygon is a regular polygon with `n` sides.
+    // The center of the polygon is the center of the range.
+    const center = range.center;
+    // The inradius is the distance from the center to the midpoint of each side of the polygon. On our range, this coincides with the distance from the center to one of its corners.
+    const inradius = range.low.distance(range.high) / 2;
+    // The circumradius is the distance from the center to each vertex of the polygon.
+    const circumradius = inradius / Math.cos(Math.PI / n);
+    // The exterior angles add up to 360 degrees.
+    const angleIncrement = 360 / n;
+    const vertices = [];
+    // Add a point for each vertex
+    for (let i = 0; i < n; i++) {
+        const angle = Angle.createDegrees(i * angleIncrement + angleOffset);
+        const vector = Vector2d.createPolar(circumradius, angle);
+        vertices.push(Point3d.create(center.x + vector.x, center.y + vector.y));
+    }
+    // Close the polygon
+    vertices.push(vertices[0]);
+    // Finally compute the loop!
+    const frame = LineString3d.createPoints(vertices);
+    return Loop.create(frame.cloneTransformed(transform));
+};
+//# sourceMappingURL=FrameGeometry.js.map

package/lib/esm/annotations/FrameGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameGeometry.js","sourceRoot":"","sources":["../../../src/annotations/FrameGeometry.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\n\nimport { BackgroundFill, ColorDef, ElementGeometry, FillDisplay, GeometryParams, TextAnnotationFrameShape, TextFrameStyleProps } from \"@itwin/core-common\";\nimport { Angle, AngleSweep, Arc3d, LineString3d, Loop, Path, Point3d, Range2d, Transform, Vector2d } from \"@itwin/core-geometry\";\n\n/**\n * Based on the frame style, this method will construct and append [[GeometryParams]] (for line style) and a [[Loop]] (for the frame shape) to the builder.\n * @param builder that will be appended to in place\n * @param category to which the frame belongs, used for the [[GeometryParams]].\n * @param frame\n * @param range to enclose with the frame\n * @param transform that transform the range to world coordinates\n * @returns `true` if any geometry was appended to the builder\n* @beta\n */\nexport function appendFrameToBuilder(builder: ElementGeometry.Builder, frame: TextFrameStyleProps, range: Range2d, transform: Transform, geomParams: GeometryParams): boolean {\n  if (undefined === frame.shape || frame.shape === \"none\") {\n    return false;\n  }\n\n  const params = geomParams.clone();\n\n  if (frame.fill === undefined) {\n    params.fillDisplay = FillDisplay.Never;\n  } else if (frame.fill === \"background\") {\n    params.backgroundFill = BackgroundFill.Solid;\n    params.fillDisplay = FillDisplay.Blanking;\n  } else if (frame.fill !== \"subcategory\") {\n    params.fillColor = ColorDef.fromJSON(frame.fill);\n    params.lineColor = params.fillColor;\n    params.fillDisplay = FillDisplay.Blanking;\n  }\n\n  if (frame.border !== \"subcategory\") {\n    params.lineColor = ColorDef.fromJSON(frame.border);\n    params.weight = frame.borderWeight;\n  }\n\n  const frameGeometry = computeFrame({ frame: frame.shape, range, transform });\n  if (!builder.appendGeometryParamsChange(params) || !builder.appendGeometryQuery(frameGeometry)) {\n    return false;\n  }\n\n  // The tile generator does not produce an outline for shapes with blanking fill. We must add the outline separately.\n  if (params.fillDisplay === FillDisplay.Blanking) {\n    const outlineParams = params.clone();\n    outlineParams.fillDisplay = FillDisplay.Never;\n    if (!builder.appendGeometryParamsChange(outlineParams) || !builder.appendGeometryQuery(frameGeometry)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Arguments for the [[computeFrame]] method.\n * @beta\n */\nexport interface ComputeFrameArgs {\n  /** Frame shape to be calculated */\n  frame: Exclude<TextAnnotationFrameShape, \"none\">;\n  /** Range to be enclosed */\n  range: Range2d;\n  /** Transform that translates and rotates the range to world coordinates */\n  transform: Transform;\n}\n\n/**\n * Computes the frame geometry based on the provided frame shape and range.\n * @returns a [Loop]($geometry) or [Path]($geometry) (if it's just a line) that represents the frame geometry\n * @beta\n */\nexport function computeFrame(args: ComputeFrameArgs): Loop | Path {\n  switch (args.frame) {\n    case \"line\": return computeLine(args.range, args.transform);\n    case \"rectangle\": return computeRectangle(args.range, args.transform);\n    case \"circle\": return computeCircle(args.range, args.transform);\n    case \"equilateralTriangle\": return computeTriangle(args.range, args.transform);\n    case \"diamond\": return computeDiamond(args.range, args.transform);\n    case \"square\": return computeSquare(args.range, args.transform);\n    case \"pentagon\": return computePolygon(5, args.range, args.transform, 90);\n    case \"hexagon\": return computePolygon(6, args.range, args.transform);\n    case \"octagon\": return computePolygon(8, args.range, args.transform, 180 / 8); // or pi/8 in radians\n    case \"capsule\": return computeCapsule(args.range, args.transform);\n    case \"roundedRectangle\": return computeRoundedRectangle(args.range, args.transform);\n    default: return computeRectangle(args.range, args.transform);\n  }\n}\n\n/**\n * Arguments for the [[computeIntervalPoints]] method.\n * @beta\n */\nexport interface ComputeIntervalPointsArgs extends ComputeFrameArgs {\n  /** A factor applied to divide each straight edge. A value of 1 will place a single point on each vertex. */\n  lineIntervalFactor?: number;\n  /** A factor applied to divide each straight edge. A value of 1 will place a single point on each vertex. */\n  arcIntervalFactor?: number;\n}\n\n/**\n * Computes points along the edges of the frame geometry based on the provided frame shape, range, and interval factors.\n * These can be used for snapping or attaching leaders.\n * @returns an array of [[Point3d]] that represent the points along the edges of the frame geometry. Returns `undefined` if the loop created by `computeFrame` is empty.\n * @beta\n */\nexport function computeIntervalPoints({ frame, range, transform, lineIntervalFactor = 0.5, arcIntervalFactor = 0.25 }: ComputeIntervalPointsArgs): Point3d[] | undefined {\n  const points: Point3d[] = [];\n  const curves = computeFrame({ frame, range, transform }).collectCurvePrimitives(undefined, false, true);\n\n  curves.forEach((curve) => {\n    const end = curve instanceof Arc3d ? arcIntervalFactor : lineIntervalFactor;\n    for (let interval = 0; interval <= 1; interval += end) {\n      points.push(curve.fractionToPoint(interval));\n    }\n  });\n  return points;\n}\n\n/** Line - currently just adds an underline. Once we have leaders, this method may change. */\nconst computeLine = (range: Range2d, transform: Transform): Path => {\n  const points = [Point3d.create(range.low.x, range.low.y), Point3d.create(range.high.x, range.low.y)];\n  const frame = LineString3d.createPoints(points);\n\n  return Path.create(frame.cloneTransformed(transform));\n}\n\n/** Rectangle - simplest frame */\nconst computeRectangle = (range: Range2d, transform: Transform): Loop => {\n  const points = range.corners3d(true);\n  const frame = LineString3d.createPoints(points);\n\n  return Loop.create(frame.cloneTransformed(transform));\n}\n\n/** Rounded Rectangle: each corner will be turned into an arc with the radius of the arc being the @param radiusFactor * the height (yLength) of the range */\nconst computeRoundedRectangle = (range: Range2d, transform: Transform, radiusFactor: number = 0.25): Loop => {\n  const radius = range.yLength() * radiusFactor * Math.sqrt(2);\n  // We're going to circumscribe the range with our rounded edges. The corners of the range will fall on 45 degree angles.\n  const radiusOffsetFactor = range.yLength() * radiusFactor;\n\n  // These values are the origins of the circles\n  const inLeft = range.low.x + radiusOffsetFactor;\n  const inRight = range.high.x - radiusOffsetFactor;\n  const inBottom = range.low.y + radiusOffsetFactor;\n  const inTop = range.high.y - radiusOffsetFactor\n\n  // These values exist on the circles\n  const exLeft = inLeft - radius;\n  const exRight = inRight + radius;\n  const exBottom = inBottom - radius;\n  const exTop = inTop + radius;\n\n  const q1 = AngleSweep.createStartEndDegrees(0, 90);\n  const q2 = AngleSweep.createStartEndDegrees(90, 180);\n  const q3 = AngleSweep.createStartEndDegrees(180, 270);\n  const q4 = AngleSweep.createStartEndDegrees(270, 360);\n\n\n  const curves = [\n    LineString3d.create([Point3d.create(inLeft, exTop), Point3d.create(inRight, exTop)]),         // top\n    Arc3d.createXY(Point3d.create(inLeft, inTop), radius, q2),                                    // top left\n    LineString3d.create([Point3d.create(exLeft, inBottom), Point3d.create(exLeft, inTop)]),       // left\n    Arc3d.createXY(Point3d.create(inLeft, inBottom), radius, q3),                                 // bottom left\n    LineString3d.create([Point3d.create(inLeft, exBottom), Point3d.create(inRight, exBottom)]),   // bottom\n    Arc3d.createXY(Point3d.create(inRight, inBottom), radius, q4),                                // bottom right\n    LineString3d.create([Point3d.create(exRight, inBottom), Point3d.create(exRight, inTop)]),     // right\n    Arc3d.createXY(Point3d.create(inRight, inTop), radius, q1),                                   // top right\n  ];\n\n  return Loop.createArray(curves.map((curve) => curve.cloneTransformed(transform)))\n}\n\n\n/** Circle */\nconst computeCircle = (range: Range2d, transform: Transform): Loop => {\n  const radius = range.low.distance(range.high) / 2;\n  const frame = Arc3d.createXY(Point3d.createFrom(range.center), radius);\n  return Loop.create(frame.cloneTransformed(transform));\n}\n\n/** Equilateral Triangle */\nconst computeTriangle = (range: Range2d, transform: Transform): Loop => {\n\n  const xLength = range.xLength();\n  const yLength = range.yLength();\n  const center = range.center;\n  const points: Point3d[] = [];\n\n  const magnitude = (xLength > yLength) ? (xLength * Math.sqrt(3) + yLength) / 2 : (yLength * Math.sqrt(3) + xLength) / 2;\n\n  const v1 = Vector2d.create(0, magnitude);\n  const vectors = [\n    v1,                                     // top\n    v1.rotateXY(Angle.createDegrees(120)),  // left\n    v1.rotateXY(Angle.createDegrees(240)),  // right\n    v1                                      // top\n  ];\n\n  vectors.forEach((v) => {\n    points.push(Point3d.create(center.x + v.x, center.y + v.y));\n  });\n\n  const frame = LineString3d.createPoints(points);\n\n  return Loop.create(frame.cloneTransformed(transform));\n}\n\n/** Diamond (square rotated 45 degrees) */\nconst computeDiamond = (range: Range2d, transform: Transform): Loop => {\n  const offset = (range.xLength() + range.yLength()) / 2;\n  const center = range.center;\n\n  const points = [\n    Point3d.createFrom({ x: center.x, y: center.y + offset }), // top\n    Point3d.createFrom({ x: center.x + offset, y: center.y }), // right\n    Point3d.createFrom({ x: center.x, y: center.y - offset }), // bottom\n    Point3d.createFrom({ x: center.x - offset, y: center.y }), // left\n    Point3d.createFrom({ x: center.x, y: center.y + offset }), // top\n  ];\n\n  const frame = LineString3d.createPoints(points);\n\n  return Loop.create(frame.cloneTransformed(transform));\n}\n\n/** Square */\nconst computeSquare = (range: Range2d, transform: Transform): Loop => {\n\n  // Extend range\n  const xLength = range.xLength() / 2;\n  const yLength = range.yLength() / 2;\n  const center = range.center;\n  if (xLength > yLength) {\n    range.extendPoint({ x: center.x, y: center.y + xLength });\n    range.extendPoint({ x: center.x, y: center.y - xLength });\n  } else {\n    range.extendPoint({ x: center.x + yLength, y: center.y });\n    range.extendPoint({ x: center.x - yLength, y: center.y });\n  }\n\n  const points = range.corners3d(true);\n  const frame = LineString3d.createPoints(points);\n\n  return Loop.create(frame.cloneTransformed(transform));\n}\n\n/** Capsule (or pill shape) */\nconst computeCapsule = (range: Range2d, transform: Transform): Loop => {\n  const height = range.yLength();\n  const radius = height * (Math.sqrt(2) / 2);\n\n  // We're going to circumscribe the range with our rounded edges. The corners of the range will fall on 45 degree angles.\n  const radiusOffsetFactor = height / 2;\n\n  // These values are the origins of the circles\n  const inLeft = range.low.x + radiusOffsetFactor;\n  const inRight = range.high.x - radiusOffsetFactor;\n  const inBottom = range.low.y + radiusOffsetFactor;\n  const inTop = range.high.y - radiusOffsetFactor\n\n  // These values exist on the circles\n  const exBottom = inBottom - radius;\n  const exTop = inTop + radius;\n\n  const leftHalfCircle = AngleSweep.createStartEndDegrees(90, 270);\n  const rightHalfCircle = AngleSweep.createStartEndDegrees(-90, 90);\n\n  const curves = [\n    LineString3d.create([Point3d.create(inLeft, exTop), Point3d.create(inRight, exTop)]),       // top\n    Arc3d.createXY(Point3d.create(inLeft, range.center.y), radius, leftHalfCircle),             // left\n    LineString3d.create([Point3d.create(inLeft, exBottom), Point3d.create(inRight, exBottom)]), // bottom\n    Arc3d.createXY(Point3d.create(inRight, range.center.y), radius, rightHalfCircle),           // right\n  ];\n\n  return Loop.createArray(curves.map((curve) => curve.cloneTransformed(transform)));\n}\n\n/** Regular polygon with n sides: note, this a generic method that can be used to create any polygon, but the frame will not be as tightly encapsulating. */\nconst computePolygon = (n: number, range: Range2d, transform: Transform, angleOffset: number = 0): Loop => {\n  // These are math terms: cspell:ignore inradius circumradius\n  if (n < 3) throw new Error(\"A polygon must have at least 3 sides.\");\n\n  // We're assuming the polygon is a regular polygon with `n` sides.\n  // The center of the polygon is the center of the range.\n  const center = range.center;\n  // The inradius is the distance from the center to the midpoint of each side of the polygon. On our range, this coincides with the distance from the center to one of its corners.\n  const inradius = range.low.distance(range.high) / 2;\n  // The circumradius is the distance from the center to each vertex of the polygon.\n  const circumradius = inradius / Math.cos(Math.PI / n);\n\n  // The exterior angles add up to 360 degrees.\n  const angleIncrement = 360 / n;\n  const vertices: Point3d[] = [];\n\n  // Add a point for each vertex\n  for (let i = 0; i < n; i++) {\n    const angle = Angle.createDegrees(i * angleIncrement + angleOffset);\n    const vector = Vector2d.createPolar(circumradius, angle);\n    vertices.push(Point3d.create(center.x + vector.x, center.y + vector.y));\n  }\n\n  // Close the polygon\n  vertices.push(vertices[0]);\n\n  // Finally compute the loop!\n  const frame = LineString3d.createPoints(vertices);\n  return Loop.create(frame.cloneTransformed(transform));\n};"]}

package/lib/esm/{TextAnnotationElement.d.ts → annotations/TextAnnotationElement.d.ts}

@@ -2,13 +2,12 @@
  * @module Elements
  */
 import { TextAnnotation, TextAnnotation2dProps, TextAnnotation3dProps } from "@itwin/core-common";
-import { IModelDb } from "./IModelDb";
-import { AnnotationElement2d, GraphicalElement3d } from "./Element";
-import { Id64String } from "@itwin/core-bentley";
+import { IModelDb } from "../IModelDb";
+import { AnnotationElement2d, GraphicalElement3d } from "../Element";
 /** An element that displays textual content within a 2d model.
  * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.
  * @see [[setAnnotation]] to change the textual content.
- * @public
+ * @public @preview
  */
 export declare class TextAnnotation2d extends AnnotationElement2d {
     /** @internal */
@@ -23,15 +22,13 @@ export declare class TextAnnotation2d extends AnnotationElement2d {
     /** Change the textual content, updating the element's geometry and placement accordingly.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
-     * @param subCategory If specified, the subcategory on which to define the geometry; otherwise, the default subcategory of the element's category is used.
-     * @returns true if the annotation was successfully updated.
      */
-    setAnnotation(annotation: TextAnnotation, subCategory?: Id64String): boolean;
+    setAnnotation(annotation: TextAnnotation): void;
 }
 /** An element that displays textual content within a 3d model.
  * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.
  * @see [[setAnnotation]] to change the textual content.
- * @public
+ * @public @preview
  */
 export declare class TextAnnotation3d extends GraphicalElement3d {
     /** @internal */
@@ -46,9 +43,7 @@ export declare class TextAnnotation3d extends GraphicalElement3d {
     /** Change the textual content, updating the element's geometry and placement accordingly.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
-     * @param subCategory If specified, the subcategory on which to define the geometry; otherwise, the default subcategory of the element's category is used.
-     * @returns true if the annotation was successfully updated.
      */
-    setAnnotation(annotation: TextAnnotation, subCategory?: Id64String): boolean;
+    setAnnotation(annotation: TextAnnotation): void;
 }
 //# sourceMappingURL=TextAnnotationElement.d.ts.map

package/lib/esm/annotations/TextAnnotationElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextAnnotationElement.d.ts","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationElement.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAiE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAuB,MAAM,oBAAoB,CAAC;AACtL,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAcrE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,gBAAgB;IAChB,WAA2B,SAAS,IAAI,MAAM,CAA+B;IAC7E,SAAS,aAAa,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ;WAEtD,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,GAAG,gBAAgB;IAIxE,MAAM,IAAI,qBAAqB;IAO/C;;OAEG;IACI,aAAa,IAAI,cAAc,GAAG,SAAS;IAKlD;;;OAGG;IACI,aAAa,CAAC,UAAU,EAAE,cAAc;CAGhD;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD,gBAAgB;IAChB,WAA2B,SAAS,IAAI,MAAM,CAA+B;IAC7E,SAAS,aAAa,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ;WAEtD,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,GAAG,gBAAgB;IAIxE,MAAM,IAAI,qBAAqB;IAO/C;;OAEG;IACI,aAAa,IAAI,cAAc,GAAG,SAAS;IAKlD;;;OAGG;IACI,aAAa,CAAC,UAAU,EAAE,cAAc;CAGhD"}

package/lib/esm/{TextAnnotationElement.js → annotations/TextAnnotationElement.js}

@@ -5,27 +5,21 @@
 /** @packageDocumentation
  * @module Elements
  */
-import { GeometryParams, GeometryStreamBuilder, TextAnnotation } from "@itwin/core-common";
-import { AnnotationElement2d, GraphicalElement3d } from "./Element";
-import { produceTextAnnotationGeometry } from "./TextAnnotationGeometry";
-function updateAnnotation(element, annotation, subCategory) {
-    const builder = new GeometryStreamBuilder();
-    const params = new GeometryParams(element.category, subCategory);
-    if (!builder.appendGeometryParamsChange(params)) {
-        return false;
-    }
-    const props = produceTextAnnotationGeometry({ iModel: element.iModel, annotation });
-    if (!builder.appendTextBlock(props)) {
-        return false;
-    }
-    element.geom = builder.geometryStream;
-    element.jsonProperties.annotation = annotation.toJSON();
-    return true;
+import { ElementGeometry, TextAnnotation } from "@itwin/core-common";
+import { AnnotationElement2d, GraphicalElement3d } from "../Element";
+import { layoutTextBlock } from "./TextBlockLayout";
+import { appendTextAnnotationGeometry } from "./TextAnnotationGeometry";
+function getElementGeometryBuilderParams(iModel, _placementProps, annotationProps, categoryId, _subCategory) {
+    const textBlock = TextAnnotation.fromJSON(annotationProps).textBlock;
+    const layout = layoutTextBlock({ iModel, textBlock });
+    const builder = new ElementGeometry.Builder();
+    appendTextAnnotationGeometry({ layout, annotationProps, builder, categoryId });
+    return { entryArray: builder.entries };
 }
 /** An element that displays textual content within a 2d model.
  * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.
  * @see [[setAnnotation]] to change the textual content.
- * @public
+ * @public @preview
  */
 export class TextAnnotation2d extends AnnotationElement2d {
     /** @internal */
@@ -35,7 +29,9 @@ export class TextAnnotation2d extends AnnotationElement2d {
         return new TextAnnotation2d(props, iModel);
     }
     toJSON() {
-        return super.toJSON();
+        const props = super.toJSON();
+        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.placement, this.jsonProperties.annotation, this.category);
+        return props;
     }
     /** Extract the textual content, if present.
      * @see [[setAnnotation]] to change it.
@@ -47,17 +43,15 @@ export class TextAnnotation2d extends AnnotationElement2d {
     /** Change the textual content, updating the element's geometry and placement accordingly.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
-     * @param subCategory If specified, the subcategory on which to define the geometry; otherwise, the default subcategory of the element's category is used.
-     * @returns true if the annotation was successfully updated.
      */
-    setAnnotation(annotation, subCategory) {
-        return updateAnnotation(this, annotation, subCategory);
+    setAnnotation(annotation) {
+        this.jsonProperties.annotation = annotation.toJSON();
     }
 }
 /** An element that displays textual content within a 3d model.
  * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.
  * @see [[setAnnotation]] to change the textual content.
- * @public
+ * @public @preview
  */
 export class TextAnnotation3d extends GraphicalElement3d {
     /** @internal */
@@ -67,7 +61,9 @@ export class TextAnnotation3d extends GraphicalElement3d {
         return new TextAnnotation3d(props, iModel);
     }
     toJSON() {
-        return super.toJSON();
+        const props = super.toJSON();
+        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.placement, this.jsonProperties.annotation, this.category);
+        return props;
     }
     /** Extract the textual content, if present.
      * @see [[setAnnotation]] to change it.
@@ -79,11 +75,9 @@ export class TextAnnotation3d extends GraphicalElement3d {
     /** Change the textual content, updating the element's geometry and placement accordingly.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
-     * @param subCategory If specified, the subcategory on which to define the geometry; otherwise, the default subcategory of the element's category is used.
-     * @returns true if the annotation was successfully updated.
      */
-    setAnnotation(annotation, subCategory) {
-        return updateAnnotation(this, annotation, subCategory);
+    setAnnotation(annotation) {
+        this.jsonProperties.annotation = annotation.toJSON();
     }
 }
 //# sourceMappingURL=TextAnnotationElement.js.map

package/lib/esm/annotations/TextAnnotationElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextAnnotationElement.js","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationElement.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 Elements\n */\n\nimport { ElementGeometry, ElementGeometryBuilderParams, PlacementProps, TextAnnotation, TextAnnotation2dProps, TextAnnotation3dProps, TextAnnotationProps } from \"@itwin/core-common\";\nimport { IModelDb } from \"../IModelDb\";\nimport { AnnotationElement2d, GraphicalElement3d } from \"../Element\";\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { layoutTextBlock } from \"./TextBlockLayout\";\nimport { appendTextAnnotationGeometry } from \"./TextAnnotationGeometry\";\n\nfunction getElementGeometryBuilderParams(iModel: IModelDb, _placementProps: PlacementProps, annotationProps: TextAnnotationProps, categoryId: Id64String, _subCategory?: Id64String): ElementGeometryBuilderParams {\n  const textBlock = TextAnnotation.fromJSON(annotationProps).textBlock;\n  const layout = layoutTextBlock({ iModel, textBlock });\n  const builder = new ElementGeometry.Builder();\n  appendTextAnnotationGeometry({ layout, annotationProps, builder, categoryId })\n\n  return { entryArray: builder.entries };\n}\n\n/** An element that displays textual content within a 2d model.\n * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.\n * @see [[setAnnotation]] to change the textual content.\n * @public @preview\n */\nexport class TextAnnotation2d extends AnnotationElement2d {\n  /** @internal */\n  public static override get className(): string { return \"TextAnnotation2d\"; }\n  protected constructor(props: TextAnnotation2dProps, iModel: IModelDb) { super(props, iModel); }\n\n  public static fromJSON(props: TextAnnotation2dProps, iModel: IModelDb): TextAnnotation2d {\n    return new TextAnnotation2d(props, iModel);\n  }\n\n  public override toJSON(): TextAnnotation2dProps {\n    const props = super.toJSON();\n    props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.placement, this.jsonProperties.annotation, this.category);\n\n    return props;\n  }\n\n  /** Extract the textual content, if present.\n   * @see [[setAnnotation]] to change it.\n   */\n  public getAnnotation(): TextAnnotation | undefined {\n    const json = this.jsonProperties.annotation;\n    return json ? TextAnnotation.fromJSON(json) : undefined;\n  }\n\n  /** Change the textual content, updating the element's geometry and placement accordingly.\n   * @see [[getAnnotation]] to extract the current annotation.\n   * @param annotation The new annotation\n   */\n  public setAnnotation(annotation: TextAnnotation) {\n    this.jsonProperties.annotation = annotation.toJSON();\n  }\n}\n\n/** An element that displays textual content within a 3d model.\n * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.\n * @see [[setAnnotation]] to change the textual content.\n * @public @preview\n */\nexport class TextAnnotation3d extends GraphicalElement3d {\n  /** @internal */\n  public static override get className(): string { return \"TextAnnotation3d\"; }\n  protected constructor(props: TextAnnotation3dProps, iModel: IModelDb) { super(props, iModel); }\n\n  public static fromJSON(props: TextAnnotation3dProps, iModel: IModelDb): TextAnnotation3d {\n    return new TextAnnotation3d(props, iModel);\n  }\n\n  public override toJSON(): TextAnnotation3dProps {\n    const props = super.toJSON();\n    props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.placement, this.jsonProperties.annotation, this.category);\n\n    return props;\n  }\n\n  /** Extract the textual content, if present.\n   * @see [[setAnnotation]] to change it.\n   */\n  public getAnnotation(): TextAnnotation | undefined {\n    const json = this.jsonProperties.annotation;\n    return json ? TextAnnotation.fromJSON(json) : undefined;\n  }\n\n  /** Change the textual content, updating the element's geometry and placement accordingly.\n   * @see [[getAnnotation]] to extract the current annotation.\n   * @param annotation The new annotation\n   */\n  public setAnnotation(annotation: TextAnnotation) {\n    this.jsonProperties.annotation = annotation.toJSON();\n  }\n}\n"]}

package/lib/esm/annotations/TextAnnotationGeometry.d.ts

@@ -0,0 +1,31 @@
+/** @packageDocumentation
+ * @module ElementGeometry
+ */
+import { ElementGeometry, TextAnnotationProps } from "@itwin/core-common";
+import { TextBlockLayout } from "./TextBlockLayout";
+import { Id64String } from "@itwin/core-bentley";
+/**
+ * Properties required to compute the geometry of a text annotation.
+ * @beta
+ * @see [[appendTextAnnotationGeometry]] to append the geometry to an [[ElementGeometry.Builder]].
+ */
+export interface AppendTextAnnotationGeometryArgs {
+    /** The annotation to be drawn. Be sure to include a TextBlock with runs or no geometry will be produced. */
+    annotationProps: TextAnnotationProps;
+    /** Layout provided by calling [[layoutTextBlock]] */
+    layout: TextBlockLayout;
+    /** Builder that will be added to in place */
+    builder: ElementGeometry.Builder;
+    /** The category the element will belong to. This will passed into the [[GeometryParams]] */
+    categoryId: Id64String;
+    /** The optional sub-category the element will belong to. This will passed into the [[GeometryParams]] */
+    subCategoryId?: Id64String;
+    /** Whether or not to draw geometry for things like the snap points, range, and anchor point */
+    wantDebugGeometry?: boolean;
+}
+/** Constructs the TextBlockGeometry and frame geometry and appends the geometry to the provided builder.
+ * @returns true if the geometry was successfully appended.
+ * @beta
+ */
+export declare function appendTextAnnotationGeometry(props: AppendTextAnnotationGeometryArgs): boolean;
+//# sourceMappingURL=TextAnnotationGeometry.d.ts.map

package/lib/esm/annotations/TextAnnotationGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextAnnotationGeometry.d.ts","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationGeometry.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAY,eAAe,EAA+C,mBAAmB,EAAuB,MAAM,oBAAoB,CAAC;AACtJ,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAQ,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,4GAA4G;IAC5G,eAAe,EAAE,mBAAmB,CAAC;IACrC,qDAAqD;IACrD,MAAM,EAAE,eAAe,CAAC;IACxB,6CAA6C;IAC7C,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC;IACjC,4FAA4F;IAC5F,UAAU,EAAE,UAAU,CAAA;IACtB,yGAAyG;IACzG,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAuB7F"}

package/lib/esm/annotations/TextAnnotationGeometry.js

@@ -0,0 +1,80 @@
+/*---------------------------------------------------------------------------------------------
+* 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 { ColorDef, FillDisplay, GeometryParams, TextAnnotation } from "@itwin/core-common";
+import { LineString3d, PointString3d, Range2d } from "@itwin/core-geometry";
+import { Id64 } from "@itwin/core-bentley";
+import { produceTextBlockGeometry } from "./TextBlockGeometry";
+import { appendFrameToBuilder, computeIntervalPoints } from "./FrameGeometry";
+/** Constructs the TextBlockGeometry and frame geometry and appends the geometry to the provided builder.
+ * @returns true if the geometry was successfully appended.
+ * @beta
+ */
+export function appendTextAnnotationGeometry(props) {
+    const annotation = TextAnnotation.fromJSON(props.annotationProps);
+    const range = Range2d.fromJSON(props.layout.range);
+    const transform = annotation.computeTransform(range);
+    let result = true;
+    // Construct the TextBlockGeometry
+    const params = new GeometryParams(props.categoryId, props.subCategoryId);
+    const entries = produceTextBlockGeometry(props.layout, annotation.computeTransform(props.layout.range));
+    result = result && props.builder.appendTextBlock(entries, params);
+    // Construct the frame geometry
+    if (annotation.frame && annotation.frame.shape !== "none") {
+        result = result && appendFrameToBuilder(props.builder, annotation.frame, range, transform, params);
+    }
+    // Construct the debug geometry
+    if (props.wantDebugGeometry) {
+        result = result && debugAnchorPoint(props.builder, annotation, props.layout, annotation.computeTransform(props.layout.range));
+        if (annotation.frame)
+            result = result && debugSnapPoints(props.builder, annotation.frame, props.layout.range, annotation.computeTransform(props.layout.range));
+    }
+    return result;
+}
+;
+/**
+ * Draws the anchor point and margins of the text annotation.
+ * The anchor point is the point around which the text rotates and is drawn as a blue x (1m by 1m).
+ * The margins are drawn as a blue box.
+ * The text range is drawn as a red box.
+ */
+function debugAnchorPoint(builder, annotation, layout, transform) {
+    const range = Range2d.fromJSON(layout.range);
+    const debugAnchorPt = transform.multiplyPoint3d(annotation.computeAnchorPoint(range));
+    // Make it blue
+    const blueLineParams = new GeometryParams(Id64.invalid);
+    blueLineParams.lineColor = ColorDef.blue;
+    let result = builder.appendGeometryParamsChange(blueLineParams);
+    // Draw a blue box to show the element's margin
+    const marginCorners = range.corners3d(true);
+    transform.multiplyPoint3dArrayInPlace(marginCorners);
+    result = result && builder.appendGeometryQuery(LineString3d.create(marginCorners));
+    // Draw a blue x to show the anchor point - Rotation occurs around this point. The x will be 1 m by 1 m.
+    result = result && builder.appendGeometryQuery(LineString3d.create(debugAnchorPt.plusXYZ(-1, -1), debugAnchorPt.plusXYZ(1, 1)));
+    result = result && builder.appendGeometryQuery(LineString3d.create(debugAnchorPt.plusXYZ(1, -1), debugAnchorPt.plusXYZ(-1, 1)));
+    // Draw a red box to show the text range
+    const redLineParams = new GeometryParams(Id64.invalid);
+    redLineParams.lineColor = ColorDef.red;
+    result = result && builder.appendGeometryParamsChange(redLineParams);
+    const rangeCorners = layout.textRange.corners3d(true);
+    transform.multiplyPoint3dArrayInPlace(rangeCorners);
+    result = result && builder.appendGeometryQuery(LineString3d.create(rangeCorners));
+    return result;
+}
+/** Draws the interval points defined by calling [[computeIntervalPoints]]. The points are shown as black dots 5x larger than the borderWeight */
+function debugSnapPoints(builder, frame, range, transform) {
+    if (undefined === frame.shape || frame.shape === "none")
+        return false;
+    const points = computeIntervalPoints({ frame: frame.shape, range, transform, lineIntervalFactor: 0.5, arcIntervalFactor: 0.25 });
+    const params = new GeometryParams(Id64.invalid);
+    params.lineColor = ColorDef.black;
+    params.weight = (frame.borderWeight ?? 1) * 5; // We want the dots to be bigger than the frame so we can see them.
+    params.fillDisplay = FillDisplay.Always;
+    const result = builder.appendGeometryParamsChange(params) && builder.appendGeometryQuery(PointString3d.create(points));
+    return result;
+}
+//# sourceMappingURL=TextAnnotationGeometry.js.map

package/lib/esm/annotations/TextAnnotationGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextAnnotationGeometry.js","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationGeometry.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 { ColorDef, ElementGeometry, FillDisplay, GeometryParams, TextAnnotation, TextAnnotationProps, TextFrameStyleProps } from \"@itwin/core-common\";\nimport { TextBlockLayout } from \"./TextBlockLayout\";\nimport { LineString3d, PointString3d, Range2d, Transform } from \"@itwin/core-geometry\";\nimport { Id64, Id64String } from \"@itwin/core-bentley\";\nimport { produceTextBlockGeometry } from \"./TextBlockGeometry\";\nimport { appendFrameToBuilder, computeIntervalPoints } from \"./FrameGeometry\";\n\n/**\n * Properties required to compute the geometry of a text annotation.\n * @beta\n * @see [[appendTextAnnotationGeometry]] to append the geometry to an [[ElementGeometry.Builder]].\n */\nexport interface AppendTextAnnotationGeometryArgs {\n  /** The annotation to be drawn. Be sure to include a TextBlock with runs or no geometry will be produced. */\n  annotationProps: TextAnnotationProps;\n  /** Layout provided by calling [[layoutTextBlock]] */\n  layout: TextBlockLayout;\n  /** Builder that will be added to in place */\n  builder: ElementGeometry.Builder;\n  /** The category the element will belong to. This will passed into the [[GeometryParams]] */\n  categoryId: Id64String\n  /** The optional sub-category the element will belong to. This will passed into the [[GeometryParams]] */\n  subCategoryId?: Id64String\n  /** Whether or not to draw geometry for things like the snap points, range, and anchor point */\n  wantDebugGeometry?: boolean;\n}\n\n/** Constructs the TextBlockGeometry and frame geometry and appends the geometry to the provided builder.\n * @returns true if the geometry was successfully appended.\n * @beta\n */\nexport function appendTextAnnotationGeometry(props: AppendTextAnnotationGeometryArgs): boolean {\n  const annotation = TextAnnotation.fromJSON(props.annotationProps);\n  const range = Range2d.fromJSON(props.layout.range);\n  const transform = annotation.computeTransform(range);\n  let result = true;\n\n  // Construct the TextBlockGeometry\n  const params = new GeometryParams(props.categoryId, props.subCategoryId);\n  const entries = produceTextBlockGeometry(props.layout, annotation.computeTransform(props.layout.range));\n  result = result && props.builder.appendTextBlock(entries, params);\n\n  // Construct the frame geometry\n  if (annotation.frame && annotation.frame.shape !== \"none\") {\n    result = result && appendFrameToBuilder(props.builder, annotation.frame, range, transform, params);\n  }\n\n  // Construct the debug geometry\n  if (props.wantDebugGeometry) {\n    result = result && debugAnchorPoint(props.builder, annotation, props.layout, annotation.computeTransform(props.layout.range));\n    if (annotation.frame) result = result && debugSnapPoints(props.builder, annotation.frame, props.layout.range, annotation.computeTransform(props.layout.range));\n  }\n\n  return result;\n};\n\n/**\n * Draws the anchor point and margins of the text annotation.\n * The anchor point is the point around which the text rotates and is drawn as a blue x (1m by 1m).\n * The margins are drawn as a blue box.\n * The text range is drawn as a red box.\n */\nfunction debugAnchorPoint(builder: ElementGeometry.Builder, annotation: TextAnnotation, layout: TextBlockLayout, transform: Transform): boolean {\n  const range = Range2d.fromJSON(layout.range);\n  const debugAnchorPt = transform.multiplyPoint3d(annotation.computeAnchorPoint(range));\n\n  // Make it blue\n  const blueLineParams = new GeometryParams(Id64.invalid);\n  blueLineParams.lineColor = ColorDef.blue;\n  let result = builder.appendGeometryParamsChange(blueLineParams);\n\n  // Draw a blue box to show the element's margin\n  const marginCorners = range.corners3d(true);\n  transform.multiplyPoint3dArrayInPlace(marginCorners);\n  result = result && builder.appendGeometryQuery(LineString3d.create(marginCorners));\n\n  // Draw a blue x to show the anchor point - Rotation occurs around this point. The x will be 1 m by 1 m.\n  result = result && builder.appendGeometryQuery(LineString3d.create(debugAnchorPt.plusXYZ(-1, -1), debugAnchorPt.plusXYZ(1, 1)));\n  result = result && builder.appendGeometryQuery(LineString3d.create(debugAnchorPt.plusXYZ(1, -1), debugAnchorPt.plusXYZ(-1, 1)));\n\n  // Draw a red box to show the text range\n  const redLineParams = new GeometryParams(Id64.invalid);\n  redLineParams.lineColor = ColorDef.red;\n  result = result && builder.appendGeometryParamsChange(redLineParams);\n\n  const rangeCorners = layout.textRange.corners3d(true);\n  transform.multiplyPoint3dArrayInPlace(rangeCorners);\n  result = result && builder.appendGeometryQuery(LineString3d.create(rangeCorners));\n\n  return result;\n}\n\n/** Draws the interval points defined by calling [[computeIntervalPoints]]. The points are shown as black dots 5x larger than the borderWeight */\nfunction debugSnapPoints(builder: ElementGeometry.Builder, frame: TextFrameStyleProps, range: Range2d, transform: Transform): boolean {\n  if (undefined === frame.shape || frame.shape === \"none\")\n    return false;\n  const points = computeIntervalPoints({ frame: frame.shape, range, transform, lineIntervalFactor: 0.5, arcIntervalFactor: 0.25 });\n\n  const params = new GeometryParams(Id64.invalid);\n  params.lineColor = ColorDef.black;\n  params.weight = (frame.borderWeight ?? 1) * 5; // We want the dots to be bigger than the frame so we can see them.\n  params.fillDisplay = FillDisplay.Always;\n\n  const result = builder.appendGeometryParamsChange(params) && builder.appendGeometryQuery(PointString3d.create(points));\n  return result;\n}"]}

package/lib/esm/annotations/TextBlockGeometry.d.ts

@@ -0,0 +1,16 @@
+/** @packageDocumentation
+ * @module ElementGeometry
+ */
+import { TextBlockGeometryProps } from "@itwin/core-common";
+import { TextBlockLayout } from "./TextBlockLayout";
+import { Transform } from "@itwin/core-geometry";
+/**
+ * Produces the geometry for a text block in a way that can be interpreted by a [[GeometryStreamBuilder]] or [[ElementBuilder.Geometry]].
+ * To build the geometry for a whole [[TextAnnotation]], use [[appendTextAnnotationGeometry]] instead.
+ * @param layout of the text block as computed by [[layoutTextBlock]].
+ * @param documentTransform that positions the text block in world coordinates.
+ * @returns TextBlockGeometryProps.
+ * @beta
+ */
+export declare function produceTextBlockGeometry(layout: TextBlockLayout, documentTransform: Transform): TextBlockGeometryProps;
+//# sourceMappingURL=TextBlockGeometry.d.ts.map

package/lib/esm/annotations/TextBlockGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextBlockGeometry.d.ts","sourceRoot":"","sources":["../../../src/annotations/TextBlockGeometry.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAA2D,MAAM,oBAAoB,CAAC;AACrH,OAAO,EAAa,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAmC,SAAS,EAAY,MAAM,sBAAsB,CAAC;AAoH5F;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,GAAG,sBAAsB,CAqBtH"}