op_anim_igp_macro_redraw()
摘要
重新调用与现有绘图关联的宏,并提供一组新的寄存器赋值。此前创建的绘图通过其绘图 ID 引用,并且通常在其关联宏被重绘之前先被擦除。
语法
op_anim_igp_macro_redraw (anvid, andid, mode, [ regid, regval, ]… OPC_EOL)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是引用某个查看器的数字标识符。指定绘图所关联的宏将在该查看器的窗口上下文中被重新调用。] |
andid |
Andid |
此前绘制的宏的绘图 ID |
mode |
int |
擦除模式 [该值是数字代码,标识用于擦除宏绘图先前屏幕显示效果的技术。擦除模式符号常量列于详情部分。] |
regid |
int |
绘图寄存器 ID [该值是数字代码,标识要被赋值的特定宏寄存器。] |
regval |
void* |
要赋值给宏寄存器的值 |
返回类型
void
无返回值
示例
/* Determine type of interrupt. */
itype = op_intrpt_type ();
/* Process queue statistic interrupt. */
if (itype == OPC_INTRPT_STAT)
{
/* Map queue level into color value. */
queue_size = op_stat_local_read (op_intrpt_stat ());
if (queue_size < 5)
color = OPC_ANIM_COLOR_BLUE;
else if (queue_size < 10)
color = OPC_ANIM_COLOR_PURPLE;
else color = OPC_ANIM_COLOR_PINK;
/* Redraw queue status indicator with new color. */
op_anim_igp_macro_redraw (vid, did, OPC_ANIM_ERASE_MODE_XOR,
OPC_ANIM_REG_C_INT, color, OPC_EOL);
}
详情
本 KP 的参数包含一个由零个或多个寄存器赋值组成的列表。每个寄存器赋值由一对相邻参数(regid 和 regval)表示,列表以符号常量 OPC_EOL(“End-Of-List”)终止。名为 A-Z 的 26 个宏寄存器由预定义的符号常量标识,这些常量列于“Animation Macro Register Identifier Symbolic Constants—Integer Values“ 第 8 页。由于宏寄存器可以保存 integer、double 或字符串(char*)值,regval 参数声明为 void*,但可以是这三种数据类型中的任意一种。
在宏以新的寄存器赋值重绘之前,其现有绘图会被擦除。绘图擦除的模式由 mode 参数设置,该参数可取三个符号常量值之一。XOR 模式(exclusive-OR;由 OPC_ANIM_ERASE_MODE_XOR 指定)通过以旧的寄存器值重新调用宏绘图来将其擦除。重绘模式(由 OPC_ANIM_ERASE_MODE_REDRAW 指定)通过重绘查看器来擦除宏绘图,然后重新调用宏。禁用的擦除模式(由 OPC_ANIM_ERASE_MODE_NONE 指定)对本 KP 没有用处。有关擦除模式的更多信息,见 KP op_anim_igp_drawing_erase() 的详情部分。
除参考部分列出的查看器 ID 来源之外,符号常量 OPC_ANIM_ANVID_PBSPEC 也可用作替代查看器 ID,表示应从处于激活状态的无标签自定义动画探针获取真实的查看器 ID。
用途
提供了一种以新参数(寄存器赋值)重新调用此前绘制的宏的机制。这大致等同于通过 KP op_anim_igp_drawing_erase() 擦除先前的宏绘图,然后通过 KP op_anim_igp_macro_draw() 重新调用该宏。然而,重绘 KP 提供了单一调用格式的便利,并且只需指定发生变化的寄存器赋值。涉及动画宏的典型策略:具有多个参数的宏只在仿真开始时以全部寄存器赋值绘制一次,此后随着条件变化,只以一到两个寄存器赋值进行重绘。包含 KP op_anim_mme_nobj_pos() 的宏需要为正确重绘进行特殊设计;有关此主题的信息,参见 op_anim_mme_nobj_pos() KP。
错误
- 程序中止:segmentation violation(由于
regid或regval参数的数据类型不正确) - 可恢复错误:Animation macro register ID (
<regid>) is invalid. Unable to continue animation flow.(由于regid参数的值无效) - 诊断错误:Animation viewer ID (
<anvid>) is out-of-range.(由于anvid参数的值无效) - 诊断错误:Animation drawing ID (
<andid>) is out-of-range.(由于andid参数的值无效)
参考
- 使用 KP op_anim_macro_create() 创建宏,并使用
op_anim_mgp…KP 定义它 - 使用 KP op_anim_igp_macro_draw() 初始绘制宏
- 使用 KP op_anim_igp_drawing_erase() 擦除并释放保留的宏绘图
- 使用 KP op_anim_viewer_open() 或 op_anim_viewer_open_std() 获取新创建动画查看器的 ID(或与此前已打开的查看器会合),或使用 KP op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID