java实现gdal栅格矢量化,《GDAL源码剖析与开发指南》一一1.5 GDAL源码目录
本節書摘來自異步社區出版社《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版本信息。
總結
以上是生活随笔為你收集整理的java实现gdal栅格矢量化,《GDAL源码剖析与开发指南》一一1.5 GDAL源码目录的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Msql自定义函数和存储过程
- 下一篇: 如果您遇到文件或数据库问题,如何重置Jo