Ovis_Decoration_3D_Cube_Create()
摘要
创建 3D 立方体。
语法
Ovis_Decoration_3D_Cube_Create (center, x_scale, y_scale, z_scale, color, filled, layer_ptr, destroy_proc, user_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
center |
OvisT_3D_Position |
立方体的中心 |
x_scale |
double |
立方体的 X 缩放 |
y_scale |
double |
立方体的 Y 缩放 |
z_scale |
double |
立方体的 Z 缩放 |
color |
PrgT_Color |
颜色 |
filled |
OvisT_Boolean |
指示是否填充 |
layer_ptr |
OvisT_Layer * |
Ovis 图层 |
destroy_proc |
OvisT_Decoration_State_Destroy_Proc |
销毁与该对象关联的数据并释放其内存 |
user_state_ptr |
void * |
可选的用户提供的装饰状态 |
返回类型
OvisT_3D_Cube *
该 3D 立方体
头文件
ovis_decoration.h
详情
该函数创建 Ovis 3D 立方体,并指定立方体的各属性。立方体的初始透明度为 0,图案为实心,且不闪烁。
x_scale、y_scale 和 z_scale 因子用于沿地球地心坐标系的 X、Y 和 Z 轴拉伸或收缩一个单位立方体。缩放因子均为 1.0 的立方体代表 1 立方米,每条棱长 1 米(或者,也可以理解为一个"半径"为 0.5 米的立方体)。
允许缩放因子为 0。当其中一个缩放因子设为 0 时,会得到一个非常薄的矩形;如果视点位于由另外两个半径所定义的平面内,则它不可见。
示例
OvisT_3D_Position pos;
OvisT_3D_Cube * cube;
PrgT_Color color = prg_color_from_string ("red");
Ovis_3D_Position_Geodetic_Set (&pos, 0, 0, 100);
cube = Ovis_Decoration_3D_Cube_Create (pos, 5, 5, 10, color, OvisC_True,
OPC_NIL, OPC_NIL, OPC_NIL);
错误
- X 半径值无效(<value>)。半径值必须为正数。
- Y 半径值无效(<value>)。半径值必须为正数。
- Z 半径值无效(<value>)。半径值必须为正数。
参考
- 使用
Ovis_3D_Cube_Center_Set()函数修改立方体的中心。 - 使用
Ovis_Decoration_Color_Set()函数修改立方体的颜色。 - 使用
Ovis_Decoration_Transparency_Set()函数修改立方体的透明度。 - 使用
Ovis_Decoration_Flashing_Set()函数修改闪烁状态。 - 使用
Ovis_Shape_Pattern_Set()函数修改立方体渲染区域所使用的图案。 - 使用
Ovis_Polygon_Fill_Set()函数修改填充状态。 - 使用
Ovis_3D_Polygon_Scale_Set()函数修改立方体和砖块的半径。 - 使用
Ovis_3D_Polygon_Rotation_Set()函数修改立方体的朝向。