子包

Anim 包的大部分 KP 都可归入表 5 所列的某个子包。

表 5:Anim 包子包

缩写 名称 说明
Igp Immediate-Mode Graphics Primitive 面向动画查看器的图形原语操作
Ime Immediate-Mode Model Element 面向动画查看器的模型元素操作
Mgp Macro-Oriented Graphics Primitive 追加到动画宏中的图形原语
Mme Macro-Oriented Model Element 追加到动画宏中的模型元素

Igp 子包的每个 KP 都会发出一个直接模式图形原语请求,指向特定的动画查看器。大多数 Igp KP 绘制常规图形组件,如下图所示。这些 KP 接受用于指定原语位置和尺寸的查看器坐标参数,以及决定原语外观的图形属性参数(属性包括前景色与背景色、填充图案、文本字体与对齐方式,以及保留)。若指定了 retain 属性,便会为这些原语创建保留绘图。

图 4:基本 Igp KP 绘制的形状

基本 Igp KP 绘制的形状

另有两个可产生绘图的 Igp KP:op_anim_igp_bg_fill() 用指定的颜色或图案填充动画查看器,op_anim_igp_macro_draw() 则按指定的参数赋值调用先前定义的宏。

从本质上讲,动画常常需要移动或更改图形原语。图形更新分解为两个步骤:

  1. 擦除旧原语
  2. 在另一位置绘制新原语,或更改其属性后绘制

第一步可用 KP op_anim_igp_drawing_erase() 完成,它会擦除并销毁一个保留绘图。对于宏绘图,两个更新步骤可在单个 KP op_anim_igp_macro_redraw() 中完成,它会将新的参数赋值应用于该宏绘图。

Mgp KP 将动画请求追加到指定的宏中,该宏稍后被调用时即执行这些请求。Mgp 子包主要由 Igp 绘制 KP 的宏导向等价物构成,如表 6 所示。

表 6:Igp KP 的 Mgp 等价物

Igp 子包 KP Mgp 子包 KP
op_anim_igp_bg_fill() op_anim_mgp_bg_fill()
op_anim_igp_circle_draw() op_anim_mgp_circle_draw()
op_anim_igp_circle_fill() op_anim_mgp_circle_fill()
op_anim_igp_icon_draw() op_anim_mgp_icon_draw()
op_anim_igp_line_draw() op_anim_mgp_line_draw()
op_anim_igp_rect_draw() op_anim_mgp_rect_draw()
op_anim_igp_rect_fill() op_anim_mgp_rect_fill()
op_anim_igp_text_draw() op_anim_mgp_text_draw()

可以把宏视为由 Mgp KP“语句”组成的简单过程。在这些语句中,寄存器起着变量的作用,为宏提供抽象能力。例如,若半径是寄存器值,单个宏即可绘制任意大小的圆。寄存器上的算术运算由两个 KP 支持:op_anim_mgp_arop() 对两个操作数寄存器和一个结果寄存器执行算术运算,即加法、减法、乘法和除法。KP op_anim_mgp_reg_set() 将常量值赋给寄存器。

宏可分为两个部分:setup(设置)与 graphics(图形)。setup 部分通常限于坐标值的计算,graphics 部分通常执行绘制操作。当进程模型调用宏时,setup 与 graphics 两部分都会执行。定义两个宏部分的原因,是把只需执行一次的设置操作分离出来,从而提高宏重复调用的性能。当宏最初由 op_anim_igp_macro_draw() 调用时,setup 与 graphics 部分通常都会执行。然而,当宏由 op_anim_igp_macro_redraw() 重复调用时,通常只执行 graphics 部分以完成擦除与重绘。类似地,当查看器的全部内容被重绘时,也只执行宏的 graphics 部分。可以指定特殊选项标志来改变这一行为:属性标志 OPC_ANIM_SETUP 将初次宏调用限制为只执行 setup 部分(并暂停由后续查看器重绘引发的执行,直到发生显式重绘为止),模式标志 OPC_ANIM_ERASE_MODE_XOR_RESET 则使 setup 部分在宏重复调用期间被执行。KP op_anim_mgp_setup_end() 定义 setup 部分的结束,并意味着 graphics 部分随即开始。若宏定义中没有 KP op_anim_mgp_setup_end(),则该宏只有 graphics 部分。

