《GDAL源码剖析与开发指南》一一1.7 SWIG编译

1.7 SWIG编译

GDAL源码剖析与开发指南
1.7.1 SWIG简介
SWIG全称是Simplified Wrapper and Interface Generator,官方网站是http://www.swig.org/。SWIG是一个开发工具,能够将使用C或者C++编写的软件与其他各种高级编程语言进行嵌入联接。SWIG能应用于各种不同类型的语言,包括常用脚本编译语言例如Perl、PHP、Python、Tcl、Ruby、PHP等,也包括非脚本编译语言,如C#、Common Lisp (CLISP、Allegro CL、CFFI、UFFI)、Java、Modula-3、OCAML、R等。SWIG最典型的应用就是转换C/C++接口,产生高级语言需要的代码来调用C/C++代码。SWIG是一个免费开源软件,可以在商业或非商业中自由使用、分发、修改。

下载安装Swig的时候我们注意要下载Swigwin文件而不是下载源代码。以swigwin-2.0.4为例,我们下载swigwin-2.0.4.zip文件后解压,将解压目录也添加到环境变量Path中去,否则后面需要设置swig的所在目录。检验swig是否成功设置到环境变量Path中的最简单的办法就是在运行中输入swig后回车,如果提示windows找不到swig,那么说明没有设置成功;如果出现一个黑屏一闪而过,那么说明已经设置成功了。

下面三小节需要在安装完SWIG之后才能进行编译。需要注意的是,编译下面三种语言的GDAL之前,我们首先要编译C++版本的,就是1.6节的内容。
**
1.7.2 编译C#版本GDAL**
首先,我们打开nmake.opt文件,找到SWIG = swig.exe这一句,假如没有将swig的目录添加到环境变量中,那么将这句后面的swig.exe修改为swig.exe的全路径,如F:\Work\3rdPart\swigwin-2.0.4\swig.exe;如果设置了环境变量,那么就不需要进行修改了。

然后,我们按照1.6节中的使用cmd命令编译GDAL的方式来进行编译,打开“Visual Studio 2008命令提示”并定位到GDAL源代码目录,然后依次执行如下三行命令,其实就是编译C++版本的GDAL。

nmake /f makefile.vc
nmake /f makefile.vc install
nmake /f makefile.vc devinstall

执行以上三句之后,接下来我们使用cd命令,进入swig\csharp文件夹中并使用nmake工具编译,命令如下所示。

cd swig\csharp
nmake /f makefile.vc
nmake /f makefile.vc install

执行完以上两句命令后,系统会在csharp文件夹下生成8个dll文件,并将这8个dll文件复制到GDAL输出目录下的csharp文件夹中。

这8个dll分别如下。

gdal\_csharp.dll
gdal\_wrap.dll
gdalconst\_csharp.dll
gdalconst\_warp.dll
ogr\_csharp.dll
ogr\_wrap.dll
osr\_csharp.dll
osr\_wrap.dll

在C#工程中引用GDAL的时候,我们只需要把上面8个dll中后面以_csharp.dll结尾的四个dll加入到C#工程中即可。需要注意的是,在使用这几个dll的时候我们需要将gdal110.dll以及它依赖的其他dll都复制到同一个目录中,才能使C#程序正常运行。

1.7.3 编译Python版本GDAL
在编译Python版本之前,我们要确保自己的电脑中已经安装了Python。如果我们安装了ArcGIS软件,那么就不用再安装Python了,因为在安装ArcGIS的时候必须要安装Python。将Python的bin目录添加到环境变量Path中去,然后我们就可以开始编译Python版本的GDAL了。

打开nmake.opt文件(1.10版本大概76行左右),将PYDIR后面的路径修改为本机Python的路径。

PYDIR   ="C:\Python26"

修改完之后,保存nmake.opt文件。接下来使用cd命令将命令行定位到swig\python目录后,依次输入如下命令。

python setup.py build
python setup.py install

执行完上述命令后,我们会在python的site-packages目录看到多了GDAL和OGR的文件以及一个osgeo的文件夹。我们将编译出来的gdal110.dll以及它依赖的所有DLL都复制到site-packages文件夹中的osgeo文件夹中,最后就可以在Python中用imort gdal来使用GDAL了。测试Python版本的gdal是否安装成功,可以使用如下Python代码。

