Ovis_3D_Polygon_Scale_Get()
摘要
返回 3D 多边形的缩放比例。
语法
Ovis_3D_Polygon_Scale_Get (poly_ptr, x_scale_ptr, y_scale_ptr, z_scale_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
poly_ptr |
OvisT_Polygon * |
多边形缩放 |
x_scale_ptr |
double * |
多边形的 X 缩放 |
y_scale_ptr |
double * |
多边形的 Y 缩放 |
z_scale_ptr |
double * |
多边形的 Z 缩放 |
返回类型
OvisT_Compcode
若提供的对象是有效的多边形,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
此函数返回 3D 多边形的 x_scale、y_scale 和 z_scale 值。该多边形可以是球体、立方体或圆柱体。缩放因子均为 1.0 的立方体代表 1 立方米,每条棱长 1 米(或者,如果你愿意,也可以看作"半径"为 0.5 米的立方体)。缩放因子均为 1.0 的球体直径为 1meter。
对于圆柱体,只有 y_scale 和 z_scale 值有意义。
示例
OvisT_3D_Cube * cube;
double x_scale, y_scale, z_scale;
/* … cube created previously */
Ovis_3D_Polygon_Scale_Get (cube, &x_scale, &y_scale, &zscale);
错误
- Decoration 不是 3D 球体、立方体或圆柱体。
- Decoration 为 NIL。
- X 缩放值的返回地址为 NIL。
- Y 缩放值的返回地址为 NIL。
- Z 缩放值的返回地址为 NIL。
参考
- 使用函数
Ovis_3D_Polygon_Scale_Set()修改球体、立方体或圆柱体的半径。