m fix formatting |
Slight rewrite, mention what an Euler angle is. |
||
| Line 1: | Line 1: | ||
A FloatQ is a floating point representation of a [https://en.wikipedia.org/wiki/Quaternion Quaternion] | A ''FloatQ'' is a floating point representation of a [https://en.wikipedia.org/wiki/Quaternion Quaternion], used to represent rotations on things such as [[Slot]]s. | ||
== Overview == | |||
The underlying mathematics of a quaternions are complicated and are beyond the scope of this article. That said, [[Resonite]] provides plenty of helpers to make working with them more intuitive. | |||
Quaternion multiplication is '''not commutative'''! Multiplying one FloatQ by another will rotate the second FloatQ by the first one, order is important. | Quaternions are internally made up of '''four''' components: '''X''', '''Y''', '''Z''', and '''W'''. Since these values are not easy to understand directly, Resonite will usually show quaternions by converting them to and from 3-component [https://en.wikipedia.org/wiki/Euler_angles Euler angles]. | ||
Quaternion multiplication is '''not commutative'''! Multiplying one '''FloatQ''' by another will rotate the second '''FloatQ''' by the first one, order is important. | |||
== In ProtoFlux == | |||
[[ProtoFlux]] has specific nodes for working with quaternions, primarily under the [[:Category:ProtoFlux:Math:Rotation]] category. | |||
== Examples == | == Examples == | ||
Revision as of 01:02, 6 March 2024
A FloatQ is a floating point representation of a Quaternion, used to represent rotations on things such as Slots.
Overview
The underlying mathematics of a quaternions are complicated and are beyond the scope of this article. That said, Resonite provides plenty of helpers to make working with them more intuitive.
Quaternions are internally made up of four components: X, Y, Z, and W. Since these values are not easy to understand directly, Resonite will usually show quaternions by converting them to and from 3-component Euler angles.
Quaternion multiplication is not commutative! Multiplying one FloatQ by another will rotate the second FloatQ by the first one, order is important.
In ProtoFlux
ProtoFlux has specific nodes for working with quaternions, primarily under the Category:ProtoFlux:Math:Rotation category.
Examples
The above Protoflux is rotating a Float3 vector 90° counter-clockwise around the Y-axis using a FloatQ. This transforms a vector facing towards +X into one towards -Z. Note that the X-component of the output vector is written in scientific notation representing 0.00000005960464. This very small number is the result of precision errors.
The above Protoflux is first rotating a vector 90° counter-clockwise around the Y-axis and then 90° counter-clockwise around the X-axis. This results in a vector facing towards +Y. The order of the operands is important when rotating a floatQ as it is not commutative. See below for an example.
If the operands were swapped, the result would not be different from the first example. To understand this, think of rotating a vector facing towards +X around the X-axis first. The result is the same.