动画流的激活与路由

动画流不是仿真的默认副产物。相反,动画流必须由用户专门激活。流的激活通过组合仿真首选项与应用于仿真的探针列表中的动画探针来完成。除了激活流之外,仿真的动画相关首选项还指定流将如何路由(路由生成的动画数据有多个可用选项)。除了指定哪些模型对象产生哪些类型的动画之外,动画探针还指定查看器选项和动画时间范围限制。两类激活要求——动画相关首选项和动画探针——都在本节中描述。

仿真生成的动画流有两种路由选项:(1) 路由到 op_vuanim 中的直接查看;(2) 路由到动画历史文件。如果相应的仿真首选项没有选择这两个路由选项中的任何一个,则不会生成动画流。每个路由选项都在下面的独立小节中分别描述。

直接查看

在直接查看选项中,动画流数据从正在执行的仿真直接路由到并发执行的 op_vuanim 程序实例。仿真与 op_vuanim 之间的通信方式是底层网络数据报协议。使用该网络协议支持本地和远程两种查看场景:在远程查看场景中,op_vuanim 在与仿真不同的主机计算机上执行;在本地场景中,op_vuanim 与仿真在同一主机计算机上执行。

仿真和 op_vuanim 进程由动画流同步,因此仿真在向 op_vuanim 发送一个动画请求后会停止推进,直到收到 op_vuanim 已实际显示该请求的确认。通过这种同步,用户可以以可调节的节奏查看仿真进展,而不会让仿真远远超前于用户在动画流中的位置,从而产生大量动画流数据积压。直接查看选项的同步在该选项与仿真调试器结合使用时也至关重要,因为它保证在调试器中指定的命令可以立即反映在 op_vuanim 显示的动画流中。这种即时反馈源于这样一个事实:仿真被限制不得超前于仿真调试器命令循环或 op_vuanim 的动画流回放。

图 7:流路由选项:直接查看

流路由选项:直接查看

直接查看选项由仿真的 anim_view 首选项指定。如下所示将该布尔属性设置为 TRUE,会使仿真尝试与一个 op_vuanim 进程通信。可能需要以首选项赋值的形式提供额外信息来指定通信参数。

图 8:使用 anim_view 标志指定直接查看

% op_runsim -net_name angen -anim_view <...>

用作正在执行的仿真与 op_vuanim 进程之间通信信道的网络数据报协议是 UDP(User Datagram Protocol),它依赖工业标准 IP 网络协议的数据报投递服务(这两种协议都是 DoD 开发的 TCP/IP 协议套件的一部分)。每个动画请求都被封装在一个 UDP 包中,并转发给 op_vuanim 进程。对于每个请求,op_vuanim 进程向其关联的仿真返回两种确认包:一个确认请求已收到,一个确认请求已显示。仿真内核内置了超时机制,会在足够的时间间隔内未获确认时重传动画请求。

图 9:通过 UDP/IP 的动画流通信

通过 UDP/IP 的动画流通信

为了让 UDP 数据报在仿真和 op_vuanim 进程之间传输,这些进程必须知道彼此的 IP 网络地址和 UDP 端口号。由于进程间通信仍然基于 UDP/IP,即使仿真和 op_vuanim 进程在同一主机计算机上执行,也需要这些数据项。端口号标识进程为使用 IP 投递服务的协议打开的端口,并将该进程区分为 IP 包内容的唯一目的地。地址和端口号数据使用典型的 IP 服务的客户机/服务器策略获得。

op_vuanim 进程被视为服务器进程:它在网络上向客户机仿真提供动画查看服务。要使这一策略生效,op_vuanim 进程必须在仿真尝试连接之前开始执行。在初始化期间,op_vuanim 在其主机计算机上建立一个 UDP 端口。默认端口号是一个固定值,也是客户机仿真的默认预期值。

客户机仿真从 anim_host 首选项导出 op_vuanim 主机计算机的 IP 地址。该属性为仿真提供 op_vuanim 主机计算机的网络名称;主机的名称通过网络上的名称服务器或仿真主机计算机的 /etc/hosts 文件转换为主机的 IP 地址。anim_host 首选项的默认值是 “localhost”,它通常转换为仿真主机计算机的环回地址。因此在本地查看场景中通常不需要指定 anim_host 首选项。

