Ovis_Entity_Position_Get()
Abstract
Returns the 3D geocentric and geodetic position of an Ovis entity.
Syntax
Ovis_Entity_Position_Get (obj_ptr, geocentric_pos_ptr, geodetic_pos_ptr)
| Argument | Type | Description |
|---|---|---|
obj_ptr |
OvisT_Entity * |
Ovis entity |
geocentric_pos_ptr |
OvisT_3D_Position * |
Geocentric position of the entity (X, Y, Z) |
geodetic_pos_ptr |
OvisT_3D_Position * |
Geodetic position of the entity (latitude, longitude, altitude) |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the entity is valid; OvisC_Compcode_Failure otherwise.
Header
ovis_entity.h
Details
This function returns the 3D geocentric (X, Y, Z) and geodetic (latitude, longitude, altitude) position of the Ovis entity.
Note that either position argument can be set to OPC_NIL if you are not interested in the corresponding type of position. If both position arguments are provided, they must be addresses of distinct variables.
Example
OvisT_3D_Position geodetic, geocentric;
OvisT_Entity * ent_ptr;
/* .. entity created at some point */
Ovis_Entity_Position_Get (ent_ptr, &geocentric, &geodetic);
Errors
- Position argument is NIL.
Reference
- Use the functions
Ovis_3D_Position_Geocentric_Set()andOvis_3D_Position_Geodetic_Set()to set up a 3D position with geocentric or geodetic coordinates.