op_anim_ime_nmod_draw()
摘要
在查看器中加载并绘制指定的模型图。
语法
op_anim_ime_nmod_draw (anvid, mod_type, mod_name, view_name, mod_options, props)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是引用某个查看器的数字标识符。指定的模型将显示在该查看器的窗口中。] |
mod_type |
int |
模型类型代码 [该值是标识模型类型的数字代码。] |
mod_name |
char* |
模型名称 |
view_name |
char* |
模型视图名称 [该值是标识所绘制模型的某个特定视图名称的字符串。] |
mod_options |
int |
模型绘制选项标志 |
props |
int |
图形属性标志 [该值被 op_vuanim 查看器程序忽略,可以赋值为 0。将其定义为参数是为了支持将来对模型图形属性的修改。] |
返回类型
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);
详情
与名称中包含 “draw” 一词的其他动画 KP 不同,此 KP 不会产生之后可以被擦除的绘图。指定的查看器与所绘制的模型永久关联。
可以在查看器内绘制的模型有三种类型,由 mod_type 参数指定:
可接受的符号常量格式为 OPC_ANIM_MODTYPE_<m>,其中 <m> 为 NETWORK、NODE 或 PROCESS。view_name 参数指定的模型视图仅适用于网络模型;对于其他模型类型会被忽略。网络模型每个子网内的图都被视为一个独立的视图,可以通过子网名称指定。
模型显示可以通过多个选项修改,由 mod_options 参数指定。选项符号常量标志(列于“Animation Model Drawing Option Symbolic Constants“ 第 7 页。)相互独立,可以通过按位 OR 组合。使用标志 OPC_ANIM_MOD_OPTION_NONE 可获得默认模型显示。最常用的选项是在网络模型中描绘轨迹与轨道(OPC_ANIM_MOD_OPTION_DYNPATHS)以及进程模型的半尺寸显示(OPC_ANIM_MOD_OPTION_HFSIZE)。
除参考部分列出的查看器 ID 来源之外,符号常量 OPC_ANIM_ANVID_PBSPEC 也可用作替代查看器 ID,表示应从处于激活状态的无标签自定义动画探针获取真实的查看器 ID。
用途
提供了一种在查看器内加载并显示模型的机制,用作自定义动画显示的背景。模型对象的位置可以在宏中确定,并用于在这些对象附近放置图形图元。模型对象的某些图形属性可以被更新以描绘对象状态的变化(例如更改队列的图标以描绘其长度、更改链路的颜色以描绘其利用率、或更改移动节点的图标位置以描绘其移动)。数据包跨越连接或链路的传输也可以方便地以动画方式呈现。部分基于模型的动画请求在参考部分讨论。这些请求依赖于模型此前已由本 KP 加载并显示。
错误
- 程序中止:segmentation violation(由于
mod_name或view_name参数的字符串格式错误) - 可恢复错误:Unable to read network model (
<mod_name>) for animation.(由于网络模型名称无法识别——此 KP 在仿真中只加载网络) - 可恢复错误:Unable to set specified view (
<view_name>).(由于网络模型中的子网名称无法识别) anvid和mod_type参数超出范围、以及props参数无效时的标准诊断错误。
参考
- 使用 KP op_anim_mme_nobj_pos() 在宏中确定模型对象的位置
- 使用 KP op_anim_ime_nobj_update() 更新已显示模型对象的某个图形属性
- 使用 KP op_anim_ime_npath_traverse() 动态描绘模型路径对象的传输(例如数据包穿越链路或连接)
- 使用 KP op_anim_viewer_open() 或 op_anim_viewer_open_std() 获取新创建动画查看器的 ID(或与此前已打开的查看器会合),或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID