
simRotateAroundAxis
Description
|
Rotates a transformation matrix around a random axis in space. This function, when used in combination with simGetRotationAxis, can be used to build interpolations between transformation matrices. See also simGetObjectMatrix, simSetObjectMatrix and the other matrix/transformation functions. |
C synopsis
|
simInt simRotateAroundAxis(const simFloat* matrixIn,const simFloat* axis,const simFloat* axisPos,simFloat angle,simFloat* matrixOut)
|
C parameters |
matrixIn: the transformation matrix to rotate
axis: the axis vector in absolute coordinates to rotate around
axisPos: the position of the rotation axis in absolute coordinates
angle: the amount of rotation to perform
matrixOut: the returned transformed (rotated) matrix
|
C return value
|
-1 if operation was not successful. In a future release, a more differentiated return value might be available
|
Lua synopsis
|
table_12 matrixOut=simRotateAroundAxis(table_12 matrixIn,table_3 axis,table_3 axisPos,number angle)
|
Lua parameters |
Same as C-function
|
Lua return values
|
matrixOut: the transformed (rotated) matrix, or nil in case of an error
|
All regular API functions on one page
|