from osgeo import gdal
from osgeo.gdalconst import *
dataset = gdal.Open("F:\Work\Data\envi.img",GA\_ReadOnly)
dataset.GetDriver().ShortName
#'ENVI' #图像格式
dataset.GetProjectionRef()
#'PROJCS["unnamed",GEOGCS["NAD83",DATUM["North\_American\_Datum\_1983",SPHEROID["GRS 1980",6378137,298.257222101,AUTHORITY["EPSG","7019"]],TOWGS84[0,0,0,0,0,0,0], AUTHORITY["EPSG","6269"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9108"]],AUTHORITY["EPSG","4269"]],PROJECTION["Transverse\_Mercator"],PARAMETER["latitude\_of\_origin",30],PARAMETER["central\_meridian",-84.16666666666667],PARAMETER["scale\_factor",0.9999],PARAMETER["false\_easting",2296587.926509186],PARAMETER["false\_northing",0],UNIT["Foot (International)",0.3048]]' #图像投影信息

1.7.4 编译Java版本GDAL
在编译Java版本的GDAL时,除SWIG之外,我们还需要JRE和Ant这两个工具,没有的话需要先下载安装,其中ANT只需直接解压,不用安装。接下来我们用记事本打开nmake.opt,找到第86行左右位置(1.10版本),将文件中的JAVA_HOME和ANT_HOME修改为本机的路径,只要修改到主文件夹即可(就是bin文件夹所在的文件夹);如果文件夹路径有空格的话,把路径用双引号引起来,修改后的内容与以下代码类似。

# SWIG Java settings
!IFNDEF JAVA\_HOME
JAVA\_HOME = "C:\Program Files\Java\jdk1.6.0\_26"
!ENDIF
!IFNDEF ANT\_HOME
ANT\_HOME = F:\Work\GDAL\gdal\_need\apache-ant-1.8.4
!ENDIF
JAVADOC = $(JAVA\_HOME)\bin\javadoc
JAVAC = $(JAVA\_HOME)\bin\javac
JAVA = $(JAVA\_HOME)\bin\java
JAR = $(JAVA\_HOME)\bin\jar
JAVA\_INCLUDE = -I$(JAVA\_HOME)\include -I$(JAVA\_HOME)\include\win32

修改保存之后,我们就可以编译Java版本的GDAL了,首先还是要先编译C++版本的GDAL,然后使用cd命令切换到swig文件夹中,开始编译Java版本GDAL。

nmake /f makefile.vc
nmake /f makefile.vc install
nmake /f makefile.vc devinstall
cd swig
nmake /f makefile.vc java

正常情况下,执行完上面的命令后Java版本的GDAL应该就编译完成了。编译出来的文件存放在swig\java目录中,主要有以下五个文件。

gdalconstjni.dll
gdaljni.dll
ogrjni.dll
osrjni.dll
gdal.jar

如果目录中有上面的五个文件,那就说明编译成功,如果没有,则要根据命令行编译的输出信息排除错误重新生成。我们将上面五个文件以及编译GDAL时生成的gdal110.dll复制到一个新建的文件夹,用于Java程序调用。

时间: 2024-09-09 17:24:05

《GDAL源码剖析与开发指南》一一1.7 SWIG编译的相关文章

《GDAL源码剖析与开发指南》一一1.8 GDAL帮助文档生成

1.8 GDAL帮助文档生成 GDAL源码剖析与开发指南1.8.1 Doxygen简介 Doxygen是生成C++注释文档的标准工具,也支持其他语言,如C.Objective-C.C#.PHP.Java.Python.IDL (Corba and Microsoft flavors).Fortran.VHDL.Tcl等. 我们可以通过三种方式来使用Doxygen. 1.从源文件中以HTML形式生成在线文档浏览器,或者以LATEX形式生成非在线的参考手册,也支持RTF (MS-Word).Post

《GDAL源码剖析与开发指南》一一1.5 GDAL源码目录

1.5 GDAL源码目录 GDAL源码剖析与开发指南 下载的GDAL源代码压缩包目录如图1-2所示,使用SVN迁出的GDAL源代码目录如图1-3所示. 从图1-2和图1-3所示可以看出,不管用什么方式获取GDAL的源代码,它的目录结构都是一样的.下面我们就针对目录结构中的每个文件夹和文件作一个简单的说明(按照字母顺序). 1.5.1 文件夹说明 对于图1-3中所示的文件夹,详细说明如下. alg:该文件夹存放的是GDAL库中提供的一些算法的源代码,这些算法包括但不限于:DEM生成等高线算法,图像