图 10:使用 anim_host 标志指定 op_vuanim 主机

% op_runsim -net_name angen -anim_view -anim_host guardian

一旦 op_vuanim 进程收到来自仿真的初始通信建立包,它就可以从包中提取仿真主机计算机的 IP 地址,用于后续的确认包。因此 op_vuanim 程序不需要用户指定仿真主机计算机的 IP 地址。

如前所述,op_vuanim 的默认 UDP 端口号对仿真来说是已知的。该端口号固定为 3211,不应干扰任何广泛使用的 IP 服务。但是,某些安装可能需要将该端口号保留给内部开发或商业软件系统。在这种情况下,可以同时告知 op_vuanim 和仿真必须使用另一个 UDP 端口号。替代端口号不是直接指定的,而是作为相对于默认端口号 3211 的偏移量指定的。这个相对端口偏移量称为动画端口(animation port),通过 anim_port 首选项同时指定给 op_vuanim 和仿真。anim_port 的默认值是 0,因此默认 UDP 端口号是 3211 + 0 = 3211;将 anim_port 设置为 5 将得到 UDP 端口号 3211 + 5 = 3216。只要 op_vuanim 进程和仿真进程对 anim_port 的值达成一致,它们就可以建立通信。

当仿真打开一个与 op_vuanim 通信的端口时,操作系统会为其分配一个空闲的 UDP 端口号。仿真的端口号每次执行都不同,用户无需关心,因为它在通信建立包中直接传送给 op_vuanim。

图 11:匹配仿真与 op_vuanim 的动画端口

匹配仿真与 op_vuanim 的动画端口

当多个 op_vuanim 进程在同一主机计算机上执行时,会出现另一个与动画端口相关的问题。同一主机上的两个端口不可能共享一个端口号,因此多个 op_vuanim 进程必须有不同的动画端口值。op_vuanim 尝试基于指定的动画端口打开一个 UDP 端口,但如果它检测到请求的端口号已被另一个进程使用,就会将动画端口加一并尝试基于新值打开 UDP 端口。这种“递增”过程会无限继续,直到找到空闲端口。因此可以在同一主机计算机上生成多个 op_vuanim 进程而不指定不同的动画端口值,因为每个进程都会找到一个可用端口。

为了让仿真与同一主机上多个 op_vuanim 进程中的某一个通信,应当通过读取目标 op_vuanim 实例环境中右侧中部的状态条来确定动画端口号。确定之后,就可以通过执行一个将相同值赋给 anim_port 首选项的仿真来针对该特定动画端口。

UDP 和 IP 协议不保证数据报的投递,也不提供因 LAN 冲突、路由问题或其他网络故障而在传输中丢失的数据报的重传。因此通信的仿真和 op_vuanim 进程必须自行检测丢包并执行重传。op_vuanim 和仿真内核中的动画通信逻辑确实提供了健壮的重传服务,可以参数化以适应不同安装所经历的网络延迟条件。两个重传参数影响:(a) 仿真在重传之前等待来自 op_vuanim 进程的请求接收确认的时间长度;(b) 仿真在放弃之前重传一个请求的次数。这些参数分别由 anim_timeout 和 anim_attempts 首选项设置。anim_timeout 属性接受以秒为单位的浮点值;其默认值为 3.0 秒。anim_attempts 首选项接受整数值;其默认值为 5 次重试。这些属性的默认值已被确定为在负载相当重的 LAN 环境中提供可行的连接。

图 12:使用 anim_timeout 和 anim_attempts 标志指定重传参数

% op_runsim -net_name angen -anim_view -anim_host guardian \
	-anim_timeout 2.5 -anim_attempts 8

在许多用户安装中,影响动画流直接查看的参数在相对较长的时间内保持不变。因此可以在首选项文件中为相应首选项赋予稳定值。注意,anim_view 首选项通常不在首选项文件中赋值,因为是否选择直接查看选项最好留到执行仿真时再决定。

