Ovis_Decoration_Info_Template_Range_Element_Add()
摘要
向 Ovis 模板添加范围元素。
语法
Ovis_Decoration_Info_Template_Range_Element_Add (tmpl_ptr, element_name, min_value, max_value)
| 参数 | 类型 | 说明 |
|---|---|---|
tmpl_ptr |
OvisT_Info_Template * |
模板 |
element_name |
const char * |
元素名称 |
min_value |
double |
范围的最小值 |
max_value |
double |
范围的最大值 |
返回类型
OvisT_Compcode
若范围元素能够被添加,则为 OvisC_Compcode_Success;否则为 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
此函数向 Ovis 模板添加范围元素。它在实例中将显示为一个小型水平矩形:当值小于 min_value 时矩形为空心,当值大于 max_value 时为实心填充,否则根据该值与最小/最大范围从矩形左侧部分填充。
示例
#define NOISE_LEVEL_FIELD "noise"
OvisT_Info_Template * template;
OvisT_Info_Group * info;
OvisT_3D_Position pos;
template = Ovis_Decoration_Info_Template_Create ("Interference");
Ovis_Decoration_Info_Template_Range_Element_Add (template, NOISE_LEVEL_FIELD,
0, 10);
Ovis_Position_Geodetic_Set (&pos, 0, 0, 100);
info = Ovis_Decoration_Info_Group_Create (template, pos,
prg_color_from_string ("blue"), OPC_NIL, OPC_NIL, OPC_NIL);
Ovis_Decoration_Info_Group_Scalar_Element_Value_Set (info, NOISE_LEVEL_FIELD, 3);
错误
- 模板为 NIL。
- 未提供元素名称。
- 最小值 <value> 必须小于最大值 <value>。
- 元素 "<name>" 已经是模板的一部分。
参考
- 使用函数
Ovis_Decoration_Info_Group_Scalar_Element_Value_Set()在模板实例中设置该元素的值。