Regular API function

simRelocateShapeFrame / sim.relocateShapeFrame

Description Repositions and reorients the reference frame of a shape, while keeping the mesh in place. The shape's inertia properties are unaffected. See also sim.alignShapeBB
C/C++
synopsis
int simRelocateShapeFrame(int shapeHandle,const double* pose)
C/C++
parameters
shapeHandle: the handle of the shape
pose: the pose for the shape's reference frame. The pose is expressed as (x,y,z,qx,qy,qz,qw). A NULL pose or a pose containing only zeros will relocate the frame to the center of the mesh's bounding box
C/C++
return value
-1 if operation was not successful. 0 if the frame could not be relocated (the frame of primitive shapes cannot be relocated), otherwise 1.
Lua
synopsis
bool result=sim.relocateShapeFrame(int shapeHandle,float[7] pose)
Lua
parameters
Similar to the C-function counterpart. nil is not a valid argument for pose
Lua
return values
Similar to the C-function counterpart
Python
synopsis
bool result=sim.relocateShapeframe(int shapeHandle,list pose)