Ovis_3D_Polygon_Rotation_Set()
Abstract
Specifies the rotation of a 3D polygon.
Syntax
Ovis_3D_Polygon_Rotation_Set (poly_ptr, rotation)
| Argument | Type | Description |
|---|---|---|
poly_ptr |
OvisT_3D_Polygon * |
Polygon |
rotation |
OvisT_TaitBryan |
Specifies the 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 specifies the rotation of the 3D polygon. The polygon can be a sphere or a cube. The rotation values are in degrees.
A Tait-Bryan sequence is 3 angles that define the orientation of a body with respect to a referential, in this case the Earth's geocentric axis.
The first rotation (psi) is about the Z axis, the second (theta) around the new Y axis, and the third (phi) around the newest X axis.
Example
OvisT_3D_Cube * cube;
OvisT_TaitBryan rotation;
/* … cube created previously */
rotation.psi = 45;
rotation.theta = 0;
rotation.phi = 0;
Ovis_3D_Polygon_Rotation_Set (cube, rotation);
Errors
- Decoration is not a 3D sphere or cube.
- Decoration is NIL.
Reference
- Use the function
Ovis_3D_Polygon_Rotation_Get()to obtain the rotation of spheres or cubes.