《GDAL源码剖析与开发指南》一一1.6 GDAL编译

1.6 GDAL编译 GDAL源码剖析与开发指南 GDAL的编译分为三个小节,第一节是常规编译,使用微软的Visual Studio 2008进行编译,如果用微软的其他编译器,编译过程与此类似.需要注意的是,GDAL已经不再支持Visual C++6.0编译器.第二小节主要说明怎样修改GDAL的配置文件,以使GDAL支持更多的数据格式以及算法等.第三小节对编译GDAL的64位版本进行说明. 1.6.1 常规编译 1.使用Visual Studio 2008 IDE编译 在GDAL的源代码目录中,

《GDAL源码剖析与开发指南》一一1.1 什么是GDAL

1.1 什么是GDAL GDAL源码剖析与开发指南 GDAL全称是Geospatial Data Abstraction Library(地理空间数据抽象库),是一个在X/MIT许可协议下读写空间数据(包括栅格数据和矢量数据)的开源库,它利用抽象数据模型来表达所支持的各种文件格式,还使用一系列命令行工具来进行数据转换和处理. OGR(OGR Simple Features Library)是GDAL项目的一个分支,功能与GDAL类似,只是它提供对矢量数据的读写支持.同时它实现了一个对空间参考信息

《GDAL源码剖析与开发指南》一一1.3 GDAL支持的数据格式

1.3 GDAL支持的数据格式 GDAL源码剖析与开发指南 GDAL支持的数据格式分为两种:栅格数据格式和矢量数据格式.GDAL在每次版本更新的时候,都会加入对新的格式的支持.本书使用GDAL1.10版本中支持的栅格数据格式,如表1-1所示,支持的矢量数据格式如表1-2所示. 注意 文件的最大存储大小不仅由文件的格式决定,而且和操作系统有关系.

《GDAL源码剖析与开发指南》一一1.4 GDAL源码下载

1.4 GDAL源码下载 GDAL源码剖析与开发指南 GDAL的源码下载有两种方式.第一种是直接下载打包好的压缩包,下载地址为:http://trac.osgeo.org/gdal/wiki/DownloadSource.另外,GDAL的各个历史版本都可以在这个地址进行下载:http://download.osgeo.org/gdal/.这种下载方式很简单,此处不作说明.下载完成,使用压缩软件解压即可. 第二种下载方式是使用SVN源代码管理工具直接从GDAL的源码服务器进行下载.下载地址是:ht

《GDAL源码剖析与开发指南》一一1.2 GDAL特点

1.2 GDAL特点 GDAL源码剖析与开发指南GDAL提供对多种栅格数据的支持,包括Arc/Info ASCII Grid(asc),GeoTiff (tiff),Erdas Imagine Images(img),ASCII DEM(dem) 等格式. OGR提供对矢量数据格式的读写支持,包括ESRI Shapefiles.S-57.SDTS.PostGIS.Oracle Spatial.Mapinfo mid/mif和Mapinfo TAB等. GDAL库还提供了一系列算法接口,比如矢量栅

《GDAL源码剖析与开发指南》一一1.9 简单的调用

1.9 简单的调用 GDAL源码剖析与开发指南关于GDAL的使用,关键是要熟悉GDAL的组织结构.类以及类的函数等.最常用的就是动态库的GDAL,当然我们也可以使用静态库,这里只是简单地介绍使用动态GDAL库来做开发. 下面我们简单地使用C++.C#.Python和Java 4种语言分别进行示例,来说明如何使用GDAL进行开发. 1.9.1 C ++使用GDAL首先我们打开Visual Studio2008,新建一个Win32的控制台工程(名字叫GDALCppTest),然后在工程的属性对话框中

《GDAL源码剖析与开发指南》导读

前言 GDAL源码剖析与开发指南 GDAL全称是Geospatial Data Abstraction Library(地理空间数据抽象库),是一个在X/MIT许可协议下读写空间数据(包括栅格数据和矢量数据)的开源库,它利用抽象数据模型来表达所支持的各种文件格式,还使用一系列命令行工具来进行数据转换和处理. 由于GDAL库支持很多数据格式,目前几乎所有的GIS和RS软件底层都使用GDAL来读写空间数据. 目前国内外关于GDAL的图书非常少,比较权威的只有GDAL官网的说明文档,导致用户缺少实用的