| Version 7 (modified by , 14 years ago) ( diff ) |
|---|
Rendering Service HTTP APIs
Revision History
| Revision | Date | Author | Comment |
| 0.1 | April 16, 2010 | Trevor Wekel | Initial documentation pass |
Table of Contents
- Overview
- MapGuide 2.1 and later APIs
Overview
This document describes the Rendering Service HTTP APIs supported by the MapGuide mapagent. The Rendering Service APIs are used to render a map into a bitmapped image. In addition to bitmap rendering, the APIs support basic updates to the underlying MgMap object state including changes to center, scale, and layer visibility.
MapGuide 2.1 and later APIs
GetDynamicMapOverlayImage
Overview
GetDynamicMapOverlayImage returns a rendered raster image containing all visbile layers at the current center and scale for the map. This API is used in conjuction with the GetVisibleMapExtent HTTP API to provide dynamic map updates for end user interactions.
Parameters
| Name | Value | Required | Supported In Version | Description |
| OPERATION | GETDYNAMICMAPOVERLAYIMAGE | Yes | 1.0.0(+) | Operation to execute |
| VERSION | 1.0.0/2.0.0/2.1.0 | Yes | 1.0.0(+) | Operation version |
| CLIENTAGENT | text | Optional | 1.0.0(+) | Descriptive text for client |
| SESSION | session identifier | Yes | 1.0.0(+) | MapGuide session identifier containing map to display |
| MAPNAME | text | Yes | 1.0.0(+) | Name of the map to display. This corresponds to the GetName() value for the resource identifier. |
| FORMAT | JPG/PNG/PNG8 | Yes | 1.0.0(+) | Image format for rendered image |
| SELECTION | XML selection text | Optional | 1.0.0(+) | XML representing selected features generated from MgSelection.ToXml() |
| KEEPSELECTION | 0/1 | Optional | 1.0.0 only | If true, render selected feature(s) even if they are outside the current scale. |
| BEHAVIOR | bitmask | Yes | 2.0.0(+) | Bitmask representing rendering behavior. See below for more details. |
| SELECTIONCOLOR | RGBA hex color | Yes | 2.0.0(+) | Selection color encoded in hexadecimal RGBA format 0xRRGGBBAA. |
BEHAVIOR Parameter
The behavior parameter specifies how the rendering is performed. The value is encoded as a bitmask to facilitate future enhancements to the API. One or more bits may be combined to determine overall rendering behavior.
| Value | Description |
| 1 (RenderSelection) | Renders the selected feature(s) |
| 2 (RenderLayers) | Renders the features on the map |
| 4 (KeepSelection) | Renders the selected feature(s) even if they are outside the current scale |
Examples:
- BEHAVIOR=3 (RenderSelection|RenderLayers) will render selection and layers within the current scale
- BEHAVIOR=5 (RenderSelection|KeepSelection) will render only the selection regardless of scale
