Defines visual styling for dimension nodes (Linear, Angular, Radial, Diametral). Connect to a dimension node's style input.

lineColor

lineThickness

extensionLineLength

arrowTailLength

textColor

textBackgroundColor

textBackgroundOpacity

arrowSize

showArrows

Dimension Style

style

## BeeGraphy Editor Dimensions Package

Dimension nodes for the BeeGraphy Editor. This package provides tools to measure and render dimension graphics (with labels and arrows) directly in the editor viewport.

### Usage

The nodes in this package help you visualize measurements (e.g., distances, angles, bounding boxes) between points and geometry. You can find them under the **Dimensions** group in the node palette or via search.

### Available Nodes

#### 1. Distance Dimension
Measures the distance between two 3D points and renders a labeled dimension graphic (extension lines, main line, optional arrows, and a text label).

* **Inputs:** `start`, `end`, `direction` (optional), `labelOffset` (0.2), `decimalPlaces` (2), `labelSuffix` ("mm"), `labelOverwrite`, `style`.
* **Outputs:** `curve` (ThreeCurve), `distance` (Number).

#### 2. Angular Dimension
Measures and visualizes the angle defined by a center point and two direction vectors. Draws an arc, arrowheads, and a text label.

* **Inputs:** `centerPoint`, `direction1`, `direction2`, `radius` (0.5), `labelOffset` (0.1), `decimalPlaces` (1), `labelSuffix` ("°"), `labelOverwrite`, `radians` (false), `style`.
* **Outputs:** `curve` (ThreeCurve), `angle` (Number).

#### 3. Radial Dimension
Measures radius or diameter from a center point to a radius point. Displays value with leader line, arrowhead, and optional center mark.

* **Inputs:** `centerPoint`, `radiusPoint`, `labelOffset` (0.2), `decimalPlaces` (2), `labelSuffix` ("mm"), `labelOverwrite`, `showDiameter` (false), `showCenterMark` (true), `style`.
* **Outputs:** `curve` (ThreeCurve), `radius`, `diameter`.

#### 4. Diametrical Dimension
Measures and visualizes a diameter with a specified direction. Draws diameter line with optional arrowheads and center mark.

* **Inputs:** `centerPoint`, `direction`, `diameter`, `labelOffset` (0.2), `decimalPlaces` (2), `labelSuffix` ("mm"), `labelOverwrite`, `showCenterMark` (true), `style`.
* **Outputs:** `curve` (ThreeCurve), `diameter`, `radius`.

#### 5. Dimension 2D
Measures and visualizes 2D bounding box dimensions of geometry. Shows width (X), height (Y), and optional diagonal.

* **Inputs:** `geometry`, `showWidth`, `showHeight`, `showDiagonal`, `labelOffset` (0.2), `decimalPlaces` (2), `labelSuffix` ("mm"), `labelOverwriteX/Y/Diag`, `style`.
* **Outputs:** `curve` (ThreeCurve), `width`, `height`, `diagonal`, `minPoint`, `maxPoint`.

#### 6. Dimension 3D
Measures and visualizes 3D bounding box dimensions of geometry. Shows width (X), length (Y), height (Z), and optional diagonal.

* **Inputs:** `geometry`, `showWidth`, `showLength`, `showHeight`, `showDiagonal`, `labelOffset` (0.2), `decimalPlaces` (2), `labelSuffix` ("mm"), `labelOverwriteX/Y/Z/Diag`, `style`.
* **Outputs:** `curve` (ThreeCurve), `width`, `length`, `height`, `diagonal`.

#### 7. Dimension Style
Produces a reusable style object to control the appearance of dimension graphics.

