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.

centerPoint

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.

direction

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

diameter

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

labelOffset

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

decimalPlaces

The unit or text appended to the numeric value.

labelSuffix

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.

labelOverwrite

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

showCenterMark

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

style

Diametral Dimension

curve

radius

## 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).

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

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

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

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

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

Distance Dimension

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.

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

radiusPoint

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.

Radial 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.

2D Bounding Box Dimension

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

Name	Type	Description	Default Value
Center Point	Point	The circle or arc center point {x, y, z}. Defines the midpoint of the measured diameter.
Direction	Vector	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.
Diameter	Number	The measured diameter length. The node can receive this directly or calculate it from geometry.
Label Offset	Number	The distance between the dimension line and the label text, measured along the radius direction.	1.5
Decimal Places	Number	Integer [0–6] (default: 2) Number of digits after the decimal point when formatting the numeric value.	2
Label Suffix	String	The unit or text appended to the numeric value.	mm
Label Overwrite	String	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.
Show Center Mark	Boolean	When enabled, a small cross mark is drawn at the center point to indicate the geometric center of the circle or arc.
Style	Meta	Defines visual styling of the leader line, arrow, and text.

Name	Type	Description
Dimension	ThreeCurve	Drawable dimension graphics
Diameter	Number	Numeric measured diameter
Radius	Number	Numeric measured radius (diameter / 2)

Creation method

There are two options for creating a Diametral Dimension node.

Steps

See also