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.

labelOffset

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

decimalPlaces

labelSuffix

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.

style

3D Bounding Box Dimension

curve

width

length

height

diagonal

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

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.

labelOverwrite

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.

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 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
Geometry	Geometry	The target mesh/solid/curve (single or list). Used to compute a 3D axis-aligned bounding box.
Show Width (X)	Boolean	Draw X-axis dimension.
Show Length (Y)	Boolean	Draw Y-axis dimension.
Show Height (Z)	Boolean	Draw Z-axis dimension.
Show Diagonal	Boolean	Draw body diagonal of the box.
Label Offset	Number	Offset of labels from their dimension lines.	1.5
Decimal Places	Number	Integer [0–6] (default: 2) Digits after the decimal.	2
Label Suffix	String	Unit appended to values.	mm
Label Overwrite X	String	Custom label template for X dimension. If contains {val} it will be replaced with the formatted value.
Label Overwrite Y	String	Custom label template for Y dimension. If contains {val} it will be replaced with the formatted value.
Label Overwrite Z	String	Custom label template for Z dimension. If contains {val} it will be replaced with the formatted value.
Label Overwrite Diagonal	String	Custom label template for diagonal dimension. If contains {val} it will be replaced with the formatted value.
Style	Meta	Connect a Dimension Style node to unify colors, sizes, arrows, text, etc.

Name	Type	Description
Dimension	ThreeCurve	Drawable dimension graphics
Width	Number	Numeric measured width (X dimension)
Length	Number	Numeric measured length (Y dimension)
Height	Number	Numeric measured height (Z dimension)
Diagonal	Number	Numeric measured diagonal length

Creation method

There are two options for creating a 3D Bounding Box Dimension node.

Steps

See also