op_anim_macro_create()

摘要

创建一个空宏,可通过调用 op_anim_mgp… 和 op_anim_mme… KPs 来定义它。

语法

op_anim_macro_create (mac_name)
参数 类型 说明
mac_name char* 宏名称
[该值是一个字符串,用作新宏的名称。]

返回类型

Anmid

宏 ID

示例

/** 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);

详情

如果已经创建了与 mac_name 参数同名的宏,则不会创建新宏,而是返回现有宏的 ID。因此,分布式进程可以使用宏名作为“会合点”,通过本 KP 共享同一个宏定义。宏一旦被关闭,再通过 op_anim_mgp… KP 调用向其添加图元的尝试将被忽略。

用途

提供了一种创建宏的机制;宏是一组可以作为单个原子操作调用的动画请求。宏调用适用于重复绘制由多个图形图元组成的图形。在查看器的模型图中、模型元素附近显示图形图元需要先定义宏,因为模型元素的位置只能在宏的上下文中通过 KP op_anim_mme_nobj_pos() 确定。

错误

  • 程序中止:segmentation violation(由于 mac_name 参数的字符串格式错误)

参考

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