Changes between Version 7 and Version 8 of HttpApi/RenderingService


Ignore:
Timestamp:
04/16/10 11:04:50 (15 years ago)
Author:
trevorwekel
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • HttpApi/RenderingService

    v7 v8  
    1515This 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.
    1616
    17 = !MapGuide 2.1 and later APIs =
     17= !MapGuide 2.0 and later APIs =
    1818== !GetDynamicMapOverlayImage ==
    1919=== Overview ===
    2020!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.
    2121=== Parameters ===
    22 || '''Name''' || '''Value'''  || '''Required''' || '''Supported[[BR]]In Version''' || '''Description''' ||
    23 || OPERATION || GETDYNAMICMAPOVERLAYIMAGE || Yes || 1.0.0(+) || Operation to execute ||
    24 || VERSION || 1.0.0/2.0.0/2.1.0 || Yes || 1.0.0(+) || Operation version ||
    25 || CLIENTAGENT || text || Optional || 1.0.0(+) || Descriptive text for client ||
    26 || SESSION || session identifier || Yes || 1.0.0(+) || !MapGuide session identifier containing map to display ||
    27 || MAPNAME || text || Yes || 1.0.0(+) || Name of the map to display.[[BR]]This corresponds to the !GetName() value for the resource identifier. ||
    28 || FORMAT || JPG/PNG/PNG8 || Yes || 1.0.0(+) || Image format for rendered image ||
    29 || SELECTION || XML selection text || Optional || 1.0.0(+) || XML representing selected features generated from !MgSelection.!ToXml() ||
    30 || KEEPSELECTION || 0/1 || Optional || 1.0.0 only || If true, render selected feature(s) even if they are outside the current scale. ||
    31 || BEHAVIOR || bitmask || Yes || 2.0.0(+) || Bitmask representing rendering behavior.  See below for more details.||
    32 || SELECTIONCOLOR || RGBA hex color || Yes || 2.0.0(+)|| Selection color encoded in hexadecimal RGBA format 0xRRGGBBAA. ||
     22|| '''Name''' || '''Value'''  || '''Required''' || '''Description''' ||
     23|| OPERATION || GETDYNAMICMAPOVERLAYIMAGE || Yes || Operation to execute ||
     24|| VERSION || 2.0.0/2.1.0 || Yes || Operation version ||
     25|| CLIENTAGENT || text || Optional || Descriptive text for client ||
     26|| SESSION || session identifier || Yes || !MapGuide session identifier containing map to display ||
     27|| MAPNAME || text || Yes || Name of the map to display.[[BR]]This corresponds to the !GetName() value for the resource identifier. ||
     28|| FORMAT || JPG/PNG/PNG8 || Yes || Image format for rendered image ||
     29|| SELECTION || XML selection text || Optional || XML representing selected features generated from !MgSelection.!ToXml() ||
     30|| BEHAVIOR || bitmask || Yes || Bitmask representing rendering behavior.  See below for more details.||
     31|| SELECTIONCOLOR || RGBA hex color || Yes || Selection color encoded in hexadecimal RGBA format 0xRRGGBBAA. ||
    3332
    3433==== BEHAVIOR Parameter ====
     
    6766=== Usage ===
    6867=== Technical Notes ===
     68= !MapGuide 1.0 and later APIs =
     69== !GetDynamicMapOverlayImage ==
     70=== Overview ===
     71!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.
     72=== Parameters ===
     73|| '''Name''' || '''Value'''  || '''Required''' || '''Description''' ||
     74|| OPERATION || GETDYNAMICMAPOVERLAYIMAGE || Yes || Operation to execute ||
     75|| VERSION || 1.0.0 || Yes || Operation version ||
     76|| CLIENTAGENT || text || Optional || Descriptive text for client ||
     77|| SESSION || session identifier || Yes || !MapGuide session identifier containing map to display ||
     78|| MAPNAME || text || Yes || Name of the map to display.[[BR]]This corresponds to the !GetName() value for the resource identifier. ||
     79|| FORMAT || JPG/PNG/PNG8 || Yes || Image format for rendered image ||
     80|| SELECTION || XML selection text || Optional || XML representing selected features generated from !MgSelection.!ToXml() ||
     81|| KEEPSELECTION || 0/1 || Optional || If true, render selected feature(s) even if they are outside the current scale. ||
     82|| SELECTIONCOLOR || RGBA hex color || Yes || Selection color encoded in hexadecimal RGBA format 0xRRGGBBAA. ||
     83
     84==== SELECTION Parameter ====
     85
     86The selection parameter...
     87Examples:
     88 * example 1
     89 * example 2
     90=== Usage ===
     91=== Technical Notes ===