op_anim_flow_end()
摘要
停止活动的动画流程,使后续的动画请求被忽略。
语法
op_anim_flow_end()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
void
无返回值
示例
/** Received an update packet from mobile node **/
/** obtain a pointer to the incoming packet. **/
pkptr = op_pk_get;
/* Extract the packet type field and position */
op_pk_nfd_get (pkptr, "type", &pktype);
op_pk_nfd_get (pkptr, "xpos", &xpos);
op_pk_nfd_get (pkptr, "ypos", &ypos);
/* All packet types cause depiction of new node position */
depict_mobnode_pos (xpos, ypos);
/* Last position update; depict new position & stop animation */
if (pktype == PKTYPE_END_POS_UPDATE)
op_anim_flow_end();
详情
动画流这一术语包括仿真中所有用户调用(自定义)动画 KP 或内核调用(自动)动画函数产生的数据。当任何进程模型、收发器管道模型或外部 C 函数执行此 KP 时,仿真的动画流即被停止。因此,后续对自定义或自动动画函数的调用基本上是不起作用的:它们不再生成新的动画数据,也不会导致打印错误或消息。不过,当在仿真调试器(ODB)中跟踪自定义动画 KP 调用时,跟踪语句会表明这些调用因动画流不活动而被“屏蔽”(忽略)(确切的消息将该 KP 的执行状态描述为 masked—animation inactive)。
一旦仿真的动画流被停止,就无法重新启动它(即没有对应的 KP 可以重启该流)。若要采集一段不以仿真开始为起点的仿真时间范围内的动画数据,可以使用动画探针的 anim start 和 anim stop 属性。
用途
提供一种在仿真结束前停止动画处理的机制。当只有仿真的一部分需要动画时,这很有用(例如,希望看到交换机数据包流的代表性视图,但不必让动画覆盖仿真中交换的所有数据包)。在仿真结束前停止动画流的附带好处是执行速度提升(由于动画 KP 不再完成执行)以及动画历史文件大小上限更小。事实上,很小的磁盘配额常常会被迫减少动画数据的采集。
错误
- 可恢复错误:写入动画历史文件
<file_name>失败。无法继续动画流(由于动画历史文件访问问题)。 - 可恢复错误:无法在文件中定位头部:
<file_name>(由于动画历史文件损坏或无效) - 可恢复错误:无法将头部写入文件:
<file_name>(由于动画历史文件访问问题)。
参考
- 使用 KP op_anim_viewer_close() 仅关闭单个动画查看器(在 op_vuanim 中擦除查看器窗口)。
- 使用 KP op_sim_end() 停止整个仿真(干净地结束动画并关闭历史文件或 op_vuanim 会话)。