Docs / Shapes / Referential

Referential Shape

The Referential shape defines a coordinate system on the board where child shapes (points, bodies, vectors) are positioned.

Referential shape on the board

Overview

A Referential shape establishes a 2D coordinate system with configurable origin, scale, and axis labels. All positional child shapes (Points, Bodies, Vectors, Lines) must live inside a Referential. The referential translates mathematical coordinates into pixel positions on the board.

Toolbar

Screenshot: Referential shape toolbar

Properties Panel

Screenshot: Referential properties panel
PropertyDescription
Origin X / YBoard position of the coordinate origin
Scale X / YPixels per unit for each axis
Show axesDisplay the X and Y axis lines
Show gridDisplay a background grid
X label / Y labelAxis label text
X range / Y rangeVisible coordinate range
Child shapes reference their parent referential terms using dotted names: body.x, point.y.