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>)。缩放值必须为正。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com