op_anim_mgp_reg_set()

摘要

向指定宏添加一个图元,为寄存器赋值。

语法

op_anim_mgp_reg_set (anmid, regid, regval)
参数 类型 说明
anmid Anmid 宏 ID
[该值是引用某个已打开动画宏的数字标识符,由 KP op_anim_macro_create() 创建。]
regid int 宏绘图寄存器 ID
[该值是标识待设置宏寄存器的数字代码。名为 A-Z 的 26 个宏寄存器由预定义符号常量标识,这些常量列于第 8 页表 42。]
regval void* 要赋给宏寄存器的值
[由于宏寄存器可以保存整数、double 或字符串(char*)值,此参数声明为 void*,但可以传入这三种数据类型中的任意一种。]

返回类型

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 的 regid 参数接受宏寄存器 ID 符号常量,如“Animation Macro Register Identifier Symbolic Constants—Integer Values“ 第 8 页下列出的常量。regval 参数指定的值将在宏被调用时赋给指定的寄存器。该值在宏定义内被视为常量,因为宏的所有调用都会有相同的值赋值。

用途

提供了一种在宏内部将寄存器设置为传入值的机制,这是在宏内执行涉及常量值的算术运算所必需的(KP op_anim_mgp_arop() 只接受寄存器参数,不能传入字面值)。

错误

  • 可恢复错误:Animation macro ID (<anmid>) is [out-of-range] [unrecognized].(前者由于 anmid 参数的值无效,后者由于宏已被销毁)
  • 可恢复错误:Animation macro register ID (<regid>) is invalid.(由于 regid 参数的值无效)

参考

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