编译r源码包-GDAL源码分析（三）Swig编译及帮助文档生成

也想出现在这里？点击联系我~

立即下单

进入商城

进不了网站？换个网络试试！

一、Swig编译 1.Swig介绍 SWIG的全称是SimplifiedWrapperandInterfaceGenerator，官网：。 SWIG 是一种开发工具，可以帮助用 C 或 C++ 编译的软件嵌入并与各种其他中间编程语言连接。 SWIG可以应用于多种类型的语言，包括Perl、PHP、Python、Tcl、Ruby和PHP等常用的脚本编译语言。 支持的语言列表还包括非脚本编译语言，例如 C#、CommonLisp（CLISP、AllegroCL、CFFI、UFFI）、Java、Modula-3、OCAML 和 R，甚至编译器或汇编规划应用程序（Guile ，MzScheme，鸡）。 SWIG 通常用于创建中间语言解析或汇编环境、用户界面，以及作为测试 C/C++ 或原型设计的工具。 SWIG 还可以导入 XML 或 Lisps 表达式格式的解析树。 SWIG 可以自由使用、分发和修改以用于商业或非商业用途。 【摘自SWIG官网】。

下载安装Swig时，一定要下载Swigwin（我下载的是swigwin-2.0.4.zip），不要下载源码，否则Windows下无法使用。 下载完后解压，并将swigwin-2.0.4解压后的目录添加到环境变量Path中，否则配置文件会出现一些麻烦。 检查swig是否成功设置到环境变量Path的最简单方法是在运行时输入swig并回车。 如果提示windows找不到swig，则说明设置不成功； 如果绿屏闪过，则表示设置成功。

2. 编译C#版本的GDAL。 首先，打开nmake.opt文件，找到SWIG=swig.exe这句话。 如果环境变量中没有添加swig目录，则将这句话旁边的swig.exe改为swig.exe。 完整路径编译r源码包，例如 F:Work3rdPartswigwin-2.0.4swig.exe。 如果设置了环境变量，则无需更改。

然后按照第二篇文章中使用cmd命令编译GDAL的方法进行编译，打开“VisualStudio2008命令提示符”并定位GDAL源代码目录，然后依次执行以下三行命令：

[Python]

nmake/fmakefile.vcnmake/fmakefile.vcinstallnmake/fmakefile.vcdevinstall

执行后，会在GDAL_HOME目录下生成编译好的dll和exe文件以及include、lib等文件夹。 拿起它并使用cd命令进入swigcsharp文件夹：

[Python]

"font-size:16px;color:#3333ff;">"white-space:pre">cdswigcsharp"white-space:pre">#nmake/fmakefile.vcinterface#这句话不需要“white-space”目前：pre">nmake/fmakefile.vc"white-space:pre">nmake/fmakefile.vcinstall

执行前两句后，会在csharp文件夹中生成8个dll文件，将这8个dll文件复制到GDAL输出目录中的csharp文件夹中。 之后，您可以在C#项目中引用这些dll。 需要注意的是，使用这些dll时，需要将gdal18.dll及其依赖的其他dll复制到同一目录下才能正常运行。 。

3.编译Java版本的GDAL首先需要有JDK环境。 如果您没有，可以下载并安装一个。 然后打开nmake.opt文件，找到第86行左右的位置：

[Python]

“空白：pre”>JAVA_HOME=C:ProgramFilesJavajdk1.6.0_26

将之前的路径改为JDK目录并保存。 使用cd命令在打开的命令行中定位到swig目录后，输入以下命令：

[Python]

“空白：pre”>nmake/fmakefile.vcjava

4. 编译Python版本的GDAL。 首先，在编译Python版本之前，请确保您的笔记本中已经安装了Python。 相信大家都已经安装好了ArcGIS。 恭喜，你不需要安装Python编译r源码包，因为安装ArcGIS时必须安装它。 对于Python，同样将Python bin目录添加到环境变量Path中。 确保这一步完成后，下一步就是编译Python版本的GDAL。

打开nmake.opt文件，找到第76行：

[Python]

“空白：pre”>PYDIR =“C： Python26”

将之前的路径修改为Python的安装路径并保存。 使用cd命令将命令行定位到swigpython目录后，依次输入：

[Python]

“空白：pre”>pythonsetup.pybuild “空白：pre”>pythonsetup.pyinstall

执行上述命令后，您将在python site-packages目录中看到更多的gdal和ogr文件以及osgeo文件夹。 我本地机器的目录是C:Python26Libsite-packages。 然后将编译好的gdal18.dll及其依赖的所有dll复制到site-packages文件夹中的osgeo文件夹中。 最后，您可以在Python中使用imortgdal来使用GDAL。 测试Python版本的gdal是否安装成功，可以使用以下命令：

