Ovis_Decoration_3D_Sphere_Create()
摘要
创建一个 3D 球体。
语法
Ovis_Decoration_3D_Sphere_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_Sphere *
3D 球体
头文件
ovis_decoration.h
详情
此函数创建 Ovis 3D 球体,并指定该球体的各项属性。球体的初始透明度为 0,图案为实心,且不会闪烁。
x_scale、y_scale 和 z_scale 缩放因子用于沿地心坐标系的 X、Y、Z 轴拉伸或收缩一个单位球体。缩放因子均为 1.0 的球体表示直径为 1 米的球体。
允许缩放因子为 0。当某一个缩放因子设为 0 时,会得到一个非常薄的圆盘;如果视点位于由另外两个半径所确定的平面内,该圆盘将不可见。
示例
OvisT_3D_Position pos;
OvisT_3D_Sphere * sphere;
PrgT_Color color = prg_color_from_string ("red");
Ovis_3D_Position_Geodetic_Set (&pos, 0, 0, 100);
sphere = Ovis_Decoration_3D_Sphere_Create (pos, 5, 5, 10, color, OvisC_True,
OPC_NIL, OPC_NIL, OPC_NIL);
错误
- X 缩放值无效(
<value>)。缩放值必须为正值。 - Y 缩放值无效(
<value>)。缩放值必须为正值。 - Z 缩放值无效(
<value>)。缩放值必须为正值。
参考
- 使用函数
Ovis_3D_Sphere_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()修改球体的朝向。