Constructor and helpers for the CFrame datatype (a coordinate frame in 3D space).
Creates a new CFrame. Accepts no arguments (identity), three numbers (x, y, z), a Vector3 position, two Vector3 values (position, lookAt), seven numbers (x, y, z, qX, qY, qZ, qW -- position + unit quaternion), or twelve numbers (x, y, z, R00..R22 -- position + 3x3 rotation matrix).
Creates a CFrame positioned at at looking toward lookAt, with optional up vector.
| at | Vector3 | Position. |
| lookAt | Vector3 | Target to look at. |
| up | Vector3? | Up direction (default 0, 1, 0). |
Creates a CFrame positioned at at looking along direction (a unit-length direction vector), with optional up. Equivalent to lookAt(at, at + direction, up).
| at | Vector3 | Position. |
| direction | Vector3 | Forward direction. |
| up | Vector3? | Up direction (default 0, 1, 0). |
Builds a CFrame from a position and orthonormal basis vectors. If vZ is omitted it is derived as cross(vX, vY). The basis vectors are interpreted as columns of the rotation matrix (XVector, YVector, ZVector).
| pos | Vector3 | Position. |
| vX | Vector3 | Right axis (XVector). |
| vY | Vector3 | Up axis (YVector). |
| vZ | Vector3? | Back axis (ZVector). Defaults to vX cross vY. |
Creates a rotation-only CFrame from Euler angles (rx, ry, rz) applied in XYZ order.
Angles| rx | number | Rotation around X in radians. |
| ry | number | Rotation around Y in radians. |
| rz | number | Rotation around Z in radians. |
Creates a rotation-only CFrame from Euler angles (rx, ry, rz) applied in YXZ order.
fromOrientation| rx | number | Rotation around X in radians. |
| ry | number | Rotation around Y in radians. |
| rz | number | Rotation around Z in radians. |
Creates a rotation-only CFrame from Euler angles. Optional fourth argument is an Enum.RotationOrder integer (0=XYZ, 1=XZY, 2=YZX, 3=YXZ, 4=ZXY, 5=ZYX); defaults to XYZ.
| rx | number | |
| ry | number | |
| rz | number | |
| order | number? | RotationOrder (defaults to XYZ) |
Creates a rotation-only CFrame from an axis-angle pair (Rodrigues).
| axis | Vector3 | Rotation axis (need not be unit-length). |
| rotation | number | Rotation magnitude in radians. |