Description
|
Retrieves the absolute interpolated orientation of a point along a path object. See also simGetPositionOnPath, simGetPathPosition and simGetClosestPositionOnPath.
|
C synopsis
|
simInt simGetOrientationOnPath(simInt pathHandle,simFloat relativeDistance,simFloat* eulerAngles)
|
C parameters |
pathHandle: handle of the path object
relativeDistance: a value between 0 and 1, where 0 is the beginning of the path, and 1 the end of the path. Make sure you selected the appropriate path length calculation method (refer to the path position calculation method section). See also simGetPathLength. In order to retrieve the orientation that lies exactly on a specific path control point, specify following for relativeDistance: -ctrlPtIndex-1 (the value will be rounded appropriately).
|
C return value
|
-1 if operation was not successful. In a future release, a more differentiated return value might be available
|
Lua synopsis
|
table_3 eulerAngles=simGetOrientationOnPath (number pathHandle,number relativeDistance)
|
Lua parameters |
pathHandle: handle of the path object
relativeDistance: a value between 0 and 1, where 0 is the beginning of the path, and 1 the end of the path. Make sure you selected the appropriate path length calculation method. See also simGetPathLength. In order to retrieve the orientation that lies exactly on a specific path control point, specify following for relativeDistance: -ctrlPtIndex-1 (the value will be rounded appropriately).
|
Lua return values
|
eulerAngles: table of 3 values (alpha, beta and gamma) or nil in case of an error
|