Regular API function

simGetObjectMatrix / sim.getObjectMatrix

Description Retrieves the transformation matrix of an object. See also sim.setObjectMatrix and the section about positions, orientations and transformations
C/C++
synopsis
simInt simGetObjectMatrix(simInt objectHandle,simInt relativeToObjectHandle,simFloat* matrix)
C/C++
parameters
objectHandle: handle of the object. Can be combined with sim.handleflag_reljointbaseframe (see next argument)
relativeToObjectHandle: indicates relative to which reference frame we want the matrix. Specify sim.handle_world to retrieve the absolute transformation matrix, sim.handle_inverse to retrieve the inverse of the absolute transformation matrix, sim.handle_parent to retrieve the transformation matrix relative to the object's parent, or an object handle relative to whose reference frame we want the transformation matrix. If this handle is the handle of a joint, then the matrix relative to the joint's moving frame will be returned (unless objectHandle is combined with sim.handleflag_reljointbaseframe, in which case the matrix relative to the joint's base frame will be returned).
matrix: pointer to 12 simFloat values
C/C++
return value
-1 if operation was not successful
Lua
synopsis
float[12] matrix=sim.getObjectMatrix(int objectHandle,int relativeToObjectHandle)
Lua
parameters
Similar to the C-function counterpart
Lua
return values
Similar to the C-function counterpart
Python
synopsis
list matrix=sim.getObjectMatrix(int objectHandle,int relativeToObjectHandle)