图 13:在首选项文件中设置动画通信参数

<...>

# animation communication parameters
anim_host:      guardian
anim_port:      6
anim_attempts:  8
anim_timeout:   2.5
<...>

op_vuanim 从仿真收到的第一个包表明随后将有一个动画流。因此 op_vuanim 进入动画流回放的激活模式。动画流的初始模式是暂停;除非从 op_vuanim 的按钮面板激活一个回放操作,否则流不会开始回放。与控制回放相关的操作所对应的按钮显示在图 14中;关于这些操作的更多信息见本章后文。

图 14:op_vuanim 动画回放操作按钮

op_vuanim 动画回放操作按钮

在已接受的动画流被仿真或 op_vuanim 用户操作终止之前,op_vuanim 不会接受来自另一个仿真的动画流。如果另一个仿真尝试建立通信,op_vuanim 会发出错误消息,被拒绝的仿真也会发出错误消息,同时继续执行但不再向 op_vuanim 发送动画包。同样,在回放动画历史文件时,op_vuanim 会拒绝传入的动画流。

图 15:op_vuanim 状态栏中的动画消息:示例

op_vuanim 状态栏中的动画消息:示例

大多数动画流不是自包含的;也就是说,它们依赖于其他被引用资源的存在才能无错误地正确显示。其他被引用资源的例子包括:用作动画图形上下文的模型、用作模型背景的地图、用作移动路径的轨迹或轨道文件,以及用户定义的图标。这些资源在动画流数据中是被引用的,而不是被完全集成的,以避免资源的冗余存储及任何相关的版本一致性问题。然而,引用资源带来了访问这些资源的问题。只要 op_vuanim 在包含所需资源的用户上下文(由首选项文件及其中引用的模型目录定义)中执行,带有资源引用的动画流就可以由 op_vuanim 正确回放。在动画流由处于与源仿真不同的用户上下文或主机计算机上的 op_vuanim 进程显示的情况下,必须把被引用的资源文件复制到 op_vuanim 进程的环境中,使其能够在动画回放中正确访问和利用它们。

历史文件

在动画历史文件选项中,动画流数据从正在执行的仿真路由到一个随仿真推进而不断增大的二进制数据文件。当产生动画历史文件的仿真完成后,该历史文件可以加载到 op_vuanim 中查看。历史文件提供以下好处:

  • 以无需任何额外准备即可直接查看的格式长期存储动画
  • 消除由仿真计算以及进程间通信与同步造成的动画延迟
  • 无需重新计算即可重复查看动画
  • 便于向同事传输动画的格式

动画历史文件是动画路由的首选选项,因为它节省了时间。在大多数情况下,直接查看替代方案主要与仿真调试器一起使用,因为动画历史文件不能在仿真运行期间查看,因此不能作为调试会话的反馈机制。

图 16:流路由选项:历史文件

流路由选项:历史文件

历史文件选项由仿真的 anim_hist 首选项指定。该字符串属性接受动画历史文件的基本名称,不包含文件的路径或类型后缀。文件类型后缀 .ah(“animation history”的缩写)会被追加到基本名称之后。注意,新的动画历史文件存储在主要模型目录(primary model directory)中,与生成它们的仿真的位置无关。

图 17:通过 anim_hist 标志指定历史文件

% op_runsim -net_name angen -anim_hist ang2

在动画历史文件创建完成、且生成它的仿真执行结束后,可以通过 Read Animation History 操作将历史文件读入 op_vuanim。

从菜单中做出选择后,头部状态条文本会指示已加载的历史文件的名称。与处理模型的典型读取操作不同,Read Animation History 操作不会在显示之前把动画历史文件的全部内容传送到虚拟内存。相反,动画历史文件的一部分被读入一个虚拟内存缓冲区,该缓冲区存储请求直到动画回放需要时使用。当缓冲区中的请求被回放过程耗尽后,它会再次从历史文件中填充,直到整个历史文件都通过缓冲区处理完毕。历史缓冲区的大小固定为 8 KB,不能修改。

