Regular API function

simBuildPose / sim.buildPose

Description Builds a pose based on a position vector and Euler angles or axes. See also the section about positions, orientations and transformations
C/C++
synopsis
simInt simBuildPose(const simFloat* position,const simFloat* eulerAngles,simFloat* pose)
C/C++
parameters
position: pointer to 3 values
eulerAngles: pointer to 3 values
pose: pointer to 7 values
C/C++
return value
-1 if operation was not successful
Lua
synopsis
float[7] pose=sim.buildPose(float[3] position,float[3] eulerAnglesOrAxis1,int mode=0,float[3] axis2=nil)
Lua
parameters
position: pointer to 3 values representing the position component
eulerAnglesOrAxis1: pointer to 3 values representing Euler angles or a reference frame axis (see mode below)
mode: describes how the orientation is specified:
0: eulerAnglesOrAxis1 represents Euler angles and axis2 is ignored
1: eulerAnglesOrAxis1 represents the x-axis of the new pose's reference frame, axis2 is ignored
2: eulerAnglesOrAxis1 represents the y-axis of the new pose's reference frame, axis2 is ignored
3: eulerAnglesOrAxis1 represents the z-axis of the new pose's reference frame, axis2 is ignored
4: eulerAnglesOrAxis1 represents the x-axis and axis2 represents the y-axis of the new pose's reference frame
5: eulerAnglesOrAxis1 represents the y-axis and axis2 represents the z-axis of the new pose's reference frame
6: eulerAnglesOrAxis1 represents the z-axis and axis2 represents the x-axis of the new pose's reference frame
7: eulerAnglesOrAxis1 represents the x-axis and axis2 represents the z-axis of the new pose's reference frame
8: eulerAnglesOrAxis1 represents the y-axis and axis2 represents the x-axis of the new pose's reference frame
9: eulerAnglesOrAxis1 represents the z-axis and axis2 represents the y-axis of the new pose's reference frame
axis2: pointer to 3 values representing a reference frame axis (see mode above)
Lua
return values
pose: an array of 7 value
Python
synopsis
list pose=sim.buildPose(list position,list eulerAnglesOrAxis,int mode=0,list axis2=None)

<