Regular API function
simSetObjectOrientation / sim.setObjectOrientation
Description
|
Sets the orientation (Euler angles) of an object. Dynamically simulated objects, together with their hierarchy tree, will be dynamically reset (this however does not apply to static shapes). See also sim.getObjectOrientation and the section about positions, orientations and transformations |
C/C++ synopsis
|
simInt simSetObjectOrientation(simInt objectHandle,simInt relativeToObjectHandle,const simFloat* eulerAngles) |
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 the orientation is specified. Specify sim.handle_world to set the absolute orientation, sim.handle_parent to set the orientation relative to the object's parent, or an object handle relative to whose reference frame the orientation is specified. If this handle is the handle of a joint, then the orientation is applied relative to the joint's moving frame (unless objectHandle is combined with sim.handleflag_reljointbaseframe, in which case the orientation is applied relative to the joint's base frame).
eulerAngles: Euler angles (alpha, beta and gamma)
|
C/C++ return value
|
-1 if operation was not successful
|
Lua synopsis
|
sim.setObjectOrientation(int objectHandle,int relativeToObjectHandle,float[3] eulerAngles)
|
Lua parameters |
Similar to the C-function counterpart
|
Lua return values
|
|
Python synopsis |
sim.setObjectOrientation(int objectHandle,int relativeToObjectHandle,list eulerAngles) |
|