op_anim_igp_drawing_erase()
摘要
从查看器中擦除并释放一个保留绘图。
语法
op_anim_igp_drawing_erase (anvid, andid, mode)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是引用某个查看器的数字标识符。指定的绘图将从该查看器的窗口中被擦除。] |
andid |
Andid |
待擦除的绘图 ID [该值是引用某个保留绘图的数字标识符,该绘图由某个 op_anim_igp… 内核过程创建。] |
mode |
int |
擦除模式 [该值是数字代码,标识擦除指定绘图屏幕显示效果所采用的技术。擦除模式符号常量列于“Animation Drawing Erase Mode Symbolic Constants“ 第 7 页,也见详情部分。] |
返回类型
void
无返回值
示例
/* Received a packet forwarding interrupt; determine which packet has been identified. */
iciptr = op_intrpt_ici ();
op_ici_attr_get (iciptr, "pk_id", &pk_id);
/* Loop through queue contents, looking for the identified packet. */
for (i = 0, q_size = op_subq_stat (0, OPC_QSTAT_PKSIZE); i < q_size; i++)
{
/* Peek at packet, and test ID. */
pkptr = op_subq_pk_access (0, i);
if (op_pk_id (pkptr) == pk_id)
{
/* Remove & forward packet. */
op_subq_pk_remove (0, i);
op_pk_send (pkptr, OUT_STRM);
/* Erase drawing of packet in animation. */
op_ici_attr_get (iciptr, "pk_did", &pk_did);
op_anim_igp_drawing_erase (vid, pk_did, OPC_ANIM_ERASE_MODE_XOR);
break;
}
}
详情
此操作提供两项相互独立的服务:
- 从查看器中擦除保留绘图
- 释放与保留绘图关联的内存,使其在查看器重绘时不再被重新绘制。
绘图擦除的模式由 mode 参数设定。最常用的模式是使用 XOR(异或)pixop 图形属性重新显示绘图来将其擦除;该模式由符号常量 OPC_ANIM_ERASE_MODE_XOR 指定。前提是绘图最初就是使用该 pixop 显示的,且该绘图此后没有被其他非 XOR pixop 图形覆盖,那么这种技术可以将绘图从查看器中完美切除,不留任何图形副作用。
要使用 XOR pixop 显示保留绘图,需指定图形属性标志 OPC_ANIM_PIXOP_XOR。重绘模式(由符号常量 OPC_ANIM_ERASE_MODE_REDRAW 指定)并不直接擦除绘图;它先释放绘图,然后重绘整个查看器。其最终效果同样是擦除了绘图,且相比 XOR 模式的优势在于可以擦除以任意 pixop 显示的绘图。但它也有副作用:会擦除所有非保留图形,若频繁使用还可能导致动画迟缓、不连贯。
还有一种禁用的擦除模式(由符号常量 OPC_ANIM_ERASE_MODE_NONE 指定),它不擦除绘图,只将其释放。该模式下擦除的实际生效依赖于随后的查看器重绘。除了下文参考部分列出的查看器 ID 来源之外,符号常量 OPC_ANIM_ANVID_PBSPEC 也可用作替代查看器 ID,表示真正的查看器 ID 应从处于激活状态的无标签自定义动画探针获取。
用途
提供了一种擦除动态动画中不应再显示的保留绘图的机制。保留绘图的能力为用户在 op_vuanim 中提供了灵活性(即查看器可以被移动、调整大小或循环切换,保留绘图会被重新显示)。擦除绘图的能力支持对查看器的非单调更新,使动画能够动态跟踪仿真的状态。擦除绘图的典型应用包括移动节点、动态状态指示器(仅在特定条件成立时才显示的符号和文本),以及描绘动态连接关系的线条。
错误
- 诊断错误:Animation viewer ID (
<anvid>) is out-of-range.(由于anvid参数的值无效) - 诊断错误:Animation drawing ID (
<andid>) is out-of-range.(由于andid参数的值无效)
参考
- 使用任意
op_anim_igp…内核过程创建绘图,这些绘图之后可由本内核过程擦除 - 使用内核过程 op_anim_viewer_redraw() 来实现对已由本内核过程以
OPC_ANIM_ERASE_MODE_NONE模式释放的绘图的擦除 - 使用内核过程 op_anim_viewer_open() 或 op_anim_viewer_open_std() 获取新创建动画查看器的 ID(或与此前已打开的查看器会合),或使用内核过程 op_anim_lprobe_anvid() 获取由带标签的自定义动画探针打开的查看器的 ID