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 参数超出范围时的标准诊断错误。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com