Regular API function


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