动画历史文件的初始缓冲区由 Read Animation History 操作加载后,动画流处于激活但暂停的状态。除非从 op_vuanim 的按钮面板激活一个回放操作,否则流不会开始回放。用于激活回放、暂停、回到起点等操作显示在下一页。注意,这些操作与可以启动直接查看动画回放的操作相同,只是多了一个 Restart Animation Flow 操作,它从开头重新启动当前加载的动画。

图 18:op_vuanim 动画回放操作按钮

op_vuanim 动画回放操作按钮

上一节中关于被引用资源的注意事项同样适用于源自历史文件的动画流。由于动画历史文件可能包含对模型、地图、轨迹或轨道文件、图标等支持文件的引用,被引用的资源必须对 op_vuanim 可访问,才能保证无错误的动画回放。

双路由

动画的直接查看和历史文件路由选项可以在单个仿真中组合使用,使仿真的动画在仿真执行期间可查看,同时也可供以后重复查看。通过同时指定 anim_view 和 anim_hist 首选项来选择仿真动画流的双路由(dual routing),如图 19所示。在双路由下,直接查看选项仍然独立于历史文件选项,因此如果用户退出 op_vuanim 从而关闭了动画流直接查看,仿真将继续产生动画历史文件。

图 19:指定动画流的双路由

% op_runsim -net_name angen -anim_view -anim_host guardian -anim_hist ang2

脚本文件

虽然仿真生成的动画流只有两个直接路由选项(在 op_vuanim 中直接查看,或写入历史文件),但可以在动画历史文件路由选项中插入一个迂回环节,用于编辑或增强动画流。动画历史文件包含以专有格式编码的二进制数据,因此用户不能直接操纵。但是,动画历史文件可以转换为动画脚本文件(animation script file),它们是对所捕获动画流的等价描述,使用可在标准文本编辑器中查看和修改的 ASCII 脚本语言编码。脚本文件也可以转换回历史文件,从而提供了通过脚本形式间接编辑或添加动画历史文件的能力。

动画流在历史文件与脚本文件形式之间的转换由 op_cvanim 实用程序完成。op_cvanim 根据首选项 “reverse” 的布尔值确定转换方向:正向转换(forward conversion,“reverse” 设为 FALSE)从脚本文件产生历史文件,反向转换(reverse conversion,“reverse” 设为 TRUE)从历史文件产生脚本文件,如下图所示。

图 20:动画历史/脚本转换

动画历史/脚本转换

下面的图把转换循环放入动画历史路由的更大上下文中。

图 21:动画历史编辑数据流图

动画历史编辑数据流图

op_cvanim 从字符串首选项 “m” 获得动画的基本名称(动画基本名称不应包含文件路径或文件类型后缀)。文件类型后缀 .as 被追加到基本名称之后形成动画脚本文件名,后缀 .ah 则用于动画历史文件名。op_cvanim 创建的动画历史文件或脚本文件存储在工作模型目录(working model directory)中,与它们所转换自的文件无关。

一旦处于脚本形式,动画流就可以进行符号化的查看和编辑。动画流的每个请求由脚本中的一条语句描述(脚本语言在本章后面的小节中介绍)。脚本编辑可以包括添加新请求、删除不需要的请求,或修改请求的参数。动画脚本也可以完全手工输入,用于原型化一个动画概念。如果动画脚本中的语句存在语法错误,op_cvanim 会在把脚本文件转换为历史文件的过程中检测到这些错误,并发出错误、取消转换。

动画探针

可以通过仿真首选项 anim_view 或 anim_hist 选择动画路由选项,使仿真激活一个动画流。在直接查看选项中,被激活的动画流将与指定的 op_vuanim 进程建立通信;在动画历史选项中,将创建一个文件。但是,如果没有通过 probe 首选项将动画探针应用于仿真,被激活的动画流将不包含任何动画请求。动画探针是必需的,用于标识被启用生成动画请求的对象。如果探针列表中没有指定探针,或者 probe 首选项没有赋值,则没有任何对象被启用生成动画请求。

