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
OrientationA pair of terms or values (e.g., vx and vy)Direction the character faces, read as a vector: how far across and how far up

Orientation

The Orientation row of the terms menu names a pair — a horizontal term or value and a vertical one — read together as a vector in the referential's own coordinates. The character is turned to point along it, so binding a velocity to the pair makes the character face the way it moves, and binding any other pair makes it face wherever that pair points. Both selectors are read in the case the row names, and either one may be left empty, which counts as zero.

Left empty, the body keeps to the way it behaved before: a character marked as rotating turns to the direction it travels, and any other body is mirrored left or right as it changes direction.

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
Orientation termsPair of terms, horizontal and vertical, the character is turned to face along
ScaleSize multiplier for the character
TrailWhether to leave a path trace behind the character