1 Bentley 平台介绍
图 1 Bentley 平台介绍
Bentley 软件大致可分为四大平台,分别为用于设计的 Microstation 平台,用于协同的 ProjectWise 平台,用于对资产进行全生命周期管理的 AssetWise 平台和数据互联互通的
数字孪生平台 iTwin。
1.1 MicroStation
MicroStation,即 Bentley 的基础图形平台软件。它基于三维设计,支持实体建模、 B 样条曲面建模和网格建模三大三维图形内核,可兼容其他各种图形平台导入的数据格式。 同时, MicroStation 还是一个囊括二维绘图、三维建模、图形渲染,动画制作的全方位多 功能图形平台。基于强大的 MicroStation 平台,根据各个专业的不同需求, Bentley 开发 出面向不同专业的 Open 系列设计软件, 生成模型可利用 Bentley 开发的计算软件进行结
果分析。
1.2 ProjectWise
为满足企业跨时间,跨空间协作的需求, ProjectWise 平台提供了一个集成的协同环
境,可以精确有效地管理各个专业的文件内容, 并通过良好的安全访问机制,供项目各个
参与方在一个统一的平台上协同工作。
1.3 AssetWise
AssetWise 平台主要用于对资产在全生命周期中的管理,它是一系列软件的统称, 其中 核心软件叫做 eB。eB 软件提供有从项目前期的合同管理到设计阶段的管理到项目移交、
运营直至某个管件的作废的 “全生命周期”管理过程。
1.4 iTwin
在整个建设周期中, 传统迭代过程中获得到的信息被不断积累——抛弃,而在数据孪 生中,数据被不断的被积累、迭代、优化,周而复始,从而提升整个流程的决策,降低风
险,提高生产力和应变能力。 iTwin 平台可兼容各种类型的数据格式,并保证信息无损,
通过信息整合统筹管理,优化物理资产。
2 Bentley 平台插件开发介绍
2.1 Bentley 产品 SDK 间关系介绍
图 2 Bentley 产品 SDK 关系
虽然 Bentley 拥有几乎涵盖了各个专业的设计软件,但在实际应用中, 可能会出现
在特定场景下无法适配的情况,此时就需要通过二次开发的方式实现既定的功能需
求,这也就是 Bentley 软件提供软件开发包的初衷与意义。您可以通过使用软件开发 包开发出符合您自身业务需求的工具甚至软件, 借此提高生产力。我们可以看到上图 列有 MicroStation SDK 和 ORD SDK ,ORD(OpenRoadsDesigner)是 Bentley 公司
面向道路专业设计的一款专业软件 ,它们是两个独立的软件安装包。如果您只基于
MicroStation 中的对象进行开发, 在安装 MicroStation 的基础上安装 MicroStation
SDK 即可。若要基于 ORD 做开发,则需安装 ORD SDK。在 ORD 二次开发程序中您 既可以通过 ORD SDK 去访问 DGN 文件中的 ORD 专用对象(比如边坡,廊道等) ,
还可以通过 MicroStation SDK 去访问 DGN 文件中的通用对象(比如文字、标注、普
通的几何体等) 。若您对特定专业的二次开发感兴趣也欢迎您登陆中国优先社区或
Bentley-learn 网站了解更多信息。
2.2 Bentley 软件开发语言介绍
图 3 Bentley 软件支持的开发语言表
Bentley 设计软件支持三种开发语言: VBA、C#和 C++。VBA 语言仅需安装
MicroStation,简单易学,但存在 API 接口不全, 在开发大型程序时较为困难; C#语言需
安装 MicroStation 与 VisualStudio,相对于 C++来说,上手难度较低, 可使用
Winform ,WPF 定制界面灵活性较大,可以满足开发大型程序的需要。 C++语言需安装 MicroStation ,VisualStudio 与对应的 SDK,具有功能最全,性能最佳的优势,但也存在
学习成本较大, 界面不易制作的问题。
目前关于 C#语言的 SDK 封装已经日趋完整, 因为其语言自身无需关心内存的开辟与回 收的特点,可以让您更加专注于业务功能的实现,因此若您的编程技术较弱,或需要快速
编写业务功能, 推荐您使用 C#语言进行 Bentley 软件的二次开发。
2.3 MicroStation 托管应用开发架构
图 4 Bentley 软件开发架构
MicroStation 托管应用开发架构 (即使用 C#语言对 Bentley 基础平台进行二次开发)
主要分为以下六大块:
几何库:主要负责几何层面的变换与修改;
属性表达库:主要负责工程属性的添加与修改;
DGN 平台库:主要负责读写 dgn 文件的操作;
DGN 文件显示库:主要负责 dgn 文件的内容显示或交互式工具;
MicroStation 应用库:主要对管理器,会话等应用继续管理;
Addins 工具:可调用上述所有库。
在开发过程中,主要调用的 API 主要有:
几何 API
图 5 常用几何 API
主要面向应用程序提供几何运算方面的支持, 他提供了通用的几何图元,包含几何对象
的创建, 编辑, 定位等操作。
元素 API
图 6 常用元素 API
主要用于对元素的控制。元素为 MicroStation 中构件的基本单位, MicroStation 有很多
种类型的元素, 我们可以将其分成图形元素和控制元素。
模型 API
图 7 常用模型 API
主要用于对数据,例如存储构件的容器及模型层面的环境配置等进行操作,或对于视
图,比如说对元素显示,视图布局等进行控制。
文件 API
图 8 常用文件 API
主要用于修改模型的容器及环境配置, 比如说图层,样式,字体, EC 属性等。
事件 API
图 9 因指定事件出现触发 API
图 10 常用事件 API 表
主要用于监控用户特定操作事件,在用户做出指定操作后触发。
管理器 API
图 11 常用管理器 API
通过这些接口我们可以直接调用到 MicroStation 中的一些功能。例如通过
ACSManager 我们可以对坐标系进行变换,通过 SelectionSetManager 这个类完成对选择
集的操作。
约束及参数化 API
图 12 约束及参数化 API
在创建参数化模型时, 通常需要先规划一下参数化模型需要哪些参数去控制。若前期规
划得当, 后期可以省去很多修改模型带来的麻烦。SDK 中提供了参数化建模的编程接口。
DgnTool 命令工作集
图 13 人机交互界面
图 14 常用事件虚函数功能对照表
MicroStation 中超过一半的功能都是以交互式工具的形式而存在的,我们可以通过重写
该工具集中的虚函数来实现所需功能。通过上述 API 协调配合, 实现既定的功能。
3 开发环境搭建
3.1 MicroStation 安装流程介绍
图 15 双击运行安装包
图 16 勾选“我接受最终用户许可协议”
图 17 若需修改安装路径则点击该项
图 18 等待程序自动下载安装即可
图 19 程序安装完成
3.2 MicroStation SDK 安装流程介绍
图 20 双击运行安装包
图 21 勾选“我接受最终用户许可协议”
图 22 若需修改安装路径则点击该项
图 23 程序安装完成
3.3 Visual Studio 安装流程介绍
图 24 双击运行安装包
对于 Bentley 平台的开发来说, 若使用 C#语言进行开发,需勾选.NET 桌面开发,若使
用 C++语言进行开发,则需勾选使用 C++的桌面开发。您可根据您的实际情况按需安
装,同时后续也可在 Visual Studio 中继续添加模块。
图 25 Visual Studio 模块安装界面
因为 Bentley 二次开发基于.NET Framework4.6.2,因此, 若您安装的 Visual Studio 版
本为 2017,请注意勾选.NET Framework 4.6.2 开发工具。
图 26 模块安装界面
图 27 若需修改安装路径则点击该项
图 28 等待程序自动下载安装即可