# Regular API function

### simInterpolateMatrices / sim.interpolateMatrices

 Description Computes the interpolated transformation matrix between matrixIn1 and matrixIn2. Quaternions are used internally. See also the other matrix/transformation functions. C synopsis simInt simInterpolateMatrices(const simFloat* matrixIn1,const simFloat* matrixIn2,simFloat interpolFactor,simFloat* matrixOut) C parameters matrixIn1: the first input matrix matrixIn2: the second input matrix interpolFactor: the interpolation factor, a value between 0.0 and 1.0 (0.0--> matrixOut=matrixIn1, 1.0--> matrixOut=matrixIn2) matrixOut: the output matrix (the result of the interpolation). A transformation matrix contains 12 values (the last row (0,0,0,1) is omitted): 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 resultMatrix=sim.interpolateMatrices(table_12 matrixIn1,table_12 matrixIn2,number interpolFactor) Lua parameters matrixIn1: the first input matrix (a table containing 12 values (the last row (0,0,0,1) is not required)) matrixIn2: the second input matrix (a table containing 12 values (the last row (0,0,0,1) is not required)) interpolFactor: the interpolation factor, a value between 0.0 and 1.0 (0.0--> resultMatrix=matrixIn1, 1.0--> resultMatrix=matrixIn2) Lua return values resultMatrix: the result matrix (a table containing 12 values (the last row (0,0,0,1) is omitted)). Table values in Lua are indexed from 1, not 0!

All regular API functions on one page