Reference API Roblox

Engine API

Website

Related

Reference API Roblox

RotationOrder

The order of rotation axes used for Euler angles encoding of rotations.

Items 6

HistoryNameValueDescription
496XYZ0

X, Y, Z order.

496XZY1

X, Z, Y order.

496YZX2

Y, Z, X order.

496YXZ3

Y, X, Z order.

496ZXY4

Z, X, Y order.

496ZYX5

Z, Y, X order.

Description

Euler angles encode a rotation in 3D space via a sequence of three rotations along the X, Y, and Z axes. The RotationOrder enum specifies the order in which the engine performs these rotations.

To help visualize the many rotation orders, you can test them manually in Studio with the Rotate tool or by inserting task.wait() statements between individual rotations of a cube with a unique face:

1
2
3
4
5
6
7
8
9

local cube = workspace.Cube
local rx, ry, rz = math.rad(90), math.rad(90), math.rad(90)

task.wait(5)
cube.CFrame *= CFrame.fromEulerAngles(rx, 0, 0)  -- X
task.wait(5)
cube.CFrame *= CFrame.fromEulerAngles(0, ry, 0)  -- Y
task.wait(5)
cube.CFrame *= CFrame.fromEulerAngles(0, 0, rz)  -- Z

An equivalent operation is:

1
2
3
4

local cube = workspace.Cube
local rx, ry, rz = math.rad(90), math.rad(90), math.rad(90)

cube.CFrame = CFrame.fromEulerAngles(rx, ry, rz, Enum.RotationOrder.XYZ)

History 7

Settings