op_anim_mgp_arop()

摘要

向指定的宏添加一个图元,该图元使用指定的操作数寄存器和结果寄存器执行算术运算。

语法

op_anim_mgp_arop (anmid, opa_regid, operator, opb_regid, res_regid)
参数 类型 说明
anmid Anmid 宏 ID
[该值是引用某个处于打开状态的动画宏的数字标识符,该宏由 KP op_anim_macro_create() 创建。]
opa_regid int 操作数 A 的宏绘图寄存器 ID
operator int 算术运算符代码
opb_regid int 操作数 B 的宏绘图寄存器 ID
res_regid int 运算结果的宏绘图寄存器 ID

返回类型

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 的 opa_regid、opb_regid 和 res_regid 参数接受宏寄存器 ID 符号常量,如“Animation Macro Register Identifier Symbolic Constants—Integer Values“ 第 8 页下列出的常量。opa_regid 和 opb_regid 指定的寄存器的值用作运算的输入(运算由 operator 参数的值指定),结果存储在 res_regid 指定的寄存器中,如下所示:

<result> = <reg A> <op> <reg B>

其中 <op> 是算术运算符(加、减、乘、除)之一,由符号常量 OPC_ANIM_AROP_<op> 表示,<op> 为 ADD、SUBTRACT、MULTIPLY 或 DIVIDE。本 KP 的 operator 参数只接受这些算术运算符常量,不支持绘图寄存器引用。

为本 KP 指定的所有寄存器必须是数值型的(即整数寄存器或 double 寄存器)。运算结果会转换为结果寄存器的数据类型。如果两个操作数的数据类型相同,则使用该数据类型执行运算。如果操作数的数据类型不同,则整数操作数被转换为 double,并使用 double 值执行运算。

用途

提供了一种在宏的上下文中执行涉及寄存器的算术运算的机制。这通常用于根据存储在寄存器中的宏输入参数计算图形偏移和位置。

错误

  • 可恢复错误:Animation macro ID (<anmid>) is [out-of-range] [unrecognized].(前者由于 anmid 参数值无效,后者由于宏已被销毁)
  • 诊断错误:Animation operator code (<operator>) is out-of-range.(由于 operator 参数的值无效)
  • 诊断错误:Animation macro register ID (<regid>) is out-of-range.(由于 opa_regid、opb_regid 或 res_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