动画探针有三种类型。

  • 自动动画探针启用一个内置于仿真内核的动画算法,称为表示法(representation);该算法在单个查看器中生成仿真模型的完整动画描绘,包括模型图形以及在图形中移动或变化的动态元素。
  • 自定义动画探针启用一个仿真对象及其所有子对象发出自定义动画请求。自定义动画请求(custom animation request)由仿真内用户定义的进程或过程调用的 Anim 包 KP 指定,但除非包含进行 Anim 调用的进程或过程的对象被自定义动画探针启用,否则请求不会被发出到仿真的动画流中。
  • 统计动画探针对由相应统计探针生成的输出向量结果进行动画化。

探针列表可以包含任意数量的自动和自定义动画探针,此外还有非动画探针。动画探针启用的动画请求被组合进单一的仿真动画流中,按生成的顺序交错排列。动画探针通常彼此独立、互不影响;唯一的例外发生在一个自定义动画探针引用的对象与另一个自定义动画探针相同,或者是被另一个自定义动画探针层级影响的对象时。关于这种交互的描述,见自定义探针。

自动、自定义和统计动画探针共享大量通用属性,这些属性指定所有探针所需的数据,以及描述探针时间范围和查看器选项所需的数据。通用探针属性包括标识探针列表内探针对象的 name 属性,以及用于层级标识探针所针对对象的若干属性。这些属性不在本章中详细描述,但下面的图说明了动画探针对仿真对象的定位(注意,对象是以抽象意义描述的)。

图 22:动画探针对仿真对象的定位

动画探针对仿真对象的定位

两个探针属性定义动画探针从其目标对象发出的动画请求启用动画的时间范围。这些属性在下表中描述。默认情况下,anim start 属性的值为 0,anim stop 的值为无穷大;除非显式为这些属性赋予不同的值,动画探针将在仿真的整个持续时间内生效。将 anim start 属性设置为正的非零值,或将 anim stop 属性设置为小于关联仿真持续时间的值,都会使探针的时间范围缩小。受限的探针时间范围对于把动画限制在特定时间段内有趣的事件很有用。由于每个动画探针都有自己的时间范围属性,动画流的总体时间范围实际上跨越最早的探针开始时间和最晚的探针停止时间。

表 14:动画探针的时间范围属性

名称 类型 单位 说明
anim start double seconds 指定探针效果的开始时间
anim stop double seconds 指定探针效果的停止时间

图 23:动画探针时间范围的并集

动画探针时间范围的并集

动画探针的时间范围并非完全严格;少数几种动画请求可以“穿透”时间范围的限制,即使请求时间落在关联动画探针的名义时间范围之外,也会把自己添加到仿真的动画流中。能穿透探针时间范围的请求类型具有以下共同属性:(a) 它们不直接在查看器中执行图形操作;(b) 它们创建后续动画请求所需的动画资源。如果这些类型的请求在其关联时间范围之外发出时被阻止,关联资源将不存在,后续动画请求在引用缺失资源时会导致错误。可以穿透时间范围的活动包括查看器的创建,以及宏(macro,本章后面介绍)的创建和定义。

查看器是动画回放环境的重要组成部分。查看器为一系列相关的动画请求定义显示区域。所有动画探针都使用一组五个属性指定关联查看器的参数,这些属性列于表 15;但是,自动和自定义动画探针在不同条件下创建查看器。每个自动动画探针都创建一个具有指定名称和初始大小的查看器,并把它所启用的所有动画请求指向该查看器。自定义动画探针只有在它所启用的对象发出引用该探针查看器的动画请求时,才会基于探针指定的参数创建查看器;通过自定义动画探针启用的其他动画请求可以按照自定义动画的设计创建自己的查看器。因此,自定义动画探针指定的查看器可能被它所启用的部分或全部自定义动画请求忽略。

五个动画探针查看器属性中有四个以工作区坐标指定查看器可见区域的初始大小和位置。这些值都可以在 op_vuanim 内的动画回放期间通过用户操作改变。探针查看器的初始滚动位置不能在探针对象中指定;它固定在查看器坐标系的原点。查看器的滚动坐标可以通过 Anim Kernel Procedure 或 op_vuanim 中的用户操作改变。

