GDAL添加ECW格式支持

chj0771

GDAL添加ECW格式支持
　　本文翻译自 http://trac.osgeo.org/gdal/wiki/ECW，有少量的修改及补充。

ECW
　　这个驱动程序的最终用户文档:​http://www.gdal.org/frmt_ecw.html

下载ECW JPEG SDK
　　为了让GDAL可以使用ECW格式，你需要从Hexagon Geospatial网站下载ERDAS ECW/JP2 SDK。
　　
4.3或更高版本的只读SDK(不支持写ECW文件)需要在同意许可条款后免费下载。如果要通过ECW SDK写ECW或JPEG2000文件，必须从Hexagon Geospatial/ERDAS购买可写版本的SDK.
　　如果可以找到过期的libecwj 3.3 SDK，也可以使用它。它的许可信息有显著不同。下面的叙述和讨论基于3.3 SDK。

在Unix平台构建支持ECW的GDAL
　　假设您已经在默认位置(LIBRARY_PATH)安装了libecwj库，那么将ECW支持添加到GDAL的过程很简单。
　　
只需要在生成编译GDAL的Makefile的configure命令中添加ecw库的安装路径：
$ cd /path/to/gdal　　
$ ./configure --with-ecw=/usr/local
　　
$ make
　　
# make install
　　如果在构建中存在问题，可以查看gdal/frmts/ecw/GNUmakefile中的CPPFLAGS是否定义了-DPOSIX和-DLINUX。参考#3344
　　在完成上面步骤后，可以查看GDAL已安装支持格式列表，可以看到有ECW:
$ gdalinfo --formats|grep ECW　　ECW (rw): ERMapper Compressed Wavelets
　　JP2ECW (rw+): ERMapper JPEG2000
　　注意:所有依赖GDAL的服务都应该重启。例如：Apache需要重新加载PHP MapScript。

二进制ECW SDK和GCC >= 5.1
　　由于GCC 5.1以后，GCC默认使用新的C++ ABI和libstdc++，它与ECW SDK二进制文件不兼容（至少当前如此）。解决的办法是使用CXXFLAGS="-D_GLIBCXX_USE_CXX11_ABI=0"选项去构建GDAL。
./configure CXXFLAGS="-D_GLIBCXX_USE_CXX11_ABI=0"　　注意:如果你还使用别的使用新的C++ ABI的库（例如：likbml，podofo，poppler，cryptopp等，这通常来自发行版自带的），则这个方法无法正常使用。如果你必须使用这些库，你必须找到它们的源码，并使用CXXFLAGS="-D_GLIBCXX_USE_CXX11_ABI=0"选项重新编译。

在Linux上构建的教程
　　​http://trac.osgeo.org/ubuntugis/wiki/UserTutorials

在Windows上构建支持ECW的GDAL
　　在nmake.opt中有以下使用4.1或更新的只读SDK构建读取支持的选项，去掉前面的注释，并修改ECWDIR只想的路径。
# Uncomment the following and update to enable ECW read support with the　　
# 4.1+ readonly SDK
　　
#ECWDIR  =  "c:/Program Files/ERDAS/ERDAS ECW JPEG2000 Read SDK"
　　
#ECWFLAGS = -DECWSDK_VERSION=41 \
　　
#       -I$(ECWDIR)\include \
　　
#       -I$(ECWDIR)\include/ecw/api -I$(ECWDIR)\include/ecw/jp2 \
　　
#       -I$(ECWDIR)\include/ecw/ecw
　　
#ECWLIB  =  $(ECWDIR)\lib\vc90\win32\NCSEcw4_RO.lib \
　　
#       $(ECWDIR)\lib\vc90\win32\NCSUtil4.lib \
　　
#       $(ECWDIR)\lib\vc90\win32\NCScnet4.lib
　　GDAL自带的nmake.opt还是默认的VS2008，比较老了。
　　
实际上现在nmake.opt里面有两处关于ECWSDK的位置，最新版本的ECWSDK5需使用链接NCSEcw.lib或者静态库NCSEcwS.lib的即可。如果编译64位版本，还需要去掉WIN64=YES前的#，大致在189行。 例如在使用VS2015`编译的时候，修改的位置及结果如下：
# 45行位置，修改编译器版本　　
MSVC_VER=1900
　　

　　
# 189行位置，编译64位版本
　　
WIN64=YES
　　

　　
# 303行位置，修改libecwj路径
　　
ECWDIR  =   "c:/Program Files/ERDAS ECW JPEG 2000 SDK 5.3.0"
　　
ECWFLAGS =  -DECWSDK_VERSION=53 \
　　-I$(ECWDIR)\include \
　　-I$(ECWDIR)\include/NCSECW/API -I$(ECWDIR)\include/NCSECW/JP2 \
　　-I$(ECWDIR)\include/NCSECW/ECW
　　
ECWLIB  =   $(ECWDIR)\lib\VC140\x64\NCSEcw.lib
　　一旦构建，则需要将一些ECW的dll拷贝到系统路径(程序工作目录也可)中(VC9环境下如下)
copy "C:\Program Files\ERDAS\ERDAS ECW JPEG2000 Read SDK\redistributable\vc90\win32\*.dll" C:\windows\system32　　当前最新版本的为ECW JPEG 2000 SDK 5.3.0，使用VC11/12/14编译。
　　以上将ECW的支持构建到GDAL核心DLL中。
　　为了构建ECW和JP2ECW驱动程序作为插件，需要取消nmake.opt中注释的插件行：
# To build ECW support as a plugin uncomment the following, and make sure　　
# to do "nmake /f makefile.vc plugin" in gdal/frmts/ecw and copy the two
　　
# resulting DLLs to an appropriate place.
　　
ECW_PLUGIN = YES
　　然后到gdal/frmts/ecw(在GDAL构建后)中去创建插件plugins:
  nmake /f makefile.vc plugin　　然后将该目录中生成的dll复制到合适的GDAL插件目录，例如.exe文件所在目录下的gdalplugins目录中，或着是GDAL_DRIVER_PATH配置选项(或环境变量)指向的目录。

在Unix上构建libecwj 3.3库
　　为了在Linux``Solaris或Mac OS系统下使用具有ECW支持的GDAL，您需要自己构建libecwj库，因此需要下载Image Compression SDK源代码，而不是专门为Windows系统分发的二进制文件。当前版本是ECW SDK 3.3，源码包名为libecwj2-3.3-2006-09-06.zip。
　　源码包中有configure和Makefile.in脚本，还有一个bootstrap脚本，可以重新生成configure和Makefile.in文件。请先确保已经安装了:autoconf, automake, m4, libtool程序。
　　程序的构建示例如下：
$ cd /path/to/libecwj2-3.3　　
$ ./configure
　　
$ make
　　
# make install
　　上面配置没有指定安装路径，最后一步需要superuser权限。
　　在SuSE 11(低版本gcc),你需要传递一个flag给configure脚本去使用c99兼容性。
$ cd /path/to/libecwj2-3.3　　
$ ./configure CFLAGS="-std=c99"
　　
$ make
　　
# make install
　　默认情况下，安装时使用prefix指向目录/usr/local来安装libecwj。你可以使用configure的--prefix选项指定。运行configure --help查看更多选项。如果编译libecwj使用了--prefix(例如/usr/local/libecwj2-3.3)，则make install会失败，因为不会自动创建<prefix>/include。执行mkdir <prefix>/include(例如mkdir /usr/local/libecwj2-3.3/include)，然后再次运行make install。
　　在较新的平台(Fedora 16/17/18和RHEL/CentOS 6)上，libecwj2可以在读取JPEG2000文件时会导致程序崩溃。错误在与libecwj2绑定的XML处理代码中，显而易见，这是新的编译器带来的问题。上述平台的一个解决办法是在编译libecwj2时禁用优化，可以通过传递-O0来配置：
$ ./configure CFLAGS="-O0" CXXFLAGS="-O0"　　或者在make时候指定:
$ make CFLAGS="-O0" CXXFLAGS="-O0"
Mac OS X notes
　　在Mac OS X上构建libecwj2-3.3可能会有一点问题。相关详细信息，参阅#2032。

libecwj2-3.3 补丁
　　使用最新的编译器从源码构建libecwj2-3.3可能需要一些改进，可以在#3162中找到libecwj2的修复程序和补丁程序中找到。
　　综合累积可用补丁：
　　
https://trac.osgeo.org/gdal/attachment/wiki/ECW/libecwj2-3.3.patch
　　使用libecwj2-3.3打开和关闭ECW文件占用大量内存的问题，可以使用http://trac.osgeo.org/mapserver/ticket/3245补丁来解决。
　　#3366中提供了一个补丁，来避免在libecwj2-3.3中的NCSPhysicalMemorySize()的linux实现中溢出。这个工作可以解决内存大于2G的计算机中大内存使用情况。
　　A patch to fix crash when creating 16 bit JP2 (that occurs on 64bit platforms) is available in ticket #2593中提供了修复16 bit JP2(在64为平台发生)时出现故障的补丁。
　　在最新的平台(如Fedora 17，使用GCC 4.7)上修复ECWInitialize()崩溃的补丁程序可在#4868中找到。

Open Tickets
　　#2162 ecw_cs.dat文件出自多云天(provenance cloudy)
　　
#2340 意大利基准(italian datum)问题。
　　
#4127 [PATCH] ECW文件ecw_cs.wkt附加CRS定义。