本节书摘来自异步社区出版社《GDAL源码剖析与开发指南》一书中的第1章，第1.5节，作者：李民录 更多章节内容可以访问云栖社区“异步社区”公众号查看。

1.5 GDAL源码目录

GDAL源码剖析与开发指南

下载的GDAL源代码压缩包目录如图1-2所示，使用SVN迁出的GDAL源代码目录如图1-3所示。

从图1-2和图1-3所示可以看出，不管用什么方式获取GDAL的源代码，它的目录结构都是一样的。下面我们就针对目录结构中的每个文件夹和文件作一个简单的说明(按照字母顺序)。

1.5.1 文件夹说明

对于图1-3中所示的文件夹，详细说明如下。

alg：该文件夹存放的是GDAL库中提供的一些算法的源代码，这些算法包括但不限于：DEM生成等高线算法，图像纠正算法(几何纠正、TPS纠正、RPC纠正等)，栅格矢量化算法，矢量栅格化算法，格网计算算法，PCT和RGB互转算法，分类图的小碎斑块去除算法等。

apps：该文件夹中存放的是GDAL库中提供的一些命令行工具集的源代码，这些工具集的介绍可以参考http://gdal.org/gdal_utilities.html。后面会对这些工具做一个简单的说明，其中有些工具非常有用，比如gdalinfo，可以用来查看图像的元数据信息等。

bridge：该文件夹中存放的是用来连接GDAL抽象类的定义与GDAL自己的结构体定义及其实现的源代码。后面涉及GDAL的实现原理时我们会对该文件夹作一个比较详细的介绍。

data：该文件夹中存放的是GDAL库中需要用到的一些“配置文件”(此处叫配置文件可能不太准确)，这些文件主要有ESRI的投影文件，ESPG的投影文件，PCI的投影和椭球体文件，AutoCAD的DXF格式的头文件等。在使用GDAL库的过程中可以在程序中使用函数`javascript

CPLSetConfigOption("GDAL_DATA","C:GDALdata")；

来`

设置该文件夹的目录，如果没有设置GDAL会自动从环境变量中查找，环境变量的名字叫GDAL_DATA，该变量的值就是data文件夹的路径；如果还是没有找到，那么GDAL可能会提示错误，比如在写入AtuoCAD的dxf格式的时候如果不设置GDAL_DATA，那么就会提示创建不成功，后面遇到时我们会再进行说明。

doc：该文件夹存放的是用来生成GDAL帮助文档的一些dox文件。dox文件是使用doxygen工具来进行生成的，后面我们会对doxygen工具作一个简单的介绍，并且说明在自己的工程中怎样使用doxygen生成程序的开发帮助文档。

frmts：这个文件夹可以说是GDAL代码中内容最多的一个文件夹了，每次更新GDAL的版本后这个文件夹中都会多出几个文件夹，同时在GDAL支持的文件格式中也会多出来几个新的文件格式。没错，这个文件夹存放的就是GDAL针对不同的特定图像格式解析的源代码，我们可以举几个简单的例子，比如bmp文件夹就是解析BMP图像的，hfa文件夹是用来解析Erdas的img图像格式，还有pcidsk文件夹是读取PCI的pix格式的文件等。所以这个文件夹存放的是解析各个文件格式的源代码。

gcore：这个文件夹是GDAL的灵魂所在，主要存放GDAL抽象类的数据集，图像、波段的读写接口等都是在这里面实现的。如果想知道GDAL的抽象类是怎么对图像格式进行抽象的，读者可以看看这个文件夹里面的代码。

html：这个文件夹主要用来存放GDAL生成的帮助文档，使用doxygen工具生成的GDAL帮助文档会出现在这个文件夹中。如果使用压缩包的话，该文件夹里面应该是空的。后面我们会和doc文件夹一起进行详细介绍。

m4：该文件夹存放的是以m4为后缀名的文件。m4文件叫Macro Processor Library，是编译基础中最核心的文件，这个文件主要是用autoconf来产生configure配置文件，继而自动生成Makefile文件。这个文件夹在Windows平台下没用，在此就不作细述了。

