Used in
REQUEST Servers
Image Extract ArcMap Parent elements
PROPERTIES 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 when using ArcMap Server: (r)height="1 - NNN" (r)width="1 - NNN" dpi="1 - NNN"
When parent element is GET_IMAGE when using Image Server: (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]
When parent element is GET_LAYOUT when using ArcMap Server: dpi="1 - NNN" [96] height="1 - NNN" width="1 - NNN" >
No Child Elements </IMAGESIZE >
|
(r): Attribute or child element is required.
|
Description
When used with
GET_IMAGE or
GET_LAYOUT, defines width and height of output map. When used with
GET_EXTRACT, defines which layers should be extracted if scale dependencies are present.
Restrictions
- When using GET_LAYOUT with ArcMap Image Services, the attribute dpi is ignored when using the following formats: GIF, JPG, BMP, PNG24, and PNG8. The image size is based on the values of height and width. If height and width are not specified, the image size is calculated based on a dpi of 96.
When the output type is AI, EMF, EPS, PDF, or SVG, dpi takes precedence over height and width, and the height and width are ignored.
- Used only with Image, Extract, and ArcMap 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. (Image Services only)
- By using width, height, and dpi. (Image and ArcMap Image Services)
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 or Using GET_IMAGE and IMAGE with ArcMap Image Services . - When using GET_LAYOUT with ArcMap Image Services, height and width are resized automatically to keep the proper page ratio for the layout. This applies only to the following formats: GIF, JPG, BMP, PNG24, and PNG8. The actual size is returned as the height and width in OUTPUT.
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 when using ArcMap Server:Attribute | Usage |
---|
dpi | Dots per inch (dpi). |
height | Image height in pixels. |
width | Image width in pixels. |
When parent element is GET_IMAGE when using Image Server: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. |
When parent element is GET_LAYOUT when using ArcMap Server:Attribute | Usage |
---|
dpi | Dots per inch (dpi). |
height | Layout height in pixels. |
width | Layout width in pixels. |
Back to top 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> |
Back to top