本節(jié)書摘來自異步社區(qū)出版社《GDAL源碼剖析與開發(fā)指南》一書中的第1章，第1.5節(jié)，作者：李民錄 更多章節(jié)內(nèi)容可以訪問云棲社區(qū)“異步社區(qū)”公眾號查看。

1.5 GDAL源碼目錄

GDAL源碼剖析與開發(fā)指南

下載的GDAL源代碼壓縮包目錄如圖1-2所示，使用SVN遷出的GDAL源代碼目錄如圖1-3所示。

從圖1-2和圖1-3所示可以看出，不管用什么方式獲取GDAL的源代碼，它的目錄結(jié)構(gòu)都是一樣的。下面我們就針對目錄結(jié)構(gòu)中的每個(gè)文件夾和文件作一個(gè)簡單的說明(按照字母順序)。

1.5.1 文件夾說明

對于圖1-3中所示的文件夾，詳細(xì)說明如下。

alg：該文件夾存放的是GDAL庫中提供的一些算法的源代碼，這些算法包括但不限于：DEM生成等高線算法，圖像糾正算法(幾何糾正、TPS糾正、RPC糾正等)，柵格矢量化算法，矢量柵格化算法，格網(wǎng)計(jì)算算法，PCT和RGB互轉(zhuǎn)算法，分類圖的小碎斑塊去除算法等。

apps：該文件夾中存放的是GDAL庫中提供的一些命令行工具集的源代碼，這些工具集的介紹可以參考http://gdal.org/gdal_utilities.html。后面會對這些工具做一個(gè)簡單的說明，其中有些工具非常有用，比如gdalinfo，可以用來查看圖像的元數(shù)據(jù)信息等。

bridge：該文件夾中存放的是用來連接GDAL抽象類的定義與GDAL自己的結(jié)構(gòu)體定義及其實(shí)現(xiàn)的源代碼。后面涉及GDAL的實(shí)現(xiàn)原理時(shí)我們會對該文件夾作一個(gè)比較詳細(xì)的介紹。

data：該文件夾中存放的是GDAL庫中需要用到的一些“配置文件”(此處叫配置文件可能不太準(zhǔn)確)，這些文件主要有ESRI的投影文件，ESPG的投影文件，PCI的投影和橢球體文件，AutoCAD的DXF格式的頭文件等。在使用GDAL庫的過程中可以在程序中使用函數(shù)`javascript

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

來`

設(shè)置該文件夾的目錄，如果沒有設(shè)置GDAL會自動從環(huán)境變量中查找，環(huán)境變量的名字叫GDAL_DATA，該變量的值就是data文件夾的路徑；如果還是沒有找到，那么GDAL可能會提示錯誤，比如在寫入AtuoCAD的dxf格式的時(shí)候如果不設(shè)置GDAL_DATA，那么就會提示創(chuàng)建不成功，后面遇到時(shí)我們會再進(jìn)行說明。

doc：該文件夾存放的是用來生成GDAL幫助文檔的一些dox文件。dox文件是使用doxygen工具來進(jìn)行生成的，后面我們會對doxygen工具作一個(gè)簡單的介紹，并且說明在自己的工程中怎樣使用doxygen生成程序的開發(fā)幫助文檔。

frmts：這個(gè)文件夾可以說是GDAL代碼中內(nèi)容最多的一個(gè)文件夾了，每次更新GDAL的版本后這個(gè)文件夾中都會多出幾個(gè)文件夾，同時(shí)在GDAL支持的文件格式中也會多出來幾個(gè)新的文件格式。沒錯，這個(gè)文件夾存放的就是GDAL針對不同的特定圖像格式解析的源代碼，我們可以舉幾個(gè)簡單的例子，比如bmp文件夾就是解析BMP圖像的，hfa文件夾是用來解析Erdas的img圖像格式，還有pcidsk文件夾是讀取PCI的pix格式的文件等。所以這個(gè)文件夾存放的是解析各個(gè)文件格式的源代碼。

gcore：這個(gè)文件夾是GDAL的靈魂所在，主要存放GDAL抽象類的數(shù)據(jù)集，圖像、波段的讀寫接口等都是在這里面實(shí)現(xiàn)的。如果想知道GDAL的抽象類是怎么對圖像格式進(jìn)行抽象的，讀者可以看看這個(gè)文件夾里面的代碼。

html：這個(gè)文件夾主要用來存放GDAL生成的幫助文檔，使用doxygen工具生成的GDAL幫助文檔會出現(xiàn)在這個(gè)文件夾中。如果使用壓縮包的話，該文件夾里面應(yīng)該是空的。后面我們會和doc文件夾一起進(jìn)行詳細(xì)介紹。

m4：該文件夾存放的是以m4為后綴名的文件。m4文件叫Macro Processor Library，是編譯基礎(chǔ)中最核心的文件，這個(gè)文件主要是用autoconf來產(chǎn)生configure配置文件，繼而自動生成Makefile文件。這個(gè)文件夾在Windows平臺下沒用，在此就不作細(xì)述了。

man：該文件夾是用來生成Linux或者其他平臺下的幫助文件，Windows平臺下也沒用。