man：该文件夹是用来生成Linux或者其他平台下的帮助文件，Windows平台下也没用。

ogr：GDAL和OGR曾经是两个库，GDAL库负责读写栅格数据，OGR库负责读写矢量数据，然而GDAL的算法库中经常会用到矢量数据的读取，将这两个库分开会造成不便，现在这两个库已经整合到一起，OGR库就是GDAL库的一个子集。其实OGR库还是可以单独编译出来的。ogr文件夹就是存放OGR库源代码的文件夹。后面我们会对这个文件夹里的内容进行详细介绍。

port：该文件夹中存放的是CPL库的东西，CPL是一个GDAL的底层支持库，CPL库中定义了一些字符串的操作、文件处理、网页请求、数据库连接、哈希表、字符加密文件压缩等基础的函数。比如GDAL中所有的导出函数符号CPL_DLL就是在这个CPL文件夹中定义的；还有frmts文件夹中，打开文件、打开数据库、打开网络路径以及字符串的处理等都是用的port库。

swig：该文件夹主要是存放swig的脚本。SWIG全称叫Simplified Wrapper and Interface Generator，官方网站是http://www.swig.org/。SWIG的作用就是可以将C/C++写的库封装为Python、C#、Java、Perl和Ruby等其他语言的访问接口。GDAL的C#版本就是使用swig来编译出来实现的。

vb6：这个文件夹用来将GDAL编译成一个VB6的模块，对于里面具体的文件说明以及如何编译参考文件夹中的readme.txt，这里就不作具体说明了。

wince：顾名思义，这个文件夹中的文件就是用来编译Windows CE平台下的GDAL库的，具体编译请参考其中的说明文档。

1.5.2 文件说明

aclocal.m4：同1.5.1小节介绍的m4文件夹。

autogen.sh：Linux平台下的shell文件，通过调用autoconf来产生configure配置文件。

COMMITERS：该文件中的内容是GDAL开发人员的信息，包括姓名、联系邮箱以及各自负责开发的模块说明等。

config.guess、config.sub、configure、configure.in：这四个文件在Windows下没有具体作用，在此略过。

Doxyfile：Doxyfile就是前面doc文件夹说明中提到的doxygen的工程文件，用来生成帮助文档，后面我们在介绍doxygen的使用时会对该文件进行说明。

GDALmake.opt.in：这个文件是Linux平台下的GDAL库编译配置文件，在后面的nmake.opt中我们会介绍其功能。

gdalnightlysvn.sh：Linux平台下调用svn获取GDAL源代码的一个shell脚本。

GNUmakefile：GNU的make文件。

HOWTO-RELEASE：GDAL发布版本的一些说明。

install-sh：Linux平台下GDAL的安装shell脚本。

LICENSE.TXT：GDAL的许可说明文件。

ltmain.sh：Linux平台下libtool的shell脚本，Windows下没用到。

makefile.vc：GDAL的编译文件，用来将源代码编译成dll文件，后面我们会在GDAL编译中作进一步说明。

makegdal_gen.bat：一个用来生成VS的工程文件的批处理文件，后面在GDAL编译中我们会对该文件的使用方式进行说明。

makegdal10.sln：文件夹中所有的sln文件都是VS的项目文件，文件名后的数字代表的是VS的版本号。

makegdal10.vcxproj、makegdal71.vcproj：VS的工程文件，该文件可以由makegdal_gen.bat文件自动生成，后面我们会详细介绍。

mkbindist.sh、mkgdaldist.sh、mktestdist.sh：三个shell脚本文件，Windows下没用，略过。

NEWS：介绍GDAL的新增功能以及修复的bug记录等。

nmake.opt：GDAL编译选项配置文件，在编译GDAL中，可以指定GDAL绑定的其他库等都在这里进行设置。在后面的GDAL编译中我们会详细说明。

nmake-wince.opt：编译wince版本的编译选项配置文件。

PROVENANCE.TXT：GDAL目录说明文件，如果上面说明的不够清楚，可以参考这个文件。

submake.bat：一个编译的批处理文件。

svnkeywords.sh：SVN的又一个shell脚本。

VERSION：GDAL版本信息。