宏由不属于 Mgp 子包的 KP 来操纵。存在用于创建新宏(op_anim_macro_create())和销毁不再需要的宏(op_anim_macro_destroy())的 KP。宏创建时处于打开状态,因此可接受任意数量的 Mgp KP 引用向宏追加请求。当宏定义完成时,可通过 KP op_anim_macro_close() 将其改为关闭状态。关闭宏可防止添加新请求,并在共享该宏的多个进程之间提供简单的协调。

除前述基本图形原语 KP 外,Ime 子包提供了应用于动画查看器中显示的模型图的高层操作。在将任何其他 Ime KP 应用于查看器之前,必须先通过 KP op_anim_ime_nmod_draw() 在查看器中加载并显示模型图。该 KP 支持网络、节点和进程模型。注意 nmod 一词:它是“named model”(命名模型)的缩写,指目标模块由其名称属性标识。Ime 包中使用的其他类似术语还有 nobj(“named object”,命名对象)和 npath(“named path”,命名路径)。

模型图显示之后,可通过 KP op_anim_ime_nobj_update() 修改模型元素的图形属性。图形属性包括位置(移动节点)、颜色(路径元素)和图标(节点、模块和状态)。数据包和中断等动态对象不会出现在编辑器的模型图中,因为它们不属于模型结构。然而,它们可以出现在动画中,且可使用 KP op_anim_ime_npath_traverse() 来描绘数据包在数据包流上、中断在统计量连线上的穿行。

移动节点或网络模型图中其他移动对象的动画,是无线场景的一种重要可视化技术。对于显示网络模型图的查看器,KP op_anim_ime_gen_pos() 将位置数据从子网坐标转换为查看器坐标。该 KP 也为其他模型类型提供此服务;不过这些模型图具有简单的转换比例,如 1:1 或 2:1。进程模型可使用此 KP 确定移动或卫星节点的动态位置,并在该位置绘制图形原语。类似地,此 KP 可用于确定区域边界或固定节点等具有静态位置的对象的位置。

在模型元素附近绘制图形原语,需要先确定这些元素的位置。用于确定模型元素位置的动画 KP(op_anim_mme_nobj_pos())只在宏的上下文中运行,并将位置数据载入寄存器。

若干 Anim 包 KP 专门处理查看器问题。在将任何 Igp 或 Ime KP 应用于查看器之前,必须先获得动画查看器 ID。获得查看器 ID 有多种技术,其中之一是直接打开查看器。进程模型可使用 KP op_anim_viewer_open() 打开具有任意位置和尺寸的查看器,或使用 KP op_anim_viewer_open_std() 打开具有标准位置和尺寸、并随 op_vuanim 工作区增长而调整的查看器。如果向这些 KP 传入已打开查看器的名称,则不会打开新查看器,而是返回现有查看器的 ID。这一机制称为会合(rendezvous)。

查看器 ID 也可从与自定义动画探针关联的查看器获得。符号常量 OPC_ANIM_ANVID_PBSPEC 用作替代查看器 ID,表示应从任何活动的自定义动画探针获取实际查看器 ID。可使用 KP op_anim_lprobe_anvid() 从特定带标签的自定义动画探针获取动画查看器,该 KP 同样支持会合能力。若不存在具有指定标签的探针,则返回空查看器 ID,引用该查看器 ID 的 KP 不会被执行。

有时,在动画流中强制重绘查看器是有用的,以便使查看器显示的内容回到已知状态(所有非保留图形原语或干扰都被擦除,只有保留对象重新出现)。这可通过 KP op_anim_viewer_redraw() 完成。当不再需要某个查看器时,可通过 KP op_anim_viewer_close() 将其移除并释放。

若干 KP 处理动画流程控制。KP op_anim_force() 发出一个请求,op_vuanim 执行该请求时将强制显示窗口系统缓冲的任何图形操作。Ime 子包 KP 和宏调用会自动执行图形强制请求,但一组应当同时出现的 Igp 图形原语可能需要一个尾随的强制请求,具体取决于窗口系统的配置。动画流可由 KP op_anim_flow_end() 停止;此后对 Anim 包 KP 的调用将被仿真内核忽略。