GDAL1.9.1 IN VS2008 C#中的编译及使用

下载gdal1.9.1到官网：http://www.gdal.org/

GDAL库的简洁、高效深受开发人员的喜爱，很多开源的GIS软件甚至是商业GIS软件都使用了这个库。GDAL使用C++，在Visual studio环境下开发，对C，C++的支持当然不会有什么问题。但对于C#、Python、Java来说，过程就相对繁琐一些，对初学者造成了不少的麻烦。本文以GDAL1.9.1为例，详细说明在CSharpe语言中使用GDAL的环境配置问题，希望对初用GDAL的人员有所帮助。

GDAL从1.4.1开始添加了swig，以支持.NET环境下的C#语言。在swig文件夹中包含了C#源代码。以下是主要的处理步骤：

1、准备一个C++编译器。该实例使用Visual studio2008。

2、下载源码：http://download.osgeo.org/gdal/

3、把gdal191.zip解压至“D:\gdal-1.9.1”，当然放在其它文件夹也可以。

4、创建安装的目标文件夹“C:\gdal-runtime”，稍后的编译配置中，我们将配置GDAL把编译后将会安装到这个文件夹内。

5、修改编译配置文件夹“C:\gdal-1.9.1\nmake.opt”。以下是第41至第43行的内容:

!IFNDEF GDAL_HOME

GDAL_HOME = "C:\warmerda\bld"

!ENDIF

默认的情况下，GDAL将会安装到"C:\warmerda\bld"文件夹内，为了更好地了解安装过程，我们把第42行修改成如下内容：

GDAL_HOME = "C:\gdal-runtime"

6、编译源文件。使用“Visual Studio 2008 命令提示”工具来进行，(该工具位于“开始\程序\Microsoft Visual Studio 2008\Visual Studio Tools”内)。

打开“Visual Studio 2008 命令提示”工具，键入"cd D:\gdal-1.9.1"，进入源文件所在的文件夹，再键入"nmake /f makefile.vc"执行编译。编译过程可能需要一些时间，主要取决于机器的性能。

7、安装文件。

键入“nmake /f makefile.vc install”，执行完毕后，"C:\gdal-runtime"文件夹下增加了bin，data，及html文件夹。

键入“nmake /f makefile.vc devinstall”执行完毕后，"C:\gdal-runtime"文件夹下增加了lib，include文件夹。这两个文件夹主要用于C及C++的开发。

在"C:\gdal-runtime\bin"文件夹内已经生成了gdal15.dll文件，这是GDAL库的核心，不管采用何种开发方式，最终都由这个DLL文件来执行实质性的操作。

8、编译C#源文件。

键入“cd D:\gdal-1.9.1\swig\csharp”，进入C#源文件所在的文件夹。

键入“nmake /f makefile.vc”，编译完毕后生成8个DLL文件：gdal_csharp.dll、gdalconst_csharp.dll、ogr_csharp.dll、osr_csharp.dll和gdal_wrap.dll、gdalconst_wrap.dll、ogr_wrap.dll、osr_wrap.dll。前面4个文件名中都含有"csharp",用法与另外4个稍有不同，稍后详细讨论。

（在C#项目中，要将C:\gdal-runtime\bin目录下的gdal19.dll，连同在D:\gdal-1.9.1\swig\csharp目录生成的8个dll一起放到项目的Debug目录下）

9、在VS2005 CSharp项目中添加对GDAL的引用。新建一个CShapr应用程序项目，然后添加对C:\gdal-runtime\bin中4个含有"csharp"的DLL文件的引用。至此我们就可以使用GDAL的功能了。为了测试GDAL是否可以运行，我们为窗体的Load事件增加如下的代码：

private void Form1_Load(object sender, EventArgs e)
{
try
{
OSGeo.GDAL.Gdal.AllRegister();
OSGeo.GDAL.Dataset dataSet = OSGeo.GDAL.Gdal.Open(@"C:\F-49-32-(10).tif", Access.GA_ReadOnly);
int w = dataSet.RasterXSize;
int h = dataSet.RasterYSize;
MessageBox.Show("image width=" + w + ",height=" + h);
}
catch (Exception err)
{
Console.WriteLine(err.Message);
}
}

为了运行程序，Open方法的第一个参数@"C:\F-49-32-(10).tif"应改成你本机上图像文件所在的路径。如果运行正常的话将弹出一个对话框，显示图像的宽度和高度。

备注：

可以把8个DLL文件复制到安装文件夹"C:\gdal-runtime\bin"。 把路径C:\gdal-runtime\bin添加到系统变量Path

1、关于GDAL_DATA系统变量。GDAL建议创建这个系统变量，从上面的讨论中，我们已经知道，这个系统变量并非必须的，但是如果你想使用一些GDAL提供的例子，那就很有必要，因为样例中的某些方法需要访问这个系统变量。

2、我们已经提到过，创建安装文件夹并非必须的；如果使用默认的方式来编译，将安装到C:\warmerda\bld文件夹内。无论使用何种方式，要想使用GDAL，你的C#程序必须能访问到这些DLL文件：包括上面提到的8个DLL文件，以及C:\gdal-runtime\bin\gdal15.dll文件。我们可以用一句话来概括：C#环境下使用GDAL的问题核心，实质上就是如何保证C#程序能够访问到这9个DLL文件。

在此，我们回顾一下Windows搜索DLL文件的基本规则：

1）执行文件所在的文件夹。

2）windows系统安装文件夹，即安装了windows的文件夹，GetWindowsDirectory( )函数可提供该目录的路径名。

3）Windows系统目录，即System32子目录；调用GetSystemDiretory( )函数可获得这个目录的路径名。

4)在系统变量Path中配置的文件夹，或用dos的path命令指定的文件夹。

5）网络中映象的目录列表中的全部目录。

在需要调用DLL文件时，windows将按以上的顺序，逐一查找各个文件夹，如果找不到相应的文件，将返回异常信息。

根据以上的规则，系统变量path中不必包含GDAL的安装路径，我们只要把这9个DLL文件复制到执行文件所有的位置，同样可以运行。例如把文件复制到bin/debug或bin/release文件夹内，这样程序的运行就不再依赖于任何系统变量了。这种方式非常适合于发布和打包最终的应用程序。在程序开发期间，我们仍然提倡使用系统变量指向GDAL安装路径的方式，开发时将更加有灵活性。

2、GDAL（Geospatial Data Abstraction Library）从1.4.1版本开始支持.NET环境下的C#语言。基本的编译步骤参照《如何在CSharp中使用GDAL》（http://blog.csdn.net/gisblog/archive/2008/10/06/3021933.aspx），博主把步骤写的很详细，一路参照编译顺利，只是把自己遇到的几个问题总结如下：

a）GDAL的底层是用C++写的，所以要用C++编译器才会编译成功。

b）生成的九个dll中，gdal19.dll才是GDAL库的实现核心。

c）在C#中使用时，需要引用四个有_csharp后缀的dll。

d）在开发过程，最好把编译的GDAL库bin文件夹加入到系统环境变量中。

e）在打包和用于发布的应用程序中，需要把9个dll文件全部拷贝到程序目录中。

注意了上面的细节，就可以顺利使用啦↖(^ω^)↗