Construct 3 icon

Construct 3

Documentation

Orbit behavior

Ashley's avatar
Medal
Construct Team Founder
Published 18 Mar, 2019
431 words
~2-3 mins

The Orbit behavior moves an object in a circle or ellipse around a point. The object's initial position is used as the point to orbit around.

Orbit properties

Speed

The speed to orbit at, in degrees per second. Positive is clockwise and negative is anticlockwise.

Acceleration

The rate of change to the orbit speed, in degrees per second per second. Positive will accelerate in a clockwise direction and negative will accelerate in an anticlockwise direction.

Primary radius

The distance of the orbit from its center point, in pixels. For a circular orbit, ensure the primary and secondary radii are the same. For elliptical orbits, the primary radius is the one in the direction of the offset angle.

Secondary radius

The perpendicular distance of the orbit from its center point, in pixels. For a circular orbit, ensure the primary and secondary radii are the same. For elliptical orbits, the secondary radius is the one perpendicular to the offset angle.

Offset angle

For elliptical orbits, the rotation of the ellipse in degrees. For circular orbits, this does not affect the orbit path (since rotating a circle has no effect), but it changes the initial angle the orbit starts from.

Match rotation

If enabled, sets the object's angle to match the direction of travel in the orbit. If disabled the behavior only changes the object's position without affecting the angle.

Enabled

Whether the behavior is initially enabled or disabled. If disabled, it can be enabled at runtime using the Set enabled action.

Preview Paid plans only

Enable to run a preview of the behavior directly in the Layout View.

Orbit conditions

Is enabled

Test if the behavior is currently enabled.

Orbit actions

Pin

Unpin

Set another object as the location to orbit around, following the object if it moves. The Unpin action will stop following the object.

Set acceleration

Set enabled

Set match rotation

Set offset angle

Set radius

Set speed

Set the corresponding behavior properties. See Orbit properties above.

Set rotation

Set the current orbit position by its angle from the center point in degrees.

Set target

Set the center point of the orbit in layout co-ordinates.

Orbit expressions

Acceleration

OffsetAngle

PrimaryRadius

SecondaryRadius

Speed

Return the corresponding behavior properties. See Orbit properties above.

DistanceToTarget

Return the distance from the object to the center point of the orbit, in pixels.

Rotation

Return the current position of the orbit as its rotation relative to the center point in degrees.

TargetX

TargetY

Return the current center point of the orbit in layout co-ordinates.