Ovis_3D_Polygon_Rotation_Set()
摘要
指定 3D 多边形的旋转。
语法
Ovis_3D_Polygon_Rotation_Set (poly_ptr, rotation)
| 参数 | 类型 | 说明 |
|---|---|---|
poly_ptr |
OvisT_3D_Polygon * |
多边形 |
rotation |
OvisT_TaitBryan |
指定多边形的旋转 |
返回类型
OvisT_Compcode
若提供的对象是有效的多边形,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
此函数指定 3D 多边形的旋转。该多边形可以是球体或立方体。旋转值的单位为度。
Tait-Bryan 序列由 3 个角组成,用于定义一个物体相对于参考坐标系的方位,这里的参考坐标系是地球的质心坐标系。
第一个旋转(psi)绕 Z 轴进行,第二个(theta)绕新的 Y 轴进行,第三个(phi)绕最新的 X 轴进行。
示例
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);
错误
- Decoration 不是 3D 球体或立方体。
- Decoration 为 NIL。
参考
- 使用函数
Ovis_3D_Polygon_Rotation_Get()获取球体或立方体的旋转。