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)。
通过使用这一能力,用户可以开发内置动画的模型,但在不需要动画时以接近最高的效率运行。在两种模式之间切换无需重新编译。
错误
- 不捕获任何错误。
参考
- 使用内核过程 op_ima_sim_attr_get() 获取任意环境属性的值
- 使用内核过程 op_sim_debug() 判断仿真是否处于调试模式