表 15:动画探针的查看器属性

名称 类型 单位 说明
window name string N/A 指定查看器的名称,即显示在查看器底部横幅中的字符串
window x integer pixels 以工作区坐标系为背景,指定查看器左上角的初始 X 坐标
window y integer pixels 以工作区坐标系为背景,指定查看器左上角的初始 Y 坐标
window width integer pixels 指定查看器可见区域的初始宽度
window height integer pixels 指定查看器可见区域的初始高度

图 24:动画探针查看器名称配置

动画探针查看器名称配置

图 25:动画探针查看器大小与位置配置

动画探针查看器大小与位置配置

自动探针

自动动画探针针对单个仿真对象设置,并启用创建单个动画查看器及在其中执行图形操作的请求。为了“动画化”被探测的对象,仿真内核生成动画请求,显示定义该对象内部结构的模型图形,并叠加动态元素。对于给定的模型类型,仿真内核可能支持几种不同的动画算法,称为表示法。一个动画流可以包含多个自动动画表示法,但每个都必须由自己的自动动画探针分别启用。单个对象甚至可以针对不同的同时表示法分别设置探针。

除通用动画探针属性外,自动动画探针还必须指定它们各自生成的表示法。自动动画探针启用的表示法由 representation 属性指定,显示在下表中。该属性的可能值取决于被探测对象的类型。

表 16:自动动画探针的特殊属性

名称 类型 说明
representation string 指定该探针启用的自动动画表示法的名称

自定义探针

自定义动画探针针对单个仿真对象设置,但它影响直接探测对象内包含的所有对象。自定义动画探针使被探测对象集合能够发出自定义动画请求。自定义动画请求的直接来源是与仿真对象关联的进程或过程对 Anim 包 KP 的调用。如果一个对象包含产生动画请求的进程,那么只有当自定义动画探针启用来自该对象的请求时,这些请求才会被添加到仿真的动画流中。

探针列表中可以定义多个自定义动画探针,也可以把它们与自动动画探针一起定义在混合探针列表中。如果一个自定义动画探针引用的对象与任何其他被探测对象没有层级关系,则它独立于所有其他自定义动画探针。另一方面,一个自定义动画探针可以通过探测与另一个探针的对象存在层级关系的对象,与另一个自定义动画探针重叠。影响区域(region of influence)重叠的自定义动画探针产生以下效果:(a) 自定义动画探针的一般请求启用效果简单地应用于由各探针独立影响区域并集构成的影响区域;(b) 如果与探针影响区域交集内某个对象关联的进程或过程发出一个 viewer ID 参数设置为符号常量 OPC_ANIM_ANVID_PBSPEC 的 Anim 包 KP,那么只有探针指定的查看器之一会显示该 KP 的结果(受影响的查看器取决于探针在探针列表中的顺序)。

除通用动画探针属性外,自定义动画探针还包含一个可选的探针属性(label),可用于把探针的影响限制为依赖特定探针标签存在的 Anim 包 KP 调用。如果为 “label” 属性赋值,该自定义动画探针被视为带标签探针(labeled probe)(没有为 “label” 赋值的自定义动画探针被视为无标签探针,unlabeled probe)。带标签探针放弃了无标签探针在其影响区域内普遍启用动画请求的能力。取而代之,带标签探针只启用引用该探针关联查看器 ID 的 Anim 包 KP 调用的请求。带标签探针的查看器 ID 可以通过调用 KP op_anim_lprobe_anvid() 并传入探针的标签来获得。带标签探针提供了一种有用的机制,用于在仿真中定义可以独立启用或禁用的自定义动画功能。

表 17:自定义动画探针的特殊属性

名称 类型 说明
label string 指定该探针带标签,并提供标签文本

统计探针

统计动画探针产生仿真结果的动态图形。要得到这个结果,你需要:

  • 定义一个节点或链路统计探针,使该统计量的数据被收集
  • 定义一个统计动画探针,显示收集到的数据

统计动画探针的输出在编辑器窗口中显示。详见第 1 章 “User Interface”第 1 页。

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