op_anim_ime_npath_traverse()

摘要

通过移动标记描绘查看器中显示的模型路径上的遍历。路径的例子包括网络链路和节点流。

语法

op_anim_ime_npath_traverse (anvid, path_type, path_name, trav_id, trav_options, props, text)
参数 类型 说明
anvid Anvid 查看器 ID
[该值是引用某个查看器的数字标识符。路径遍历将显示在该查看器的窗口中。]
path_type int 路径对象类型代码
path_name char* 路径名称
trav_id int 遍历 ID
trav_options int 遍历选项标志
props int 图形属性标志
[该值是“Animation Graphical Property Symbolic Constants—Text Alignment“ 第 3 页下列出的符号常量标志的按位 OR 组合。]
text char* 与遍历关联的文本

返回类型

void

无返回值

示例

/* Receive a cell on input stream. */
cell_ptr = op_pk_get (op_intrpt_strm ());

/* Extract ID & address information. */
op_pk_nfd_get (cell_ptr, "cell id",  &cell_id);
op_pk_nfd_get (cell_ptr, "src_addr", &src_addr);
op_pk_nfd_get (cell_ptr, "dst_addr", &dst_addr);

/* Determine next hop of cell and forward. */
out_strm = cell_route_next_hop_port (dst_addr, local_id);
op_pk_send (cell_ptr, out_strm);

/* Animate cell’s transmission to next switch. */
sprintf (cell_data, "cell #%d: s(%d) d(%d)",
		cell_id, src_addr, dst_addr);
op_anim_ime_npath_traverse (vid, OPC_ANIM_OBJTYPE_STREAM, strm_name [out_strm],
	Trav_Id++, OPC_ANIM_TRAV_OPTION_CIRCLE | OPC_ANIM_TRAV_OPTION_FULL |
	OPC_ANIM_TRAV_OPTION_TEXT, OPC_ANIM_COLOR_YELLOW, cell_data);

详情

路径遍历受 color 图形属性影响。移动标记的 color 图形属性可以赋值 64 个索引颜色值中的任意一个(格式为 OPC_ANIM_COLOR_RGB<rgb>)或 25 个命名颜色值之一(默认颜色值为黑色)。

path_type 参数应传入格式为 OPC_ANIM_OBJTYPE_<type> 的符号常量,其中 <type> 的可能取值包括网络模型图中的 SIMPLINK、DUPLINK、BUSLINK 和 TAPLINK,或节点模型图中的 STREAM 和 STATWIRE。

路径遍历提供了若干选项,由传递给 trav_options 参数的标志的按位 OR 组合指定。选项标志的格式为 OPC_ANIM_TRAV_OPTION_<opt>,选项值包括:标记形状(CIRCLE 或 SQUARE)、文本启用(TEXT)、遍历方向(REVERSE)以及遍历范围(FULL——标记从源到目的地遍历完整路径,SRC_BEGIN——标记从路径源遍历到中点,DST_END——标记从路径中点遍历到目的地)。还有一些主要由仿真内核(Simulation Kernel)的自动仿真功能使用的高级选项(这些列在表 46 “Animation Path Traverse Option Symbolic Constants“ 第 9 页中)。

trav_id 参数是唯一标识特定遍历的整数值;这使得目的地遍历能够回溯引用源遍历,从而移动相应的标记。

用途

提供了一种描绘信息(如数据包)在网络中移动的机制。通常,此 KP 应用于节点流或网络链路对象,以描绘沿此类连接流动的消息。

错误

  • 程序中止:segmentation violation(由于 path_name 或 text 参数的字符串格式错误)
  • 诊断错误:Animation viewer ID (<anvid>) is out-of-range.(由于 anvid 参数的值无效)
  • 诊断错误:Kernel procedure argument (<arg_name>) has out-of-range value (<arg_val>).(由于 path_type 或 trav_options 参数的值无效)
  • 诊断错误:Invalid property component (<prop_comp>) for graphical primitive.(由于 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