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参数的值不适用或无效)
参考
- 使用 KP op_anim_ime_nmod_draw() 在动画查看器中加载并显示模型(在使用 op_anim_ime_npath_traverse() 遍历模型路径对象之前,必须先完成这一步)
- 使用 KP op_anim_mme_nobj_pos() 确定模型对象在宏中的位置,以便在这些对象附近显示图形
- 使用 KP op_anim_viewer_open() 或 op_anim_viewer_open_std() 创建动画查看器并获取其 ID,或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID