V-Globe SDKSDKSDKSDK 二次开发教程
V-Globe
EEEEV-Globe
V-Globe
二次开发教程
二次开发教程
二次开发教程
北京国遥新天地信息技术有限公司
2222012012012012 年 6666 月 北京
版权所有 2011-2015,北京国遥新天地信息技术有限公司。
本版最终解释权归北京国遥新天地信息技术有限公司所有。
警告,本文档包含的所有内容是北京国遥新天地信息技术有限公司的财产,受到《中
华人民共和国著作权法》和《国际公约》的保护。未得到北京国遥新天地信息技术
有限公司的书面许可,不得以任何形式或手段复制、传播,或以任何电子和文本方
式翻印、转载本文档的任何部分。
本文档并不代表供应商及其代理的承诺,北京国遥新天地信息技术有限公司可以在
不做任何申明的情况下对本文档的内容进行修改。
徽标是北京国遥新天地信息技术有限公司的注册商标。
的一切有关权利属于北京国遥新天地信息技术有限公司所有。
本文档中所涉及的软件产品及其后续升级产品均由北京国遥新天地信息技术有限公
司制作并负责全权销售。
本文档中提到的其它公司及其产品的商标所有权属于该商标的所有者。
北京国遥新天地信息技术有限公司联系方式:
电话:+86-10-64876655
传真:+86-10-64884630
网址:http://www.ev-image.com
技术支持电子邮箱:support@ev-image.com
北京国遥新天地信息技术有限公司欢迎您的宝贵意见和建议。
前 言
EV-Globe SDK是一个开放式的三维地理信息系统软件二次开发包,它功能强大、
对象和接口数量众多,可以满足不同行业定制三维地理信息系统管理软件的需要。为
了帮助用户更好的使用EV-Globe SDK二次开发包,开发定制不同应用领域的三维地理
信息系统软件,国遥新天地公司研发中心编写了《EV-Globe SDK二次开发教程》。该
教程主要阐述了①EV-Globe 软件组成、功能简介、产品优势和体系结构,这部分的
内容可以使用户对EV-Globe 软件有一个总体的认识;②EV-Globe SDK二次开发包中
主要控件的详细介绍,这部分的内容可以循序渐进地引导用户加深对二次开发包中各
个模块的理解,以及更好地认识各模块之间的关系;③中级篇和高级篇的内容展示给
用户的是SDK更强大的渲染功能,同时以SDK的范例程序库作为参考(范例程序库在
EV-Globe SDK的安装包中提供),详细说明了如何使用EV-Globe SDK二次开发包来创
建实际的应用程序,提高用户运用EV-Globe SDK二次开发包建立三维GIS应用系统的
能力。本书与EV-Globe SDK范例程序库、EV-Globe SDK联机帮助文档互为补充,共
同组成EV-Globe SDK二次开发的帮助系统。
本书的读者
本书的读者应该具有一定的 C#编程经验,可以掌握 DirectX 方面的一些知识,
并对 GIS 有一定的了解,希望使用 EV-Globe SDK 二次开发包开发三维 GIS 应用软
件的程序设计人员和程序开发人员。本书没有过多的涉及 C#和 DirectX 编程方面的
知识,也没有向您详细的讲解 GIS 方面的理论知识,而是向您展示如何通过已有的
C#和 DirectX 方面的编程经验,结合 EV-Globe SDK 二次开发包定制实际的三维 GIS
应用。
本书的内容
本书的主要内容是如何利用 EV-Globe SDK 二次开发包创建三维 GIS 应用程序,
这些应用程序涵盖了通用三维 GIS 应用程序的大部分功能,包括三维影像的管理、
三维模型的动态加载、矢量数据的快速显示、三维空间分析、KML 地标管理、三维
特效、路径导航、地名查询等。此外,本书中级篇和高级篇的内容涵盖了三维渲染
的更多功能。
本书以 Microsoft Visual Studio2005 为开发环境、C#为开发语言,对 EV-Globe
SDK 的具体应用进行介绍,在编写时力求向用户展示一个清晰的流程。本书的目的
之一就是在您了解了如何使用 EV-Globe SDK 二次开发包定制各种三维 GIS 功能的
基础上,对三维 GIS 应用程序的建立形成一个宏观的概念,同时本书也是一本按功
能分类的 EV-Globe SDK 二次开发编程工具书。
关于如何使用本书,作者的建议是自己动手编写程序,这比一味读书的效果要
好很多,因为本书只能告诉您如何做,而不能代替您去做。希望您通过本书的学习,
能够写出好的三维 GIS 应用程序。
北京国遥新天地信息技术有限公司
2012 年 6 月
目 录
...........................................................................................................
...........................................................................................................
次开发教程...........................................................................................................
...........................................................................................................
EV-Globe SDKSDKSDKSDK 二次开发教程
EV-Globe
EV-Globe
EV-Globe
次开发教程
次开发教程
...................................................................................................................................................
...................................................................................................................................................
基础篇...................................................................................................................................................
...................................................................................................................................................
......................................................................................................................
......................................................................................................................
EV-Globe 综述......................................................................................................................
......................................................................................................................
EV-Globe
第 1111 章 EV-Globe
EV-Globe
1.1 EV-Globe 软件组成..................................................................................................................
1.2 功能简介..................................................................................................................................
1.3 功能更新..................................................................................................................................
1.4 产品优势..................................................................................................................................
1.5 体系结构..................................................................................................................................
..........................................................................................
..........................................................................................
EV-Globe SDKSDKSDKSDK 二次开发入门..........................................................................................
..........................................................................................
EV-Globe
第 2222 章 EV-Globe
EV-Globe
2.1 EV-Globe 主要功能模块简介..............................................................................................
2.2 二次开发包主要 dll 简介...................................................................................................
2.3 EV-Globe SDK 二次开发入门示例......................................................................................
2.3.1 创建新工程....................................................................................................................
2.3.2 配置 GlobeWindow 控件............................................................................................
2.3.3 添加代码启动工程......................................................................................................
........................................................................................
........................................................................................
GlobeWindow 控件开发指南........................................................................................
........................................................................................
GlobeWindow
第 3333 章 GlobeWindow
GlobeWindow
3.1 GlobeWindow 控件介绍......................................................................................................
3.2 GlobeWindow 控件开发示例..............................................................................................
3.2.1 初始化 GlobeWindow 控件........................................................................................
3.2.2 视图控制功能...............................................................................................................
3.2.3 飞行定位........................................................................................................................
3.2.4 保存屏幕快照...............................................................................................................
.............................................................................
.............................................................................
WorldLayerManager 控件开发指南.............................................................................
.............................................................................
WorldLayerManager
第 4444 章 WorldLayerManager
WorldLayerManager
4.1 控件简介................................................................................................................................
4.2 控件结构图............................................................................................................................
4.3 开发示例................................................................................................................................
IIII
1111
2222
3
5
7
8
9
12121212
12
13
14
14
14
15
19191919
19
20
20
21
28
28
30303030
30
31
31
I
..................................................................................................
..................................................................................................
第 5555 章 KMLKMLKMLKML 标注管理开发指南..................................................................................................
..................................................................................................
5.1 KmlLayerManager 控件简介................................................................................................
5.2 KmlLayerContainer 简介.......................................................................................................
5.3 开发示例................................................................................................................................
5.3.1 加载并初始化 KmlLayerManager 控件....................................................................
5.3.2 添加文件夹标注...........................................................................................................
5.3.3 添加点地标....................................................................................................................
5.3.4 添加路径标注...............................................................................................................
5.3.5 添加多边形标注...........................................................................................................
5.3.6 添加模型标注...............................................................................................................
5.3.7 添加影像覆盖层标注..................................................................................................
5.3.8 添加照片标注...............................................................................................................
5.3.9 添加网络连接标注......................................................................................................
5.3.10 添加长方体.................................................................................................................
5.3.11 添加锥体......................................................................................................................
5.3.12 添加半球......................................................................................................................
5.3.13 导入 KML/KMZ 文件..................................................................................................
.........................................................................................
.........................................................................................
NavigatePanel 控件开发指南.........................................................................................
.........................................................................................
NavigatePanel
第 6666 章 NavigatePanel
NavigatePanel
6.1 控件简介.................................................................................................................................
6.2 控件成员列表.......................................................................................................................
6.3 开发示例................................................................................................................................
6.3.1 加载并初始化 NavigatePanel 控件...........................................................................
6.3.2 加载默认航线文件......................................................................................................
6.3.3 加载自定义航线文件..................................................................................................
..................................................................................................
..................................................................................................
第 7777 章 地名查询模块开发指南..................................................................................................
..................................................................................................
7.1 PlacenameSearcher 对象......................................................................................................
7.2 PlacenameListView 控件......................................................................................................
7.3 开发示例................................................................................................................................
7.3.1 界面设计........................................................................................................................
32323232
32
33
33
33
34
36
36
37
38
39
40
41
42
43
44
45
47474747
47
47
48
48
48
49
50505050
50
50
51
51
II
7.3.2 编写代码........................................................................................................................
7.3.3 运行结果........................................................................................................................
...........................................................................................................
...........................................................................................................
第 8888 章 三维分析开发指南...........................................................................................................
...........................................................................................................
8.1 功能简介.................................................................................................................................
8.2 开发示例.................................................................................................................................
8.2.1 三维采点........................................................................................................................
8.2.2 高度测量........................................................................................................................
8.2.3 距离测量........................................................................................................................
8.2.4 面积测量........................................................................................................................
8.2.5 通视分析........................................................................................................................
8.2.6 剖面分析........................................................................................................................
8.2.7 坡度分析........................................................................................................................
8.2.8 土方分析........................................................................................................................
8.2.9 淹没分析........................................................................................................................
...........................................................................................................
...........................................................................................................
第 9999 章 三维特效开发指南...........................................................................................................
...........................................................................................................
9.1 三维特效简介.......................................................................................................................
9.2 开发示例................................................................................................................................
9.2.1 粒子效果........................................................................................................................
9.2.2 雨雪效果........................................................................................................................
9.2.3 反粒子效果....................................................................................................................
9.2.4 纹理动画........................................................................................................................
.........................................................................................................
.........................................................................................................
第 10101010 章 矢量地图开发指南.........................................................................................................
.........................................................................................................
10.1 HttpMapManager 对象......................................................................................................
10.1.1 简介...............................................................................................................................
10.1.2 主要成员列表.............................................................................................................
10.2 MapConditionQuery 控件..................................................................................................
10.2.1 简介...............................................................................................................................
10.2.2 成员列表......................................................................................................................
10.3 ResultSetGrid 控件..............................................................................................................
52
53
54545454
54
55
55
55
56
57
58
59
60
61
62
63636363
63
64
64
65
65
66
68686868
68
68
69
70
70
70
71
III
10.3.1 简介...............................................................................................................................
10.3.2 成员列表......................................................................................................................
10.4 开发示例..............................................................................................................................
10.4.1 设置界面......................................................................................................................
10.4.2 加载远程地图.............................................................................................................
10.4.3 基本查询操作.............................................................................................................
10.4.4 缓冲区分析.................................................................................................................
10.4.5 清除高亮......................................................................................................................
.................................................................................................................................................
.................................................................................................................................................
中级篇.................................................................................................................................................
.................................................................................................................................................
.........................................................................................................
.........................................................................................................
第 11111111 章 基础矢量开发指南.........................................................................................................
.........................................................................................................
11.1 EarthView.Globe.Core.Renderable 简介..........................................................................
11.2 示例程序..............................................................................................................................
11.2.1 创建工程......................................................................................................................
11.2.2 矢量点的绘制.............................................................................................................
11.2.3 点地标的添加.............................................................................................................
11.2.4 广告牌的创建.............................................................................................................
11.2.5 多边线的绘制.............................................................................................................
11.2.6 多边形的绘制.............................................................................................................
11.2.7 添加图像覆盖层.........................................................................................................
11.2.8 添加描述信息.............................................................................................................
11.2.9 自定义管线.................................................................................................................
.........................................................................................................
.........................................................................................................
第 12121212 章 管道流动开发指南.........................................................................................................
.........................................................................................................
12.1 管道类简介..........................................................................................................................
12.1.1 类 SinglePipeline.........................................................................................................
12.1.2 类 Pipeline....................................................................................................................
12.2 示例程序..............................................................................................................................
12.2.1 创建工程......................................................................................................................
12.2.2 界面设计......................................................................................................................
12.2.3 创建管道对象.............................................................................................................
71
71
72
72
73
75
77
78
79797979
80808080
80
81
81
81
84
85
86
88
90
91
92
94949494
94
94
96
97
97
97
97
IV