Ashasekayi (Talk | contribs) |
Ashasekayi (Talk | contribs) |
||
Line 74: | Line 74: | ||
''-- creates a new quaternion with value [0.0, 0.707, 0.0, 0.707]''}} | ''-- creates a new quaternion with value [0.0, 0.707, 0.0, 0.707]''}} | ||
− | {{ScriptFunction|SQuaternion|__new|(SVector forward)|Creates a quaternion a forward vector; presuming up is (0,1,0)}} | + | {{ScriptFunction|SQuaternion|__new|(SVector forward)|Creates a quaternion a forward vector; presuming up is (0,1,0)|5= |
− | {{ScriptFunction|SQuaternion|__new|(SVector forward, SVector up)|Creates a quaternion a forward and up vector pair}} | + | local newQuat = '''Quaternion.LookRotation'''(Vector.Forward);}} |
+ | |||
+ | {{ScriptFunction|SQuaternion|__new|(SVector forward, SVector up)|Creates a quaternion a forward and up vector pair|5= | ||
+ | local newQuat = '''Quaternion.LookRotation'''(Vector.Forward, Vector.Up);}} | ||
==Members== | ==Members== |
The SQuaternion struct contains a simple 4D vector of X, Y, Z and W floats designed to represent rotations with orientation.
X axis
local originalRot = obj.LocalRotation;
obj.SubscribeToEvents();
local onStartMethod = function()
Space.Log(originalRot.x);
-- prints the X component of this object as a float
originalRot.x = 0.25;
-- assigns 0.25 value to the X component
obj.LocalRotation = originalRot;
-- sets the the new rotation
end
Y axis
local originalRot = obj.LocalRotation;
obj.SubscribeToEvents();
local onStartMethod = function()
Space.Log(originalRot.y);
-- prints the Y component of this object as a float
originalRot.y = 0.25;
-- assigns 0.25 value to the Y component
obj.LocalRotation = originalRot;
-- sets the the new rotation
end
Z axis
local originalRot = obj.LocalRotation;
obj.SubscribeToEvents();
local onStartMethod = function()
Space.Log(originalRot.z);
-- prints the Z component of this object as a float
originalRot.z = 0.25;
-- assigns 0.25 value to the Z component
obj.LocalRotation = originalRot;
-- sets the the new rotation
end
W axis
local originalRot = obj.LocalRotation;
obj.SubscribeToEvents();
local onStartMethod = function()
Space.Log(originalRot.w);
-- prints the W component of this object as a float
originalRot.w = 0.25;
-- assigns 0.25 value to the W component
obj.LocalRotation = originalRot;
-- sets the the new rotation
end
Initialises quaternion from four floats
-- creates a new quaternion with value [0.0, 0.707, 0.0, 0.707]
Creates a quaternion from 3 Euler floats (i.e. 3x 0-360' angles)
-- creates a new quaternion with value [0.0, 0.707, 0.0, 0.707]
Creates a quaternion from a Angle / Axis pair
local newQuat = Quaternion.AngleAxis(newVector, 90.0);
Creates a quaternion a forward vector; presuming up is (0,1,0)
Creates a quaternion a forward and up vector pair
Note: Add/Scale/Divide are also implemented as operators (e.g. A + B, A += B)
Returns the Euler rotation for this Quaternion
local euler = newQuat.EulerAngles;
Space.Log(euler);
Rotates a vector by a quaternion
local newVector = Vector.Forward;
rotatedVector = newQuat * newVector;
Space.Log(rotatedVector);
Rotates a quaternion by a quaternion
local newVector = Vector.New(0.0, 0.0, 0.0);
rotatedVector = newQuat * newQuat;
-- rotatedVector is a quaternion with value [0.0, 1.0, 0.0, 0.0]
Returns the angle between two quaternions
local otherQuat = Quaternion.New(0.0, 1.0, 0.0, 0.0);
angle = newQuat.Angle(otherQuat);
Space.Log(angle);
Linearly interpolates between this and other quaternion, by factor t and returns the result
-- Attach this script to a cube or any object.
local cube = Space.Host.ExecutingObject;
cube.SubscribeToEvents();
local fromQuat = cube.LocalRotation;
local toQuat = Quaternion.New(0.0, 0.707, 0.0, 0.707);
local speed = 0.1;
-- The cube will rotate 90 degrees from current rotation by speed amount.
local moveCube = function()
cube.LocalRotation = fromQuat.Lerp(toQuat, Space.Time * speed);
end
Spherically interpolates between this and other quaternion, by factor t and returns the result
-- Attach this script to a cube or any object.
local cube = Space.Host.ExecutingObject;
cube.SubscribeToEvents();
local fromQuat = cube.LocalRotation;
local toQuat = Quaternion.New(0.0, 1.0, 0.0, 0.0);
local speed = 0.1;
-- The cube will rotate 180 degrees from current rotation by speed amount.
local moveCube = function()
cube.LocalRotation = fromQuat.Slerp(toQuat, Space.Time * speed);
end
Rotates this towards other, by no more than t degrees
-- Attach this script to a cube or any object.
local cube = Space.Host.ExecutingObject;
cube.SubscribeToEvents();
local fromQuat = cube.LocalRotation;
local target = Quaternion.New(0.0, 0.707, 0.0, 0.707);
local speed = 10.0;
-- The cube will rotate 90 degrees from current rotation by step amount.
local moveCube = function()
local step = speed * Space.Time;
cube.LocalRotation = fromQuat.RotateTowards(target, step);
end
Returns the dot product of this and another quaternion
local quatOther = Quaternion.New(0.0, 0.0, 0.0, 1.0);
Space.Log(quat.Dot(quatOther));
Returns the inverse of this quaternion
local inverseQuat = quat.Inverse;
Equivalent of new SQuaternion(0,0,0,1)
|