Docs / Shapes / Body

Body Shape

The Body shape adds animated characters to your model. Characters move, rotate, and change state according to the equations you define, bringing physical simulations to life.

Screenshot: Body shape on the board with an animated character running

Overview

A Body shape is an animated sprite placed inside a Referential. Its position (x, y) and rotation are driven by expression terms. As the simulation runs, the character moves according to the mathematical model — walking, running, jumping, or performing custom animations.

Toolbar

Screenshot: Body shape toolbar with character picker and options

Motion Binding

The Body shape position is controlled by binding terms to its coordinates:

PropertyBound TermEffect
X positionAny numeric term (e.g., x)Horizontal position in the referential
Y positionAny numeric term (e.g., y)Vertical position in the referential
RotationAngle term (e.g., θ)Character orientation in radians or degrees

Animation States

Characters have multiple animation states that change based on movement:

Body shapes must be placed inside a Referential shape. The referential defines the coordinate system for positioning.

Properties Panel

Screenshot: Body properties panel showing term bindings
PropertyDescription
CharacterWhich animated sprite to use
X termTerm controlling horizontal position
Y termTerm controlling vertical position
Rotation termTerm controlling angle
ScaleSize multiplier for the character
TrailWhether to leave a path trace behind the character