FDOGDAL Raster Provider

The fdogdal provider is the open source raster provider for FDO (and hence MapGuide). It is implemented on top of the ​GDAL raster library. Frank Warmerdam (warmerdam at pobox.com) is the primary author of fdogdal. Questions about the provider may asked on the fdo or mapguide users lists.

Index

• Documentation
• MrSID and ECW Plugin Support
• Using with Autodesk MapGuide Studio
• Creating Tile Index Config Files
• Debugging Rasters in MapGuide

Documentation

• User Documentation
• FDO API Documentation

MrSID and ECW Plugin Support

MrSID and ECW are popular wavelet compression formats used for imagery. Support for these formats is not included in the official FDO or MapGuide releases for licensing issues, but you can add plugins to your installation to use these formats.

Frank Warmerdam is making these plugins available on his site:

​http://home.gdal.org/dl/mapguide/

Make sure to read the appropriate license agreements, and then follow these instructions for your version of FDO/MapGuide

FDO 3.2.0 / MapGuide 1.1.0

Follow the instructions in the readme file (​http://home.gdal.org/dl/mapguide/README.txt), downloading and unzipping the files mg_fdogdal_110.zip, mg_ecw.zip, and/or mg_mrsid.zip into your MapGuideOpenSource/Server/Bin directory

FDO 3.2.3 / MapGuide 1.2.0

Only download and unzip the mg_ecw.zip and/or mg_mrsid.zip files into your MapGuideOpenSource/Server/Bin directory

Using with Autodesk MapGuide Studio

To publish rasters using the open source raster provider with ​Autodesk MapGuide Studio use the following steps:

1. Start Studio and connect to your MapGuide Open Source server.
2. Then do File > New > Data Connection...
3. In the Connect To Data dialog that comes up, select OSGeo FDO Provider for Raster, then press OK. An editor that says "Configure a Feature Resource using the Generic Editor" will display.
4. In the Connection Properties grid, there is a DefaultRasterFileLocation property. Click in the value column and enter the directory where your image files are. On Linux it has the form /home/thf/myimages and on Windows it has the form C:\myimages.
5. The configuration of the raster source is now complete, save the resource and start using it.

Notes:

• In MapGuide 1.1, the layer definition preview does not show the raster. In order to preview the data, create a map definition and set the extents of the map to contain the raster data. If the extents are set correctly the raster data should show in the preview.

Creating Tile Index Config Files

Please note that this only applies to FDO 3.2.3 and MapGuide 1.2 or greater.

If you have a lot of raster images in a single directory, it can be prohibitively slow to read through all of these images just to display a small area of them.

With the release of FDOGDAL 3.2.3, Frank has added support for tile indexes in an XML config file.

If you are using MapGuide 1.2, you can easily create a new tile-enabled data connection by running a script that Jason has provided. Usage notes are included:

​View Source | ​README | ​Zip Download

Debugging Rasters in MapGuide

If your rasters are not showing correctly in MapGuide, it can be instructive to run MgServer.exe at the command line in interactive mode, with the CPL_DEBUG environment variable set to ON. This will report various GDAL level debugging output. At the very least this should give an idea of the files that GDAL is trying to open.

eg.

  cd \"Program Files"\MapGuideOpenSource\server\bin
  set CPL_DEBUG=ON
  mgserver stop
  mgserver run