Ovis_3D_Sphere_Center_Get()
Abstract
Returns the center of a 3D sphere.
Syntax
Ovis_3D_Sphere_Center_Get (sphere_dec_ptr, center_ptr)
| Argument | Type | Description |
|---|---|---|
sphere_dec_ptr |
OvisT_3D_Sphere * |
Sphere |
center_ptr |
OvisT_3D_Position * |
Center of the sphere |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the provided object is a valid 3D sphere. Otherwise, it returns OvisC_Compcode_Failure.
Header
ovis_decoration.h
Details
This function returns the coordinates of the center of the 3D sphere. The 3D position matches what is currently used to position the sphere (geodetic, geocentric, decoration offset, or entry).
Example
OvisT_3D_Position pos;
OvisT_3D_Sphere * sphere;
/* … sphere created at some point */
Ovis_3D_Sphere_Center_Get (sphere, &pos);
Errors
- Decoration is NIL.
- Decoration is not a 3D sphere.
- Return address for center position is NIL.
Reference
- Use the function
Ovis_3D_Sphere_Center_Set()to specify the center of the circle.