Ovis_3D_Area_Point_Array_Set()
摘要
指定定义 3D 区域的点数组。
语法
Ovis_3D_Area_Point_Array_Set (area_dec_ptr, num_points, point_array)
| 参数 | 类型 | 说明 |
|---|---|---|
area_dec_ptr |
OvisT_3D_Area * |
目标区域 |
num_points |
unsigned int |
定义该区域的点的数量 |
point_array |
OvisT_3D_Position * |
定义该区域的点数组 |
返回类型
OvisT_Compcode
若成功设置数组,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
point_array 最多可包含 16 个点,用于定义一个凸多边形的边界。这些点必须采用大地(geodetic)坐标系或地心(geocentric)坐标系,并且必须按照沿区域边界出现的顺序在 point_array 中依次定义
示例
unsigned int num_points = 7;
OvisT_3D_Position * pt_array[num_points];
OvisT_3D_Area * area;
OvisT_Compcode status;
/* … area created at some point */
status = Ovis_3D_Area_Point_Array_Set (area, num_points, pt_array);
错误
- 装饰对象为 NIL。
- 区域必须定义若干个点。
- 区域最多只能定义 16 个点。
- 区域的第 #
<index>个点必须是地心或大地坐标位置。 - 装饰对象不是 3D 区域。
参考
- 使用函数
Ovis_3D_Area_Point_Array_Get()可获取定义区域的点。