ogr：GDAL和OGR曾經(jīng)是兩個(gè)庫，GDAL庫負(fù)責(zé)讀寫柵格數(shù)據(jù)，OGR庫負(fù)責(zé)讀寫矢量數(shù)據(jù)，然而GDAL的算法庫中經(jīng)常會用到矢量數(shù)據(jù)的讀取，將這兩個(gè)庫分開會造成不便，現(xiàn)在這兩個(gè)庫已經(jīng)整合到一起，OGR庫就是GDAL庫的一個(gè)子集。其實(shí)OGR庫還是可以單獨(dú)編譯出來的。ogr文件夾就是存放OGR庫源代碼的文件夾。后面我們會對這個(gè)文件夾里的內(nèi)容進(jìn)行詳細(xì)介紹。

port：該文件夾中存放的是CPL庫的東西，CPL是一個(gè)GDAL的底層支持庫，CPL庫中定義了一些字符串的操作、文件處理、網(wǎng)頁請求、數(shù)據(jù)庫連接、哈希表、字符加密文件壓縮等基礎(chǔ)的函數(shù)。比如GDAL中所有的導(dǎo)出函數(shù)符號CPL_DLL就是在這個(gè)CPL文件夾中定義的；還有frmts文件夾中，打開文件、打開數(shù)據(jù)庫、打開網(wǎng)絡(luò)路徑以及字符串的處理等都是用的port庫。

swig：該文件夾主要是存放swig的腳本。SWIG全稱叫Simplified Wrapper and Interface Generator，官方網(wǎng)站是http://www.swig.org/。SWIG的作用就是可以將C/C++寫的庫封裝為Python、C#、Java、Perl和Ruby等其他語言的訪問接口。GDAL的C#版本就是使用swig來編譯出來實(shí)現(xiàn)的。

vb6：這個(gè)文件夾用來將GDAL編譯成一個(gè)VB6的模塊，對于里面具體的文件說明以及如何編譯參考文件夾中的readme.txt，這里就不作具體說明了。

wince：顧名思義，這個(gè)文件夾中的文件就是用來編譯Windows CE平臺下的GDAL庫的，具體編譯請參考其中的說明文檔。

1.5.2 文件說明

aclocal.m4：同1.5.1小節(jié)介紹的m4文件夾。

autogen.sh：Linux平臺下的shell文件，通過調(diào)用autoconf來產(chǎn)生configure配置文件。

COMMITERS：該文件中的內(nèi)容是GDAL開發(fā)人員的信息，包括姓名、聯(lián)系郵箱以及各自負(fù)責(zé)開發(fā)的模塊說明等。

config.guess、config.sub、configure、configure.in：這四個(gè)文件在Windows下沒有具體作用，在此略過。

Doxyfile：Doxyfile就是前面doc文件夾說明中提到的doxygen的工程文件，用來生成幫助文檔，后面我們在介紹doxygen的使用時(shí)會對該文件進(jìn)行說明。

GDALmake.opt.in：這個(gè)文件是Linux平臺下的GDAL庫編譯配置文件，在后面的nmake.opt中我們會介紹其功能。

gdalnightlysvn.sh：Linux平臺下調(diào)用svn獲取GDAL源代碼的一個(gè)shell腳本。

GNUmakefile：GNU的make文件。

HOWTO-RELEASE：GDAL發(fā)布版本的一些說明。

install-sh：Linux平臺下GDAL的安裝shell腳本。

LICENSE.TXT：GDAL的許可說明文件。

ltmain.sh：Linux平臺下libtool的shell腳本，Windows下沒用到。

makefile.vc：GDAL的編譯文件，用來將源代碼編譯成dll文件，后面我們會在GDAL編譯中作進(jìn)一步說明。

makegdal_gen.bat：一個(gè)用來生成VS的工程文件的批處理文件，后面在GDAL編譯中我們會對該文件的使用方式進(jìn)行說明。

makegdal10.sln：文件夾中所有的sln文件都是VS的項(xiàng)目文件，文件名后的數(shù)字代表的是VS的版本號。

makegdal10.vcxproj、makegdal71.vcproj：VS的工程文件，該文件可以由makegdal_gen.bat文件自動生成，后面我們會詳細(xì)介紹。

mkbindist.sh、mkgdaldist.sh、mktestdist.sh：三個(gè)shell腳本文件，Windows下沒用，略過。

NEWS：介紹GDAL的新增功能以及修復(fù)的bug記錄等。

nmake.opt：GDAL編譯選項(xiàng)配置文件，在編譯GDAL中，可以指定GDAL綁定的其他庫等都在這里進(jìn)行設(shè)置。在后面的GDAL編譯中我們會詳細(xì)說明。

nmake-wince.opt：編譯wince版本的編譯選項(xiàng)配置文件。

PROVENANCE.TXT：GDAL目錄說明文件，如果上面說明的不夠清楚，可以參考這個(gè)文件。

submake.bat：一個(gè)編譯的批處理文件。

svnkeywords.sh：SVN的又一個(gè)shell腳本。

VERSION：GDAL版本信息。

總結(jié)

以上是生活随笔為你收集整理的java实现gdal栅格矢量化,《GDAL源码剖析与开发指南》一一1.5 GDAL源码目录的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。