| 20 | || '''Name''' || '''Value''' || '''Required''' || '''Supported[[BR]]In Version''' || '''Description''' || |
| 21 | || OPERATION || GETDYNAMICMAPOVERLAYIMAGE || Yes || 1.0.0(+) || Operation to execute || |
| 22 | || VERSION || 1.0.0/2.0.0/2.1.0 || Yes || 1.0.0(+) || Operation version || |
| 23 | || CLIENTAGENT || text || Optional || 1.0.0(+) || Descriptive text for client || |
| 24 | || SESSION || session identifier || Yes || 1.0.0(+) || !MapGuide session identifier containing map to display || |
| 25 | || MAPNAME || text || Yes || 1.0.0(+) || Name of the map to display.[[BR]]This corresponds to the !GetName() value for the resource identifier. || |
| 26 | || FORMAT || JPG/PNG/PNG8 || Yes || 1.0.0(+) || Image format for rendered image || |
| 27 | || SELECTION || XML selection text || Optional || 1.0.0(+) || XML representing selected features generated from !MgSelection.!ToXml() || |
| 28 | || KEEPSELECTION || 0/1 || Optional || 1.0.0 only || If true, render selected feature(s) even if they are outside the current scale. || |
| 29 | || BEHAVIOR || bitmask || Yes || 2.0.0(+) || Bitmask representing rendering behavior. See below for more details.|| |
| 30 | || SELECTIONCOLOR || RGBA hex color || Yes || 2.0.0(+)|| Selection color encoded in hexadecimal RGBA format 0xRRGGBBAA. || |
| 31 | |
| 32 | ===== BEHAVIOR Parameter ===== |
| 33 | |
| 34 | The behavior parameter specifies how the rendering is performed. The value is encoded as a bitmask to facilitate |
| 35 | future enhancements to the API. One or more bits may be combined to determine overall rendering behavior. |
| 36 | |
| 37 | || '''Value''' || '''Description''' || |
| 38 | || 1 (!RenderSelection) || Renders the selected feature(s) || |
| 39 | || 2 (!RenderLayers)|| Renders the features on the map || |
| 40 | || 4 (!KeepSelection) || Renders the selected feature(s) even if they are outside the current scale || |
| 41 | |
| 42 | Examples: |
| 43 | * BEHAVIOR=3 (!RenderSelection|!RenderLayers) will render selection and layers within the current scale |
| 44 | * BEHAVIOR=5 (!RenderSelection|!KeepSelection) will render only the selection regardless of scale |