Inside GDALAllRegister之三： 注册指定驱动

现在来仔细分析如何注册一个驱动的代码，看下面代码：

#ifdef FRMT_vrt
    GDALRegister_VRT();
#endif   

编译时指定或者取消FRMT_vrt，可以控制这条语句是否编译到可执行程序中。 在windows上面的用VC++编译器时，可以修改frmts/makefile.vc文件的EXTRAFLAGS值，比如：

EXTRAFLAGS  =	-DFRMT_nitf -DFRMT_gtiff -DFRMT_jpeg

因此，我的程序只注册了这三个驱动。

现在看注册函数内部都怎么实现的。迅速看了一下void GDALRegister_GTiff() 函数的代码，主要是创建一个GDALDriver对象，设置属性，然后调用GetGDALDriverManager()->RegisterDriver(poDriver) 将其添加进去。所以，现在可以回答register是什么的问题。就是为每一个driver，创建一个driver对象，添加到singleton对象GDALDriverManager中去。

注意GDALDriverManger的类声明在gdal_priv.h文件中，里面用了双指针保存所有的Driver的指针以方便象数组一样访问，同时用了<key, value> 结构的map也保存了Driver指针，便于用字符串查找。

class CPL_DLL GDALDriverManager : public GDALMajorObject
{
    int         nDrivers;
    GDALDriver  **papoDrivers;

    char        *pszHome;

    typedef std::map<CPLString, GDALDriver *> NameDriverMap;
    NameDriverMap m_NameDriverMap;

GDAL的函数注释都写在cpp文件中，这点很好。我一直都想这么干，这样维护代码的时候都方便啊，不用文件跳来跳去。

int GDALDriverManager::RegisterDriver( GDALDriver * poDriver ) 函数代码实现不复杂，就是存放到容器中。

大的算法就这么简单，现在来细看driver里面存放了什么值，代码：

        poDriver->SetDescription( "GTiff" );
        poDriver->SetMetadataItem( GDAL_DMD_LONGNAME, "GeoTIFF" );
        poDriver->SetMetadataItem( GDAL_DMD_HELPTOPIC, "frmt_gtiff.html" );
        poDriver->SetMetadataItem( GDAL_DMD_MIMETYPE, "image/tiff" );
        poDriver->SetMetadataItem( GDAL_DMD_EXTENSION, "tif" );
        poDriver->SetMetadataItem( GDAL_DMD_CREATIONDATATYPES, 
                                   "Byte UInt16 Int16 UInt32 Int32 Float32 "
                                   "Float64 CInt16 CInt32 CFloat32 CFloat64" );
        poDriver->SetMetadataItem( GDAL_DMD_CREATIONOPTIONLIST, 
                                   szCreateOptions );

        poDriver->SetMetadataItem( GDAL_DCAP_VIRTUALIO, "YES" );

        poDriver->pfnOpen = GTiffDataset::Open;
        poDriver->pfnCreate = GTiffDataset::Create;
        poDriver->pfnCreateCopy = GTiffDataset::CreateCopy;
        poDriver->pfnUnloadDriver = GDALDeregister_GTiff;
        poDriver->pfnIdentify = GTiffDataset::Identify;

前面一部分是设置元数据，重要的就是szCreateOptions，这是一个XML字符串，里面信息很多，等到具体理解了GTiff格式才能更进一步明白其含义。本文末尾会贴出来我的程序中用到的szCreateOptions的值。

然后就是设置一些函数指针，有Open, Create, CreateCopy等等。

<CreationOptionList>
  <Option name="COMPRESS" type="string-select">
    <Value>NONE</Value> 
    <Value>LZW</Value> 
    <Value>PACKBITS</Value> 
    <Value>JPEG</Value> 
    <Value>CCITTRLE</Value> 
    <Value>CCITTFAX3</Value> 
    <Value>CCITTFAX4</Value> 
    <Value>DEFLATE</Value> 
  </Option>
  <Option name="PREDICTOR" type="int" description="Predictor Type" /> 
  <Option name="JPEG_QUALITY" type="int" description="JPEG quality 1-100" default="75" /> 
  <Option name="ZLEVEL" type="int" description="DEFLATE compression level 1-9" default="6" /> 
  <Option name="NBITS" type="int" description="BITS for sub-byte files (1-7), sub-uint16 (9-15), sub-uint32 (17-31)" /> 
  <Option name="INTERLEAVE" type="string-select" default="PIXEL">
    <Value>BAND</Value> 
    <Value>PIXEL</Value> 
  </Option>
  <Option name="TILED" type="boolean" description="Switch to tiled format" /> 
  <Option name="TFW" type="boolean" description="Write out world file" /> 
  <Option name="RPB" type="boolean" description="Write out .RPB (RPC) file" /> 
  <Option name="BLOCKXSIZE" type="int" description="Tile Width" /> 
  <Option name="BLOCKYSIZE" type="int" description="Tile/Strip Height" /> 
  <Option name="PHOTOMETRIC" type="string-select">
    <Value>MINISBLACK</Value> 
    <Value>MINISWHITE</Value> 
    <Value>PALETTE</Value> 
    <Value>RGB</Value> 
    <Value>CMYK</Value> 
    <Value>YCBCR</Value> 
    <Value>CIELAB</Value> 
    <Value>ICCLAB</Value> 
    <Value>ITULAB</Value> 
  </Option>
  <Option name="SPARSE_OK" type="boolean" description="Can newly created files have missing blocks?" default="FALSE" /> 
  <Option name="ALPHA" type="boolean" description="Mark first extrasample as being alpha" /> 
  <Option name="PROFILE" type="string-select" default="GDALGeoTIFF">
    <Value>GDALGeoTIFF</Value> 
    <Value>GeoTIFF</Value> 
    <Value>BASELINE</Value> 
  </Option>
  <Option name="PIXELTYPE" type="string-select">
    <Value>DEFAULT</Value> 
    <Value>SIGNEDBYTE</Value> 
  </Option>
  <Option name="BIGTIFF" type="string-select" description="Force creation of BigTIFF file">
    <Value>YES</Value> 
    <Value>NO</Value> 
    <Value>IF_NEEDED</Value> 
    <Value>IF_SAFER</Value> 
  </Option>
  <Option name="ENDIANNESS" type="string-select" default="NATIVE" description="Force endianness of created file. For DEBUG purpose mostly">
    <Value>NATIVE</Value> 
    <Value>INVERTED</Value> 
    <Value>LITTLE</Value> 
    <Value>BIG</Value> 
  </Option>
  <Option name="COPY_SRC_OVERVIEWS" type="boolean" default="NO" description="Force copy of overviews of source dataset (CreateCopy())" /> 
</CreationOptionList>