STATE_track_get_location_at_distance_from_start

 

 


  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)
  

 

 

Go to page 1      Select API

 

Copyright © 2007 3DSTATE Corporation. www.3dstate.com