[Python]

fromosgeoimportgdalfromosgeo.gdalconstimport*dataset=gdal.Open("F:WorkDataenvi.img",GA_ReadOnly)dataset.GetDriver().ShortName#'ENVI'#图像格式 dataset.GetProjectionRef()#'PROJCS["未命名",GEOGCS["NAD83",DATUM["North_American_Datum_1983",SPHEROID["GRS1980",6378137,298.257222101,AUTHORITY["EPSG","7019"]],TOWGS84[0,0,0,0,0,0 , 0],权威["EPSG","6269"]],PRIMEM["格林威治",0,权威["EPSG","8901"]],UNIT["度",0.0174532925199433,权威["EPSG", " 9108"]],权威["EPSG","4269"]],投影["横轴墨卡托"],参数["原点纬度",30],参数["中央子午线",-84.16666666666667],参数["比例因子", 0.9999 ],PARAMETER["false_easting",2296587.926509186],PARAMETER["false_northing",0],UNIT["Foot(International)",0.3048]]'#图像投影信息

注意，命令中以#开头的是Python输出的。 如果可以输出里面的信息，则GDALforPython安装成功。 2.开发帮助文档生成 1.Doxygen介绍 以下内容摘自维基百科，地址。

Doxygen 是 C++、C、Java、Objective-C、Python、IDL（CORBA 和 Microsoft 风格）、Fortran、VHDL、PHP、C# 和 D 的文档生成器。可以在大多数类 Unix 系统以及 MacOSX 操作系统上运行系统和 Microsoft Windows。 Doxygen 的初始版本借用了旧版本 DOC++ 的一些代码； 此后，Doxygen 源代码由 Dimitrivan Heesch 重新绘制。

Doxygen 是一个用于编写软件参考文档的工具。 文档直接写在代码中，因此相对容易保持最新。 Doxygen 可以交叉引用文档和代码，使文件的读者可以轻松引用实际代码。

KDE 使用 Doxygen 作为其部分文档，并且 KDevelop 有外部支持。 Doxygen 根据 GNU 通用公共许可证发布，是免费软件。

需要注意的是，在使用doxygen时，一些类图和函数调用图会被手动生成。 如果你想生成这些图表，你还需要另一个非常狡猾的开源库 Graphviz。 Graphviz（GraphVisualizationSoftware的缩写）是AT&T实验室推出的开源工具包，用于勾画DOT语言脚本描述的图形。 它还提供供其他软件使用的库。 Graphviz 是一款根据 CommonPublicLicense 授权的免费软件。 其Mac版本此前曾获得2004年苹果设计奖。有关Graphviz的更多信息，请参考其官方网站：。

2.生成GDAL开发帮助文档。 首先下载并安装 Doxygen 和 Graphviz。 安装后最好将Doxygen和Graphviz的bin目录添加到系统环境变量Path中。 有些参数设置起来比较麻烦，所以放在Path中比较方便。

安装Doxygen后，开始菜单中会有一个doxywizard.exe程序。 打开它，然后在File->Open...菜单中选择GDAL源代码目录中的Doxyfile文件。 之后，切换到“运行”选项卡并单击“RunDoxygen”按钮。 之后会手动提取源码中的注释，生成gdal帮助文档。 默认输出目录是GDAL目录下的html目录。 等待生成完成后，点击左下角的ShowHtmlOutput，打开生成的帮助文档。 如右图所示：

第三，GDAL帮助文档基本生成。 打开后你会发现和GDAL官方网站一模一样。 还有一个问题。 这里生成的只是GDAL的帮助文档，没有OGR的帮助文档。 同样按照前面的步骤打开GDAL目录中OGR文件夹中的Doxyfile。 然后单击生成。 生成的目录默认为ogr文件夹下的html文件夹。 将文件夹重命名为ogr，然后将整个html复制到上一层。 同时，复制GDAL目录下doc文件夹中的html文件夹。 将除 dox 文件之外的所有文件复制到 html 文件夹中。

最后，你还记得编译GDAL后生成的html文件夹吗？ 将这两个文件夹的内容合并，即可得到完整的GDAL帮助文档。 主页是html文件夹中的index.html。 如右图所示：

3.Doxygen脚本配置及代码注释编写规范

对于Doxygen脚本配置，可以打开doxywizard，在Wizard和Expert选项卡中，在每一项中，将键盘移到最前面，在视图区域中就会显示一条非常详细的帮助信息（是英文的，不难）。左下角。 这是文档“Doxygen 配置和用户手册”。 文档包含了一切，非常好的东西。

第三篇文章结束了。 下一篇文章是GDAL工具集的介绍。 敬请期待后续！