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 参数无效时的标准诊断错误。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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