op_anim_macro_close()

摘要

关闭指定的宏,禁止通过 op_anim_mgp… 或 op_anim_mme… KP 调用添加更多操作(此类 KP 调用实际上将成为空操作)。

语法

op_anim_macro_close (anmid)
参数 类型 说明
anmid Anmid 宏 ID
[动画宏 ID 可在通过 KP op_anim_macro_create() 创建宏时获得。]

返回类型

void

无返回值

示例

/** Construct a macro which depicts a field within a packet. **/
mid = op_anim_macro_create ("pk field");

/* Draw a rectangle fixed at (X,Y) which has width(W) = no. bits(B) x 8 */
op_anim_mgp_reg_set (mid, OPC_ANIM_REG_C_INT, 8);
op_anim_mgp_arop (mid, OPC_ANIM_REG_B_INT, OPC_ANIM_AROP_MULTIPLY,
	OPC_ANIM_REG_C_INT, OPC_ANIM_REG_W_INT);
op_anim_mgp_rect_draw (mid, OPC_ANIM_COLOR_RED, OPC_ANIM_REG_X_INT,
	OPC_ANIM_REG_Y_INT, OPC_ANIM_REG_W_INT, 15);

/* Draw the field name at (L,Y) where L = X + (W / 2) */
op_anim_mgp_reg_set (mid, OPC_ANIM_REG_C_INT, 2);
op_anim_mgp_arop (mid, OPC_ANIM_REG_W_INT, OPC_ANIM_AROP_DIVIDE, OPC_ANIM_REG_C_INT,
	OPC_ANIM_REG_H_INT);
op_anim_mgp_arop (mid, OPC_ANIM_REG_X_INT, OPC_ANIM_AROP_ADD, OPC_ANIM_REG_H_INT,
	OPC_ANIM_REG_L_INT);
op_anim_mgp_text_draw (mid, OPC_ANIM_ALIGNH_CENTER | OPC_ANIM_ALIGNV_BOTTOM |
	OPC_ANIM_FONT_OPEN_10 | OPC_ANIM_COLOR_RED,
	OPC_ANIM_REG_L_INT, OPC_ANIM_REG_Y_INT, OPC_ANIM_REG_S_STR);
op_anim_macro_close (mid);

详情

宏在通过 KP op_anim_macro_create() 创建后立即处于打开状态:它可以被任意多次 op_anim_mgp… 或 op_anim_mme… KP 调用引用,并将由此产生的宏请求追加到宏的末尾。宏必须保持打开状态,直到其所有组成请求都已追加完毕。宏一旦被完整定义,即可通过本 KP 将其关闭。关闭宏后将禁止再添加请求。

由于以相同的宏名多次调用 op_anim_macro_create() 会返回同一个宏 ID,而且由于使用已关闭宏的 ID 调用 op_anim_mgp… 或 op_anim_mme… KP 只会产生静默的空操作,因此多个进程和/或进程实例共享的宏,可以由“第一个作者”调用 op_anim_macro_close() 封存宏的定义来完成定义。

用途

提供了一种将宏定义为已完成的机制,使得被多次实例化的进程模型可以在各实例之间无需特殊同步的情况下定义宏。第一个定义宏的进程实例将会成功,而所有其他实例将只是与原始定义会合。

错误

  • 可恢复错误:Animation macro ID (<anmid>) is out-of-range.(由于 anmid 参数的值无效)

参考

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