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

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