enums.orientation

This enum contains values that can be returned by the object.get_orientation function. Each value indicates which of the object's local vectors most closely matches world up.

In layman's terms: imagine a cube enclosing the object, and imagine that the cube rotates to match the object. Now imagine an arrow sticking directly out of each side of the cube. Each arrow represents a "local direction" for the enclosed object: local up, local forward, local backward, and so on. The object.get_orientation function tells you which of these local directions is pointing "up." Note that by design, you can't check the object's heading; you essentially can only react to pitch and roll rotations.

up_is_up

upright

The object's local "up" vector most closely matches world up; the object is upright.

right_is_up

The object's local "right" vector most closely matches world up; the object is turned on its side.

backward_is_up

nose_down

The object's local "backward" vector most closely matches world up; the object is nose-down.

forward_is_up

nose_up

The object's local "forward" vector most closely matches world up; the object is nose-up.

left_is_up

The object's local "left" vector most closely matches world up; the object is turned on its side.

down_is_up

upside_down

The object's local "down" vector most closely matches world up; the object is upside-down.