TransModeler API介绍(新)【DOC精选】.docVIP

TranModeler帮助手册 TranModeler帮助手册 1 1. TranModeler帮助手册 3 1.1. TransModeler API介绍 3 1.2. 网络接口 5 1.2.1. 常量（NI） 5 1.2.2. 数据类型 7 1.2.3. 网络结构 9 1.2.4. ITsmNetwork 11 1.2.5. 网络对象 20 1.2.6. 车辆 52 1.3. 交通管理接口 62 1.3.1. 常量（TMI） 62 1.3.2. ITsmTrafficManager 66 1.3.3. 信号计时（Signal Timing） 70 1.3.4. 控制器 75 1.3.5. HOT车道和动态计价 84 1.4. 车辆路径接口 90 1.4.1. 数据结构 90 1.4.2. ITsmRouter 90 1.4.3. ITsmPath 104 1.5. 主要应用接口 105 1.5.1. 创建一个ITsmApplication对象 106 1.5.2. 常量（MAI） 108 1.5.3. ITsmApplication 109 1.5.4. 关于ITsmAttributes 119 1.5.5. 在你的应用里关于内存管理的注意（Notes about Memory Management in Your Application） 121 1.6. 事件和回调 122 1.6.1. 连接点 123 1.6.2. 车辆监视器（Vehicle Monitor） 146 1.6.3. 入口/出口点和插件使用期限（Entry/Exit Points and Lifespan of Plugin） 149 1.7. 参数编辑和解析 156 1.7.1. 为什么使用参数编辑器和解析器 157 1.7.2. 参数编辑器 157 1.7.3. 参数解析器 178 1.8. API测试器 188 1.9. 附录（API） 188 1.9.1. 在C++程序中使用API 189 1.9.2. 在VB程序中使用API 195 1.9.3. 在C#程序中使用API 197 1.9.4. 在编译器里运行你的程序 199  TranModeler帮助手册 TransModeler API介绍 这篇文档介绍了用于编写TransModeler应用的数据类型和接口（application programming interface ，API）。该API允许开发外部应用，或者插件，即利用Transmodeler接口模拟交通控制操作或提供实现其他不属于TransMosdeler程序部分的功能。 该API被设计用于支持多种现代编程语言，包括C/C++，VB以及在.NET里支持的C#。该API提供了一套对象模型的容器（COM）的基类接口。这些接口使用面向对象的方法和层次结构来表示的数据模型，可用于建成TransModeler插件。该API通过一个TSMAPI.DLL的动态链接库来实现，这个动态链接库包含了一些以TsmApplication作为根对象的接口。（为简单起见，我们将省略这篇文档中的接口名称中的Tsm前缀。） 应用（Application）：Transmodeler模拟的根（或者说顶层）接口。它包含了其他的仿真对象并提供了获取项目设定和仿真状态的方法。此应用对象管理外部插件连接和负责执行应用，如打开或者关闭一个仿真项目，一次仿真的开头和结束，或者仿真模型中传感器的激活或停用。 网络（Network）：一个网络对象和服务方法的集合，包含结点（nodes），链接（link），车道（lanes），传感器（sensors），信号（signals），车辆（vehicles），或者其他； 交通管理器（Traffic Manager）：一个交通管理函数的集合，包含“设定”以及“获取”交通控制器，相位（phases），阶期（stages）及内部阶期的信号状态及参数的函数；以及 路由（Router）：一个获取和更新机动车路径和行动时间的函数的集合。 为方便.NET应用里面使用，TsmApi.dll封装在一个兼容TSM.DLL的.NET中。例如，你可以创建一个叫做RunSimulation的类用于浏览一个仿真项目并立即开始一次Transmodeler仿真： imports Tsm Public Class RunSimulation Sub New() Dim sim As New TsmApplication If sim.Open() Then sim.Start() End If sim = Nothing End Sub End Class