= FDOGDAL Raster Provider = The fdogdal provider is the open source raster provider for FDO (and hence !MapGuide). It is implemented on top of the [http://www.gdal.org/ 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 Documentation] * [#MapGuide2.1 MapGuide 2.1] * [#MrSIDandECWPluginSupportWindows MrSID and ECW Plugin Support (Windows)] * [#FDO3.2.0MapGuide1.1.0 MapGuide 1.1 / FDO 3.2.0] * [#FDO3.2.3MapGuide1.2.0 MapGuide 1.2 / FDO 3.2.3] * [#FDO3.3.0MapGuide2.0.0 MapGuide 2.0 / FDO 3.3.0] * [#FDO3.4.0MapGuide2.1.0 MapGuide 2.1 / FDO 3.4.0] * [#UsingwithAutodeskMapGuideStudio Using with Autodesk MapGuide Studio] * [#CreatingTileIndexConfigFiles Creating Tile Index Config Files] * [#DebuggingRastersinMapGuide Debugging Rasters in MapGuide] * [#DevelopmentStatus Current Issues and Work Items] = Documentation = * [http://fdo.osgeo.org/fdogdal/index.html User Documentation] * [http://fdo.osgeo.org/files/fdo/docs/GDAL/index.html FDO API Documentation] = !MapGuide 2.1 = A website under the !MapGuide Trac wiki has been set up for GDAL in !MapGuide 2.1 [http://trac.osgeo.org/mapguide/wiki/MGOS21GdalProvider http://trac.osgeo.org/mapguide/wiki/MGOS21GdalProvider] = MrSID and ECW Plugin Support (Windows) = 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 due to licensing issues, but you can add GDAL plugins for these formats to your installation. Make sure to read the appropriate license agreements ([http://home.gdal.org/dl/mapguide/lizardtech_click_through.txt MrSID] , [http://home.gdal.org/dl/mapguide/ECW_SDK_License_V44.pdf ECW]) and if you agree then follow these instructions for your version of FDO/MapGuide. == FDO 3.2.0 / !MapGuide 1.1.0 == The plugins for this version of !FdoGdal are available here: http://home.gdal.org/dl/mapguide/ 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 == The plugins for this version of !FdoGdal are available here: http://home.gdal.org/dl/mapguide/ Only download and unzip the mg_ecw.zip and/or mg_mrsid.zip files into your !MapGuideOpenSource/Server/Bin directory == FDO 3.3.0 / !MapGuide 2.0.0 == This version uses the standard Visual C 2005 GDAL plugins: http://home.gdal.org/dl/gdal14_vc8/ There are three files in this directory: - ecw_plugin_gdal14_vc8.zip : ECW GDAL Plugin - mrsid_plugin_gdal14_vc8.zip : MrSID GDAL Plugin - gdal144_vc8_sdk.zip : Do NOT download, not required for !MapGuide or FDO. Each file contains a "gdalplugins" folder, as well as some dlls in the root of the zipfile. To install these plugins into !MapGuide, you need to: 1. Extract the zipfile to a temporary location 2. Copy the "gdalplugins" folder to the !MapGuide installation directory under Server/Bin/ 3. Copy the dll files that unzipped into the root of the temporary location to the !MapGuide installation directory under Server/Bin/Fdo/ The final location for the ECW files should look something like this: {{{ Server/Bin/Fdo/libecwj2.dll Server/Bin/gdalplugins/gdal_ECW.dll }}} And for the MrSID files, like this: {{{ Server/Bin/Fdo/lti_dsdk_cdll.dll Server/Bin/Fdo/lti_dsdk_dll.dll Server/Bin/gdalplugins/gdal_MrSID.dll }}} == FDO 3.4.0 / !MapGuide 2.1.0 == A website under the !MapGuide Trac wiki has been set up for GDAL in !MapGuide 2.1 [http://trac.osgeo.org/mapguide/wiki/MGOS21GdalProvider http://trac.osgeo.org/mapguide/wiki/MGOS21GdalProvider] = Using with Autodesk !MapGuide Studio = To publish rasters using the open source raster provider with [http://usa.autodesk.com/adsk/servlet/index?id=7176611&siteID=123112 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. = Overriding Coordinate Systems = !MapGuide 2.0 requires that the coordinate system of the data source matches the coordinate system of the map it is being displayed in. If the file lacks a coordinate system or has one that does not match the map coordinate system though it ought to you can override the coordinate system as part of the FDO connection. In !MapGuide Maestro, there is a section called "Coordinate system override". Click on the "Refresh" button to load in the data set's implicit coordinate system. Double-click on the "Default" entry to bring up the override dialogue, and then click on the ellipsis (...) next to "Target" to set the actual coordinate system. In Autodesk !MapGuide Studio (2008 at least), there is a section called "Set coordinate system overrides". To use it, click on the "Refresh" button to load the dataset's implicit coordinate system, highlight the default spatial context, and then click on "Edit" to bring up a coordinate system picker. = 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. [/mapguide/wiki/maestro MapGuide Maestro] will allow you to create these tile indexes in an intuitive GUI. If you prefer a web-based application, you can easily create a new tile-enabled data connection by running a script that Jason has provided, but this script will likely not be maintained going forward. Usage notes are included: [http://www.jasonbirch.com/fdogdal/rasterconfig.phps View Source] | [http://www.jasonbirch.com/fdogdal/rasterconfig.readme.txt README] | [http://www.jasonbirch.com/fdogdal/rasterconfig.zip 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 }}} In !MapGuide 2.0 the raster coordinate system and the map coordinate system MUST be the same. If not, you will recieve an error in the !MapGuide log file. Also not that the two coordinate systems must be excatly the same, not just logically equal. If the coordinate systems are logically equal (ea. has the same coordinate values) a coordinate system override must be added to the feature source. = Development Status = This is just a quick reference of outstanding issues / working points [[TicketQuery(status=new|assigned|reopened&component^=GDAL&order=priority)]]