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 参数的值无效)

参考

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