MapGuide RFC 52 - Remove GD Renderer

This page contains an change request (RFC) for the MapGuide Open Source project. More MapGuide RFCs can be found on the RFCs page.


RFC Template Version1.0
Submission DateJuly 16, 2008
Last ModifiedWalt Welton-Lair Timestamp?
AuthorWalt Welton-Lair
RFC Statusproposed
Implementation Statuspending
Proposed Milestone2.1
Assigned PSC guide(s)Tom Fukushima
Voting History
no vote


MapGuide currently has two image-based renderers: GD and AGG. AGG was added in Fall 2007 with MapGuide RFC 40, and is now the preferred image renderer. There is no good reason to continue supporting the GD renderer.


The GD renderer was MapGuide's initial image-based renderer. While it does a good job, the AGG renderer now provides superior image quality, especially when it comes to anti-aliasing. The AGG renderer is now also mature in terms of stability and performance. For this reason AGG is configured as MapGuide's default image-based renderer. As of today (7/28/2008) there are three reported issues involving AGG (#459, #632, and #634).

One of GD renderer's biggest issues is that it doesn't provide full support for the new stylization (MapGuide RFC 14). In particular it does not support clipped area styles. While support for this could be added, it seems like a waste of time given that AGG already fully supports the new stylization and provides better image quality. A recent RFC around raster reprojection (MapGuide RFC 51) also raised the issue as to whether GD renderer would need to be updated.

From a SWD point-of-view it's clearly more work to support both AGG and GD renderer. AGG is the renderer we are pushing going forward, and SWD effort should be spent improving it and not GD.

Proposed Solution

Removing GD renderer will be simple. It involves deleting a couple of source files in the Renderers project, and removing support for the "Renderer" setting under "GeneralProperties" in the serverconfig.ini file.

Note that we can't remove the GD library from the Oem area, since AGG renderer still uses it for read/write support of JPG/GIF/PNG8 images.


After this change, any MapGuide server which was configured to render using GD will now only render using AGG.

This will have a slight impact on partial tile sets which were generated using GD. If the server is updated and the tile sets are migrated, then the existing tiles will continue to be served up, while any new tiles which are generated will be done using the AGG renderer. This will cause discrepancies at boundaries which have a GD tile on one side and an AGG tile on the other. The workaround is to regenerate the tile set using AGG.

We should also address the open issues before removing GD renderer.

Test Plan

The code that will be updated to remove support for the "Renderer" serverconfig.ini setting will be tested. No changes / additions to unit tests will be necessary.


Provided by Autodesk.

Additional Notes

Here's some additional feedback from Zac Spitzer around AGG vs. GD:

  • 4/10/2009 - I've made some changes to AGG which attempt to address this. See the images in the attached file (
  • 4/13/2009 - The modified source for these changes is attached ( This is relative to trunk revision 3818.
Last modified 9 years ago Last modified on Apr 13, 2009 4:10:07 PM

Attachments (2)

Download all attachments as: .zip