《ev-globe 5.0 开发教程 _初级篇》由会员分享，可在线阅读，更多相关《ev-globe 5.0 开发教程 _初级篇（57页珍藏版）》请在金锄头文库上搜索。
1、 EV-Globe SDK 开发教程开发教程 （初级篇） 北京国遥新天地信息技术有限公司 中国北京 EV-Globe 5.0 SDK 开发入门教程 1 目录目录 目录 . 1 前 言 . 2 1.1 入门教程能帮助您学会什么？ 2 1.2 适用对象 2 1.3 涉及的控件 3 1.4 使用数据 3 2. Qt4 C+ 开发入门 4 2.1 第一步：创建一个新工程 4 2.2 第二步：使用工作空间控件配置工程 5 2.3 第三步：通过控件快速搭建地图 8 2.4 第四步：地图浏览功能 9 2.5 第五步：地图到属性查询 11 2.6 第六步：属性到地图查询 14 2.7 第七步：通过控件快速搭建
2、场景 18 2.8 第八步：场景浏览功能 20 2.9 第九步：场景到属性查询 20 2.10 第十步：属性到场景查询 22 2.11 第十一步：鹰眼控件的浏览 . 26 3. Visual C# .NET 开发入门 28 3.1 第一步：创建一个新工程 28 3.2 第二步：加入 EV-Globe 5.0 控件 . 30 3.3 第三步：使用工作空间控件配置工程 31 3.4 第四步：通过控件快速搭建地图 32 3.5 第五步：地图浏览功能 34 3.6 第六步：地图到属性查询 36 3.7 第七步：属性到地图的查询 38 3.8 第八步：通过控件快速搭建场景 42 3.9 第九步：场景浏览
3、功能 43 3.10 第十步：场景到属性查询 44 3.11 第十一步：属性到场景查询 46 3.12 第十二步：鹰眼控件的浏览 . 50 4. 如何随您的应用系统分发 EV-Globe 5.0 Runtime? . 52 5. 系统所依赖的库清单 53 EV-Globe 5.0 SDK 开发入门教程 2 前前 言言 1.1 入门教程能帮助入门教程能帮助您您学会什么？学会什么？ 本教程通过实现一个简单程序， 帮助您了解如何使用 EV-Globe SDK控件开发应用程序。 阅读完本教程，您应该能够回答如下问题： 1. 如何把EV-Globe SDK中的控件添加到工程中？ 2. 如何使用EVWor
4、kspace控件打开预先配置好的工作空间文件？ 3. 如何使用MapWidget控件显示一张地图？ 4. 如何实现基本的地图浏览功能，比如：放大、缩小、漫游等？ 5. 如何实现地图到属性的查询功能？ 6. 如何实现属性到地图的查询功能？ 7. 如何使用GlobeWidget控件显示三维地球？ 8. 如何实现基本的场景浏览功能，比如：放大、缩小、漫游等？ 9. 如何实现场景到属性的查询功能？ 10. 如何实现属性到场景的查询功能？ 11. 如何使用EagleEyeWidget控件关联一张地图,使该地图的局部显示范围在鹰眼图中绘 成矩形？ 同时，您还能理解： 1. 工作空间和数据源之间的关系。 2
5、. 数据源和数据集之间的关系。 3. 数据集和图层之间的关系。 1.2 适用对象适用对象 本文档介绍了如何使用EV-Globe SDK 结合Qt C+、Visual C# .NET 两种主流的语言简 单地实现 GIS 基本功能的开发，因此本书适合于具备上述任一种语言基础和初次接触 EV-Globe SDK进行开发的用户。 EV-Globe 5.0 SDK 开发入门教程 3 1.3 涉及涉及的的控件控件 控件名称 控件描述 EVWorkspace 工作空间控件 DatasourceWidget 数据源树控件 AtlasWidget 图层树控件 KmlWidget Kml 树控件 GlobeWid
6、get 场景控件 MapWidget 地图控件 LayoutWidget 布局控件 EagleEyeWidget 鹰眼控件 1.4 使用数据使用数据 本文档将会演示使用 MapWidget 控件打开地图或使用 GlobeWidget 控件打开场景，并 对其进行基本操作和属性之间的双向查询，所用的数据为：工作空间文件(samples.evproj), 其中包含地图及三维场景的配置信息；数据文件(samples.evd，taiwanModel.evd)，其中包含 了地图和场景所需要的演示数据。注意：工作空间文件和数据文件尽量保证相对位置不变， 否则可能出现场景或者地图不显示数据等问题。 如果用户新
7、建一个工程，需要使用自己的数据，那么上述的工作空间文件(.evproj)可以通 过使用 EV-Globe Desktop 5.0 进行配置，配置好地图或搭建好场景后，点击 EV-Globe Desktop 5.0 菜单中保存工作空间文件(或点击工具栏上保存按钮)，即可得到工作空间文件。 EV-Globe 5.0 SDK 开发入门教程 4 2. Qt4 C+ 开发入门开发入门 2.1 第一步：创建一个新工程第一步：创建一个新工程 前置条件：前置条件： 1. 需要安装 QT SDK 4.8.4 （包含 Qt Designer）版本。 2. 需要安装 Visual Studio 2010 C+。 3
8、. 需要安装 Qt Visual Studio Add-in（Visual Studio 2010 QT 插件） 。 4. 需要安装 EV-Globe runtime 5 Setup.exe 运行库 5. 需要安装 EV-Globe SDK 5 Setup.exe。 创建创建新新工程步骤：工程步骤： 1. 在本地磁盘下创建一个工作目录，如 C:MyProject。 2. 将“EV-Globe 5.0 SDK 的安装目录EV-Globe SDK5.0SamplesBindata”下的 “samples.evproj”和“samples.evd”文件拷贝到工作目录 C:MyProject 下。 3
9、. 启动 Visual Studio 2010。 4. 新建一个 Qt Application 工程，将其保存到工作目录“C:MyProject ”下，可命名 为： MyEVGlobe。默认创建的窗体可重新命名也可保持默认名称，在这里用 QT Designer 工具将窗体文件 myevglobe.ui 打开，将窗体的 WindowTitle 设为 “EV-Globe SDK 开发入门教程” 。 5. 创建工程后，需要对 MyEVGlobe 的工程属性进行修改，以便此工程能引用到 EV-Globe SDK 的头文件和开发库。具体设置如下： C/C+常规中的“附加包含目录” 添加 “EV-Glob
10、e 5.0 SDK 安装目录EV-Globe SDK5.0jniinclude” 链接器选项中的”附加包含目录”。 添加“EV-Globe 5.0 SDK 安装目录EV-Globe SDK5.0jnilib” 6. 当使用 SDK 中定义的类的静态成员(如:CVector3:ZERO),编译时提示未定义的静态 成员的链接错误时，需要在工程配置中定义宏”EV_DLL”。 7. Windows 下 SDK 产品包包括一套 Release 版本和一套 Debug 版本的 dll 和 lib 库。 基于运行效率的考虑，进行 C+应用程序开发时，二次开发人员一般需要选择 Release 版本进行开发。当
11、用户需要检测 C+代码的内存泄露时，可以使用 SDK 提 供的 C+ Debug 版本 dll，其他情况下都推荐使用 SDK 的 Release 版本 dll 进行开 发。 二次开发人员选择 Release 版本进行开发的时候，如果需要进行调试，需要修改 自己工程的 Release 的设置，按照以下步骤进行： 1 链接设置把调试信息打开。 EV-Globe 5.0 SDK 开发入门教程 5 2 调试信息格式改成用于“编辑并继续”的程序数据库 (/ZI)。 3 编译设置把 C+优化禁用。 2.2 第第二二步：步：使用工作空间控件配置工程使用工作空间控件配置工程 配置工程主要可以通过 EVWork
12、space 工作空间控件进行配置。 采用 EVWorkspace 工作 空间控件配置方法需要启动 Qt 设计师，通过拖动控件并设置控件属性来完成配置。 通过 Qt Desigenr 搭建 C+应用程序，提供的模块包括 EVWorkspace、GlobeWidget、 MapWidget、DatasourceWidget、AtlasWidget 和 KmlWidget。正确安装 EV-Globe SDK 后 EV-Globe 5.0 SDK 开发入门教程 6 在 QtDesigenr 中可以看到如下的控件列表： 图 2.2.1 控件列表 注意：如果设计器中没有出现控件列表，请检查设计器菜单中“帮
13、助”-“关于”-“插 件”中，上述插件是否运行正常，若运行不正常，点击刷新，若还未出现，可能安装时出现 问题，请您重新安装 SDK。 控件控件 描述描述 EVWorkspace 工作空间控件， 该控件管理工作空间文件和全 局工具栏，并且对程序进行初始化操作，是 EV-Globe 程序的核心，所以在二次开发的时 候，必须在窗口上放置一个 EVWorkspace， 并 且 只 能 放 置 一 个 ， 程 序 运 行 时 EVWorkspace 会隐藏在后台。 GlobeWidget 场景窗口控件，显示场景内容。 MapWidget 地图窗口控件，显示地图内容。 AtlasWidget 场景和地图树
14、控件，显示场景和地图的图层， 提供控制图层的显示与排序等功能。 DatasourceWidget 数据源树控件，显示打开的数据源，也可以在 这里打开一个数据源。 KmlWidget KML树控件，对KML资源进行管理。 LayoutWidget 布局窗口控件，显示地图的“布局视图” 。 EagleEyeWidget 鹰眼窗口控件，显示某个地图在进行放大，缩 小，平移等操作时，该地图的局部显示范围在 鹰眼图中所对应的矩形范围。 首先使用 Qt Designer 打开工程中 ui 文件， 首先从控件工具箱中拖动一个 EVWorkspace 控件到窗体， 调整好布局； 然后双击 EVWorkspac
15、e,打开设置窗口如图所示， 点击 “工程文件” 选项卡中的打开按钮，指定一个工作空间文件。注意窗口下方有一个”使用绝对路径”的选项， 一般在编写软件时使用绝对路径，发布软件时将其改为使用相对路径，并且将工作空间文件 EV-Globe 5.0 SDK 开发入门教程 7 一起发布(工作空间文件和数据文件最好同一目录)。使用相对路径后，相对路径文本框中的内 容将会被追加到程序所在路径之后，例如：程序所在路径“C:EV_GlobeBin” ，文本框填写 “dataev.evproj” ，程序运行时将用“C:EV_GlobeBindataev.evproj” 。如下图所示： 图 2.2.2 工程配置窗体
16、 EV-Globe 5.0 SDK 开发入门教程 8 2.3 第三步：通过控件快速搭建地图第三步：通过控件快速搭建地图 在配置好工作空间文件后，进行如下步骤，即可搭建好地图： a) 首先使用 Qt Designer 打开工程中的 ui 文件，将控件面板中的 MapWidget 控件，拖 到窗体中，放到合适的位置进行布局。 如下图所示： 图 2.3.1 MapWidget 控件 b) 然后我们需要对 MapWidget 控件进行设置，双击 MapWidget 控件，会弹出控件设 置对话框。在这里我们需要选择哪个地图进行显示，同时还可以选择显示哪些工具 栏。 EV-Globe 5.0 SDK 开发入门教程 9 图 2.3.2 地图参数设置 c) 运行程序，即可看到地图和工具栏。 图 2.3.3 地图展示 2.4 第第四四步：地图浏览功能步：地图浏览功能 在搭建好地图后，进行如下操作，即可启用地图浏览功能。 在设计器中双击 MapWidget 控件，在弹出的设置窗体中，勾选“工具栏”下“漫游”项， 点击确定
