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., m, in, ft).

labelSuffix

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

labelOverwrite

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

style

Distance Dimension

curve

distance

<p>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. If you are registering packages programmatically, import and register the package in your Node Editor setup. Available Nodes - 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, optional direction, labelOffset (0.2), decimalPlaces (0–6, default 2), labelSuffix ("mm"), labelOverwrite, style. - Outputs: curve (ThreeCurve), distance (Number). - 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 (0–6, default 1), labelSuffix ("°"), labelOverwrite, radians (false), style. - Outputs: curve (ThreeCurve), angle (Number). - 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 (0–6, default 2), labelSuffix ("mm"), labelOverwrite, showDiameter (false), showCenterMark (true), style. - Outputs: curve (ThreeCurve), radius (Number), diameter (Number). - 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 (0–6, default 2), labelSuffix ("mm"), labelOverwrite, showCenterMark (true), style. - Outputs: curve (ThreeCurve), diameter (Number), radius (Number). - Dimension 2D - Measures and visualizes 2D bounding box dimensions of geometry. Shows width (X), height (Y), and optional diagonal. - Inputs: geometry, showWidth (true), showHeight (true), showDiagonal (false), labelOffset (0.2), decimalPlaces (0–6, default 2), labelSuffix ("mm"), labelOverwriteX, labelOverwriteY, labelOverwriteDiag, style. - Outputs: curve (ThreeCurve), width (Number), height (Number), diagonal (Number), minPoint (Point), maxPoint (Point). - Dimension 3D - Measures and visualizes 3D bounding box dimensions of geometry. Shows width (X), length (Y), height (Z), and optional diagonal. - Inputs: geometry, showWidth (true), showLength (true), showHeight (true), showDiagonal (false), labelOffset (0.2), decimalPlaces (0–6, default 2), labelSuffix ("mm"), labelOverwriteX, labelOverwriteY, labelOverwriteZ, labelOverwriteDiag, style. - Outputs: curve (ThreeCurve), width (Number), length (Number), height (Number), diagonal (Number). - Dimension Style - Produces a reusable style object to control the appearance of dimension graphics. Connect its output to a dimension node's style input. - 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 (e.g., L = {val} mm).</p>

Dimensions

1dc7e20c-3b17-41f0-9e4e-a1fcb405c6f6.png

8ca089e6-77f8-4c20-a8ce-a908366ea93f.png

b077bf7b-bf3d-494e-b170-e4105405a36c.svg

ea06d711-7a2b-46b3-8895-d2c2e0982114.svg

Dimension

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.

Diametrical Dimension

Measures and visualizes the 2D bounding box dimensions of geometry. Shows width (X), height (Y), 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

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

Dimension 2D

width

height

diagonal

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

showLength

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

labelOverwriteZ

Dimension 3D

length

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

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.

Name	Type	Description	Default Value
Start	Point	Start point of the segment
End	Point	End point of the segment
Direction	Vector	Optional direction to place the label and offset line (perpendicular to the measured segment).
Offset	Number	Distance between the measured line and the dimension label (and offset line).	1.5
Decimals	Number	Number of digits after the decimal point (0-6).	2
Suffix	String	Units or suffix appended to the measurement value (e.g., m, in, ft).	m
Override	String	Custom label text. If contains {val}, it will be replaced with computed distance.
Style	Meta	Visual style object: { color, lineWidth, dashed, fontSize, textColor, backgroundColor }

Name	Type	Description
Dimension	ThreeCurve	Drawable dimension graphics
Distance	Number	Numeric measured distance

Creation method

There are two options for creating a Distance Dimension node.

Steps

See also