本節書摘來自異步社群出版社《gdal源碼剖析與開發指南》一書中的第1章，第1.5節，作者：李民錄 更多章節内容可以通路雲栖社群“異步社群”公衆号檢視。
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互轉算法，分類圖的小碎斑塊去除算法等。
bridge：該檔案夾中存放的是用來連接配接gdal抽象類的定義與gdal自己的結構體定義及其實作的源代碼。後面涉及gdal的實作原理時我們會對該檔案夾作一個比較詳細的介紹。
data：該檔案夾中存放的是gdal庫中需要用到的一些“配置檔案”（此處叫配置檔案可能不太準确），這些檔案主要有esri的投影檔案，espg的投影檔案，pci的投影和橢球體檔案，autocad的dxf格式的頭檔案等。在使用gdal庫的過程中可以在程式中使用函數<code>`</code>javascript
cplsetconfigoption("gdal_data","c:gdaldata")；
來<code>`</code>
設定該檔案夾的目錄，如果沒有設定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庫。
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版本資訊。