IMAGESIZE

Used in

Servers

Image Extract

Parent elements

Syntax

<IMAGESIZE	Attribute Description Table
When parent element is GET_EXTRACT: (r)height="1 - NNN" (r)width="1 - NNN" When parent element is GET_IMAGE: (r)height="1 - NNN" (r)width="1 - NNN" dpi="1 - NNN" printheight="1 - NNN" [Same as height] printwidth="1 - NNN" [Same as width] scalesymbols="true \| false" [false] > No Child Elements </IMAGESIZE >
(r): Attribute or child element is required.

Description

When used with GET_IMAGE, defines width and height of output map. When used with GET_EXTRACT, defines which layers should be extracted if scale dependencies are present.

Restrictions

Used only with Image and Extract Servers.

Notes

In a GET_EXTRACT request, IMAGESIZE is used to calculate which layers should be extracted based on any scale dependencies. If a layer is out of range based on the scale, it will not be extracted.
The image output map size can be determined three different ways:
- By using height and width alone.
- By using printwidth and printheight along with height and width.
- By using width, height, and dpi.
The first method is the default, but this method does not take scale dependencies into consideration. If the size of the image changes, but the envelope remains the same, the scale of the map changes. The result is that data content and layer rendering may change as the width and height increase or decrease. To avoid changing the scale as a map is increased or decreased in size, the second two options do take scale dependencies into consideration. Both options produce the same results, but the method for calculating the new map differs. In the second option, calculations are made using pixels. In the third option, calculations are made using dots per inch (dpi). A more thorough explanation of using these attributes is in the IMAGESIZE section of Using GET_IMAGE and IMAGE with Image Services.

Attribute Descriptions for IMAGESIZE

When parent element is GET_EXTRACT:

Attribute	Usage
height	Image height in pixels.
width	Image width in pixels.

When parent element is GET_IMAGE:

Attribute	Usage
dpi	Dots per inch (dpi).
height	Image height in pixels.
printheight	Height of the output image in pixels.
printwidth	Width of the output image in pixels.
scalesymbols	Determines whether to increase or decrease symbology in relative proportion to a map image as the image increases or decreases in size.
width	Image width in pixels.

Examples for IMAGESIZE

Example 1: When in a GET_IMAGE request using printwidth and printheight.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
<REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <IMAGESIZE height="640" width="480" printheight="800" printwidth="600" />
    </PROPERTIES>
  </GET_IMAGE>
</REQUEST>
</ARCXML>

Example 2: When in a GET_IMAGE request using dpi.

<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-73.985" miny="40.756" maxx="-73.972" maxy="40.765" />
        <IMAGESIZE width="350" height="245" dpi="134" scalesymbols="true" />
      </PROPERTIES>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>