op_anim_ime_nobj_update()
摘要
使用一组动画属性赋值,更新查看器中显示的模型对象。
语法
op_anim_ime_nobj_update (anvid, obj_type, obj_name, [ obj_attr_id, obj_attr_val, ]… OPC_EOL)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是引用某个查看器的数字标识符。对象更新将在该查看器的窗口中执行。] |
obj_type |
int |
对象类型代码 [该值是标识被更新对象类型的数字代码。支持的对象类型的符号常量见“Animation Object Type Symbolic Constants“ 第 8 页。] |
obj_name |
char* |
对象名称 |
obj_attr_id |
int |
对象属性 ID [该值是标识要更新的对象动画属性的数字代码;支持属性的符号常量见详情部分。] |
obj_attr_val |
void* |
用于赋值给对象属性的值 |
返回类型
void
无返回值
示例
/* Open a full-size animation viewer. */
vid = op_anim_viewer_open_std ("Network Display", OPC_ANIM_LOCATION_FULL);
/* Load and draw a network model into viewer. */
op_anim_ime_nmod_draw (vid, OPC_ANIM_MODTYPE_NETWORK, "anet", "top",
OPC_ANIM_MOD_OPTION_NONE, OPC_ANIM_DEFPROPS);
/* Determine the name of the "animation" node. */
mod_objid = op_id_self ();
node_objid = op_topo_parent (mod_objid);
op_ima_obj_attr_get (node_objid, "name", node_name);
/* Change the icon of the "animation" node so that it is not seen. */
op_anim_ime_nobj_update (vid, OPC_ANIM_OBJTYPE_NODE, node_name,
OPC_ANIM_OBJ_ATTR_ICON, "blank", OPC_EOL);
详情
本 KP 的参数包含一个由零个或多个对象动画属性赋值组成的列表。每个属性赋值由一对相邻参数(obj_attr_id 和 obj_attr_val)表示;该列表以符号常量 OPC_EOL(“End-Of-List”,列表结束)终止。支持的属性如下:
| 常量 | 说明 | 数据类型 |
|---|---|---|
OPC_ANIM_OBJ_ATTR_COLOR |
对象颜色(适用于路径对象) | integer |
OPC_ANIM_OBJ_ATTR_ICON |
对象图标(适用于基于图标的对象) | string |
OPC_ANIM_OBJ_ATTR_XPOS |
对象 x 坐标(仅限节点与子网) | double |
OPC_ANIM_OBJ_ATTR_YPOS |
对象 y 坐标(仅限节点与子网) | double |
OPC_ANIM_OBJ_ATTR_VECTOR_ANGLE |
对象矢量线 | double |
对象颜色属性接受与传递给图形属性参数的颜色标志相同的取值(即形如 OPC_ANIM_COLOR_<x> 的符号常量,如表 26 “Animation Graphical Property Symbolic Constants—Colors“ 第 4 页所列)。一般而言,只有路径对象会反映颜色属性的更新,只有基于图标的对象会反映 icon、xpos 和 ypos 属性的更新。对象 icon 属性接受一个图标名称字符串;指定的图标必须可被 op_vuanim 程序访问,以避免动画查看错误。对象 xpos 和 ypos 属性接受以模型图单位表示的浮点对象位置坐标(例如,对于节点,这些坐标可能以千米为单位)。除模型图缩放补偿之外,节点和进程模型的单位对应于屏幕像素。除参考部分列出的查看器 ID 来源之外,符号常量 OPC_ANIM_ANVID_PBSPEC 也可用作替代查看器 ID,表示应从处于激活状态的无标签自定义动画探针获取真实的查看器 ID。
用途
提供了一种动态更新模型元素某些图形方面的机制。例如,队列的图标可以根据其数据包级别在若干选项之间动态循环切换。
错误
- 程序中止:segmentation violation(由于
obj_attr_id或obj_attr_val参数的数据类型不正确,或obj_name参数的字符串格式错误) - 可恢复错误:Animation object attribute ID (
<obj_attr_id>) is out-of-range. Unable to continue animation flow.(由于对象属性 ID 超出范围) - 可恢复错误:Anim. object type (
<obj_type>) doesn’t support attribute ID (<obj_attr_id>). Unable to continue animation flow.(由于该对象不支持此属性 ID) anvid和obj_type参数超出范围时的标准诊断错误。
参考
- 使用 KP op_anim_ime_nmod_draw() 在动画查看器中加载并显示模型(在使用 op_anim_ime_nobj_update() 更新模型对象之前,必须先完成这一步)
- 使用 KP op_anim_mme_nobj_pos() 确定模型对象在宏中的位置,以便在该对象附近显示图形
- 使用 KP op_anim_viewer_open() 或 op_anim_viewer_open_std() 创建动画查看器并获取其 ID,或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID