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参数的值无效)
参考
- 使用 KP op_anim_mgp_reg_set() 在寄存器中存储常量值,供算术运算使用
- 使用 KP op_anim_macro_create() 创建空宏
- 使用 KP op_anim_macro_close() 表示宏定义已完成
- 使用 KP op_anim_igp_macro_draw() 在查看器内调用宏