OsgGIS的project其实就是一个指令集.执行该指令集就可以从要素和栅格数据中编译出OSG的3D几何体.(对于开发者而言,意味着使用osgGISProjects::Project类).可以通过xml文件定义整个project 然后使用osggis_build命令行工具来编译.
本文对project所使用的xml定义文件做基本的解释.
项目文件:
有两种方式都可以创建一个项目:通过编程或者通过xml文件.我们选择使用xml文件作为project文件的框架是因为:1)xml便于人们阅读和理解2)很多人都很熟悉xml文件的语法格式3)已经存在大量的工具来读写和装换xml数据.
project文件类似于Makefile,它定义了一些列的构建目标和规则.下面是一个基本的project文件:
所有的元素都定义在<project>下.其中<layer> <source>和<graph>分别定义了project中的不同的组件.下面我们来一一说明.
语法规则
下面是project文件中的一些语法规则:
1.次序性:元素在xml文件中出现的次序是不重要的。有更多元素通过name来引用其他元素.被引用的元素在xml文件中的位置是不重要的.
2.独特性:元素的name只要求在相同元素类型的所有元素中唯一.例如:每一个source元素的名字应该是所有的source中是唯一的.一个source和一个layer同名是可以的。
3.路径分割符:在所有平台上,路径分隔符都是前斜线("/").
4.属性名称:在属性名称中连字符(-)和下划线(_)是被认为是同一个字符.也就是说,use-terrain-srs和user_terrain_srs是同一个名称.
包含文件(include file)
project文件有可能会很巨大而且很复杂,比如:
1.需要编译好几十个图层
2.同一组数据源(datasource)需要在不同的项目中共享
3.同一组资源文件需要在不同的项目中共享
可以通过include元素来合并project文件.被include的文件自己本身也需要有project元素.
下面是范例代码:
include元素可以在文档中的任何位置出现,和其它元素一样,其位置不构成任何影响.
路径和URI(Paths and URIs)
许多元素都会引用外部文件,例如数据文件或者其他需要include的项目文件.文件的路径可以是绝对路径也可以是相对路径。如果是相对路径,那么相对是指相对于包含此引用的项目文件自身的路径.(应该是指直接包含) 下面是范例代码:
在树元素(name="trees")中uri引用了一个绝对路径.而在道路元素(name="roads")中,uri引用了一个相对路径。这个相对路径是相对于包含此source界面的项目文件的位置的.
Project Elements
下面是project文件中的主要元素
- <project> - 顶级元素
- <layer> - 编译一个图层的起点
- <graph> -将图层组合为场景图的管道
- <source> - 引用矢量数据源
- <terrain> - 引用地形数据源
- <resource> - 引用外部的纹理、模型或者其他资源
- <include>? - 引用外部文件
- <script>? - 嵌入式的Lua代码
- <map> - 运行时地图定义