Regular API function

simCopyMatrix

Description Copies a transformation matrix. See also the other matrix/transformation functions.
C synopsis simInt simCopyMatrix(const simFloat* matrixIn,simFloat* matrixOut)
C parameters
matrixIn: matrix to be copied
matrixOut: copy of matrixIn (after the call)

matrixIn and matrixOut are pointers to 12 simFloat values (the last row of the 4x4 matrix (0,0,0,1) is not needed)
The x-axis of the orientation component is (matrix[0],matrix[4],matrix[8])
The y-axis of the orientation component is (matrix[1],matrix[5],matrix[9])
The z-axis of the orientation component is (matrix[2],matrix[6],matrix[10])
The position component is (matrix[3],matrix[7],matrix[11])
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=simCopyMatrix(table_12 matrixIn)
Lua parameters
matrixIn: matrix to be copied
Lua return values
matrixOut: copied matrix, or nil in case of an error

All regular API functions on one page