|
Calculates the location on the track that is in the given distance from the start of the track (the first point)
Parameters:
[in] track_handle:
a handle to a track
[in] distance:
The distance from the first point of the track
[out] location:
The X,Y,Z coordinate of a point that is in on the track and in the given distance from
the first point of the track
Remarks:
If the requested distance is longer than the track length and the track is non-cyclic then
the function will return the last point on the track and -1 will be returned
indicating that the end of the track was reached. When the track is cyclic then there
is no problem in specifing a distance that is longer then one lap of the track
Return value:
Returns the index of the next point on the track (in other words if we will continue moving on the track
from the calculated location the return value is the index of the next track point we will meet)
A return value of -1 indicates that the distance has reached or passed the track length (apply only to non-cyclic tracks)
|