Ovis 映射库
Riverbed 分析软件不为场景中的网络拓扑与 3D Network Visualizer 中显示的 3D 实体和装饰之间提供任何硬编码的转换。相反,这一转换交由 Ovis 映射库完成。Riverbed 提供了一个标准映射库,但 Modeler 和 OPNET Development Kit 用户可以开发自己的自定义库。
基础设施
映射库由一组在可视化过程中由 3D Network Visualizer 调用的回调组成。你可以开发自己的自定义代码,控制如何创建、更新和销毁 Ovis 实体或相关装饰。
图 4 展示了这些回调及其发生顺序。每个回调的描述见回调定义。
图 4:Ovis 回调

映射库包含两个部分:
- 由 Ovis 包直接使用的网络级部分
- 与节点模型关联、并由网络级部分选择性使用的节点级部分
这两部分不必属于同一个库。但你可以让某些节点模型和网络模型共用同一个库。这使得模型设计者可以为节点模型提供合适的 3D 映射,之后由可能出自他人之手的网络级映射库使用。Riverbed 分析软件不支持在 GUI 中发现 RTI 对象。
DES 与 GUI 库
DES 和 GUI 拥有不同的运行时库集合,尤其是仿真内核和 ETS 库。为了简化映射库的链接与加载,Riverbed 生成用于 DES 的不同版本(库名带有相应的 dev32、opt32 等内核类型后缀,链接到对应的仿真内核库)和用于 GUI 的版本(带有“gui32”后缀,链接到 ETS 库)。
映射库最可能需要的信息是网络拓扑、站点属性,以及可能与 GUI 中站点关联的“P-state”数据。DES 和 GUI 拥有不同但相关的 API 来访问其中部分信息:DES 使用 op_topo 和 op_ima,GUI 使用 Ets_Topo、Ets_Obj 和 Ets_Client_State/Ets_State。
注意: Riverbed 分析软件在 DES 中不支持“P-state”信息。为了使用户能够为 DES 和 GUI 用途编译同一份映射代码,Riverbed 为 DES 编译提供了一些 Ets_Topo 和 Ets_Obj 函数名。这些函数映射到相应的 DES 内部 API,或者通过 #define 直接映射,或者通过合适的薄层间接映射。
编译目标文件时会包含 OPD_DES 或 OPD_GUI 符号,使用户代码可以使用 #if define 块,确保只编译相应库的某些部分。这使得更高级的映射库可以充分利用内核过程或 ETS API。
下文描述的某些回调只适用于某一个库,此时代码会自动包裹在 #if defined (OPD_DES) 或 (OPD_GUI) 中。
某些 ETS 类型(EtsT_Obj_Handle、EtsT_Network_Handle 等)在 DES 上下文中定义。其实际表示可能与 GUI 中使用的不同,但这避免了为 DES 和 GUI 用途重复定义回调。DES 环境将提供把这些 ETS 类型转换为相应 DES 类型的 API。
以下 API 在 Project Editor (GUI) 和 DES 的传统上下文中均可使用。如果你编写的代码需要简单地在两种环境中都能工作,可以使用这些 API:
- Ets_Api_Init()
- Ets_Model_Current_Get()
- Ets_Obj_Attr_Exists()
- Ets_Obj_Attr_Get()
- Ets_Obj_Attr_Set()
- Ets_Obj_Equal()
- Ets_Obj_Invalid()
- Ets_Obj_Invalid_Get()
- Ets_Obj_Type_Get()
- Ets_Topo_Assoc_Count_Get()
- Ets_Topo_Assoc_Get()
- Ets_Topo_Child_Count_Get()
- Ets_Topo_Child_Get()
- Ets_Topo_Connect_Count_Get()
- Ets_Topo_Connect_Get()
- Ets_Topo_Object_Count_Get()
- Ets_Topo_Object_Get()
- Ets_Topo_Parent_Get()
- Ets_Topo_Top_Get()
有关 ETS/DES 对应关系的完整列表,参见文件 <reldir>\sys\include\p_ets.h。
3D Network Visualizer 映射库状态
启用 3D Network Visualizer 时,GUI 或仿真内核会加载由首选项 3dnv.mapping_library 指定的映射库。首先调用映射库的“init”回调;然后调用“load”回调,为特定网络模型的可视化准备映射库的内部状态。“load”回调接受任意字符串作为参数,可用于向映射库传递所请求的可视化选项或有关网络的某些辅助信息。
相应的“unload”回调会在网络模型被卸载(GUI)或仿真终止(DES)时被调用以释放状态信息;如果映射库首选项被修改,也会调用“unload”,此时新库的“load”回调会被调用。