Ets_Nt_Site_Local_Position_Get()
Abstract
Gets the position of a site in parent subnet coordinates for any point in time.
Syntax
Ets_Nt_Site_Local_Position_Get (site_hndl, time, local_x_ptr, local_y_ptr, local_z_ptr)
| Argument | Type | Description |
|---|---|---|
site_hndl |
EtsT_Obj_Handle |
Site for which to obtain position. |
time |
double |
Time for which to obtain position, given as an offset (in seconds) from the network start time. |
local_x_ptr |
double * |
Area to fill with local x coordinate of site at the specified time. |
local_y_ptr |
double * |
Area to fill with local y coordinate of site at the specified time. |
local_z_ptr |
double * |
Area to fill with local z coordinate of site at the specified time. |
Return Type
EtsT_Compcode
EtsC_Compcode_Failure if site_hndl is not a site or time is less than 0.0; EtsC_Compcode_Success otherwise.
Header
ets_api_nt.h
Details
The local coordinates are those used by the parent subnet of the site. For example, the position of a site in the top subnet will be given in degrees longitude, degrees latitude, and meters above sea level.
If time is 0.0, this function ignores any trajectory and returns the actual position of the site in the Project Editor.