op_sim_anim()

摘要

判断仿真当前是否处于动画模式。

语法

op_sim_anim ()
参数 类型 说明
无参数

返回类型

Boolean

布尔值,指示仿真是否被配置为生成动画请求。如果动画已启用,该值为 OPC_TRUE,否则为 OPC_FALSE。

示例

/* If animation is not currently enabled, avoid doing unnecessary work. */
if (op_sim_anim ())
	{
	/* 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);
	}

详情

当仿真执行时设置了 anim_hist 或 anim_view 环境属性以启用动画请求的生成,该仿真即处于动画模式。以下示例命令行演示了使用这些属性启用仿真:

%example.sim -anim_hist my_anim
%example.sim -anim_view

如果动画事件的生成因错误而停止(例如无法与动画服务器通信),op_sim_anim() 将返回 OPC_FALSE,指示动画已不再活动。

用途

该内核过程提供了开发自带动画能力的进程模型、同时保持仿真效率的能力。该内核过程的预期用途是:当动画当前不活动时,避免执行 Anim 包调用和其他与动画相关的计算。通常,与动画相关的计算和调用会被归组到一个 if 语句中,其条件为 (op_sim_anim() == OPC_TRUE)。

通过使用这一能力,用户可以开发内置动画的模型,但在不需要动画时以接近最高的效率运行。在两种模式之间切换无需重新编译。

错误

  • 不捕获任何错误。

参考

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