🔢 Quat
Floating point Quaternion that can represent a rotation about an axis in 3-D space
🎒 Examples
local new_quaternion = Quat(0.5, 0.5, 1, -1)
local rotation = new_quaternion:Rotator()
🛠 Constructors
Default Constructor
No description provided
local my_quat = Quat(X?, Y?, Z?, W?)
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| float | X | 0 | The quaternion's X-component |
| float | Y | X | The quaternion's Y-component |
| float | Z | X | The quaternion's Z-component |
| float | W | X | The quaternion's W-component |
🧽 Properties
| Type | Name | Description |
|---|---|---|
| float | X | The quaternion's X-component |
| float | Y | The quaternion's Y-component |
| float | Z | The quaternion's Z-component |
| float | W | The quaternion's W-component |
🦠 Functions
info
This structure supports *, +, - and tostring operations.
| Returns | Name | Description | |
|---|---|---|---|
Normalize | In place normalize this Quaternion | ||
| Rotator | Rotator | Get the Rotator representation of this Quaternion | |
| Quat | Inverse | Returns the inverse of this Quaternion | |
| Vector | RotateVector | Rotates a vector by this Quaternion | |
| Vector | UnrotateVector | Unrotates a vector by this Quaternion | |
| Vector | GetForwardVector | Get the forward direction vector from this Quaternion | |
| Vector | GetRightVector | Get the right direction vector from this Quaternion | |
| Vector | GetUpVector | Get the up direction vector from this Quaternion |
OptimalNormalize
In place normalize this Quaternion
my_quat:Normalize(tolerance?)
Parameters
| Type | Parameter | Default | Description |
|---|---|---|---|
| float | tolerance? | 0.000001 | Minimum squared size to consider it non-zero |
OptimalRotator
Get the Rotator representation of this Quaternion
local ret = my_quat:Rotator()
Returns
| Type | Description |
|---|---|
| Rotator | Rotator representation of this Quaternion |
OptimalInverse
Returns the inverse of this Quaternion
local ret = my_quat:Inverse()
Returns
| Type | Description |
|---|---|
| Quat | Inverse of this Quaternion |
OptimalRotateVector
Rotates a vector by this Quaternion
local ret = my_quat:RotateVector(vector)
Parameters
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | vector | Required parameter | Vector to rotate |
Returns
| Type | Description |
|---|---|
| Vector | Rotated vector |
OptimalUnrotateVector
Unrotates a vector by this Quaternion
local ret = my_quat:UnrotateVector(vector)
Parameters
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | vector | Required parameter | Vector to unrotate |
Returns
| Type | Description |
|---|---|
| Vector | Unrotated vector |
OptimalGetForwardVector
Get the forward direction vector from this Quaternion
local ret = my_quat:GetForwardVector()
Returns
| Type | Description |
|---|---|
| Vector | Forward vector |
OptimalGetRightVector
Get the right direction vector from this Quaternion
local ret = my_quat:GetRightVector()
Returns
| Type | Description |
|---|---|
| Vector | Right vector |
OptimalGetUpVector
Get the up direction vector from this Quaternion
local ret = my_quat:GetUpVector()
Returns
| Type | Description |
|---|---|
| Vector | Up vector |