Ovis_3D_Polygon_Rotation_Get()
Abstract
Returns the rotation of a 3D polygon.
Syntax
Ovis_3D_Polygon_Rotation_Get (poly_ptr, rotation_ptr)
| Argument | Type | Description |
|---|---|---|
poly_ptr |
OvisT_3D_Polygon * |
Polygon |
rotation_ptr |
OvisT_TaitBryan * |
Rotation of the polygon. |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the provided object is a valid polygon. Otherwise, it returns OvisC_Compcode_Failure.
Header
ovis_decoration.h
Details
This function returns the rotation of the 3D polygon. The polygon can be a sphere or a cube. The rotation angles are in degrees.
Example
OvisT_3D_Cube * cube;
OvisT_TaitBryan rotation;
/* … cube created previously */
Ovis_3D_Polygon_Rotation_Get (cube, &rotation);
Errors
- Decoration is not a 3D sphere or cube.
- Decoration is NIL.
- Return address for rotation value is NIL.
Reference
- Use the function
Ovis_3D_Polygon_Rotation_Set()to modify the rotation of spheres and cubes.