Ovis_3D_Polygon_Scale_Set()
摘要
指定 3D 多边形的缩放比例。
语法
Ovis_3D_Polygon_Scale_Set (poly_ptr, x_scale, y_scale, z_scale)
| 参数 | 类型 | 说明 |
|---|---|---|
poly_ptr |
OvisT_Polygon * |
多边形缩放 |
x_scale |
double |
多边形的 X 缩放 |
y_scale |
double |
多边形的 Y 缩放 |
z_scale |
double |
多边形的 Z 缩放 |
返回类型
OvisT_Compcode
若提供的对象是有效的多边形,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
此函数指定 3D 多边形的 x_scale、y_scale 和 z_scale。该多边形可以是球体、立方体或圆柱体。
x_scale、y_scale 和 z_scale 因子用于沿地球质心坐标系的 X、Y、Z 轴拉伸或收缩单位立方体或球体。缩放因子均为 1.0 的立方体代表 1 立方米,每条棱长 1 米(或者,如果你愿意,也可以看作"半径"为 0.5 米的立方体)。缩放因子均为 1.0 的球体直径为 1meter。
对于圆柱体,x_scale 因子被忽略,而 y_scale 和 z_scale 因子按圆柱体的局部坐标系应用。X 轴是圆柱体的轴线,Y 轴指向右侧,Z 轴朝下指向地心。
允许缩放因子为 0。当某个缩放因子设为 0 时,会得到一个非常薄的矩形或圆盘,如果视点位于另外两个半径所确定的平面内,则它不可见。
注意,图案不受缩放影响。图案始终在应用缩放之后沿垂直方向覆盖 32 位。
另请注意,缩放发生在旋转之前。
示例
OvisT_3D_Sphere * sphere;
/* … sphere created previously */
/* Making a disk with 0 thickness along the Z axis */
Ovis_3D_Polygon_Scale_Set (sphere, 2.0, 5.5, 0.0);
错误
- Decoration 不是 3D 球体、立方体或圆柱体。
- Decoration 为 NIL。
- X 缩放值无效(
<value>)。缩放值必须为正。 - Y 缩放值无效(
<value>)。缩放值必须为正。 - Z 缩放值无效(
<value>)。缩放值必须为正。
参考
- 使用函数
Ovis_3D_Polygon_Scale_Get()获取球体、立方体或圆柱体的半径。