* **Inputs:** `lineColor`, `lineThickness` (0.01), `extensionLineLength` (0.1), `arrowTailLength` (0.2), `textColor`, `textSize` (16), `textBackgroundColor` (#000000), `textBackgroundOpacity` (0.9), `arrowSize` (0.05), `showArrows` (true).
* **Output:** `style` (Meta).

### Notes:

* **Distance Dimension** will automatically compute a perpendicular direction if `direction` is not provided.
* Label text can be fully overridden via `labelOverwrite`; include `{val}` to embed the computed value.

Dimensions

Package manager page.png

Package manager page light.png

Package manager page.svg

Package manager page light.svg

Dimension

Measures distance between two 3D points and displays a labeled dimension line

start

Optional direction to place the label and offset line (perpendicular to the measured segment).

direction

Distance between the measured line and the dimension label (and offset line).

labelOffset

Number of digits after the decimal point (0-6).

decimalPlaces

Units or suffix appended to the measurement value (e.g., mm, cm, m).

labelSuffix

Custom label text. If contains {val}, it will be replaced with computed distance.

labelOverwrite

Visual style object: { color, lineWidth, dashed, fontSize, textColor, backgroundColor }

Distance Dimension

curve

distance

Measures radius or diameter from a center point to a radius point. Displays value with leader line, arrowhead, and optional center mark.

The circle or arc center point {x, y, z}. This is the origin from which the radius vector starts.

centerPoint

A point lying on the circle's perimeter (or arc edge). The distance between center point and radius point defines the radius.

radiusPoint

The distance between the dimension line and the label text, measured along the radius direction.

Integer [0–6] (default: 2) Number of digits after the decimal point when formatting the numeric value.

The unit or text appended to the numeric value.

Custom label template. If contains {val}, it is replaced with the formatted value. If does not contain {val}, the text is displayed exactly as provided.

When enabled, the node measures and displays the diameter instead of the radius.

showDiameter

When enabled, draws a small cross mark at the center point to visually indicate the circle's center.

showCenterMark

Defines visual styling of the leader line, arrow, and text.

Radial Dimension

radius

diameter

Measures and visualizes a diameter with a specified direction. Draws diameter line with optional arrowheads and center mark.

The circle or arc center point {x, y, z}. Defines the midpoint of the measured diameter.

A vector that defines the orientation of the diameter line. The node uses this direction to position the dimension text and arrowheads symmetrically across the circle.

The measured diameter length. The node can receive this directly or calculate it from geometry.

When enabled, a small cross mark is drawn at the center point to indicate the geometric center of the circle or arc.

Diametral Dimension

Measures and visualizes the 3D bounding box dimensions of geometry. Shows width (X), height (Y), depth (Z), and optionally diagonal measurements with customizable labels.

The target mesh/solid/curve (single or list). Used to compute a 3D axis-aligned bounding box.

geometry

showWidth

showLength

showHeight

showDiagonal

Offset of labels from their dimension lines.

Integer [0–6] (default: 2) Digits after the decimal.

Custom label template for X dimension. If contains {val} it will be replaced with the formatted value.

labelOverwriteX

Custom label template for Y dimension. If contains {val} it will be replaced with the formatted value.

labelOverwriteY

Custom label template for Z dimension. If contains {val} it will be replaced with the formatted value.

labelOverwriteZ

Custom label template for diagonal dimension. If contains {val} it will be replaced with the formatted value.

labelOverwriteDiag

Connect a Dimension Style node to unify colors, sizes, arrows, text, etc.

3D Bounding Box Dimension

width

length

height

diagonal

Measures and visualizes the angle defined by a center point and two direction vectors

The center point of the angle (arc center)

The first direction vector starting from the center point. Only direction is used — length is ignored.

direction1

The second direction vector starting from the same center point. Works the same way as direction 1.

direction2

The visual radius of the dimension arc. Controls how large the arc is drawn, but not the measured value.

The distance between the arc and the text label (along the radius).

Number of digits after the decimal point when displaying the angle.

The unit or symbol appended to the numeric value (e.g., "°", "deg", "rad").

Custom label format. If contains {val} → {val} is replaced by the formatted angle. If does not contain {val} → the exact text is displayed.

Controls whether the output value is in radians or degrees.

radians

Angular Dimension

angle

Measures and visualizes the 2D bounding box dimensions of geometry. Shows width (X), height (Y), and optionally diagonal measurements with customizable labels.

Name	Type	Description	Default Value
Line Color	Color	Color of dimension lines
Line Thickness	Number	Thickness of main dimension line	0.01
Extension Line Length	Number	Length of extension/helper lines	0.1
Arrow Tail Length	Number	Tail length beyond arrow head	0.2
Text Color	Color	Label text color
Text Size	Number	Font size of label	16
Text Background Color	Color	Label background color for visibility	#000000
Text Background Opacity	Number	Opacity 0–1 for background	0.9
Arrow Size	Number	Overall arrowhead size	0.05
Show Arrows	Boolean	Toggle arrowheads