acetateObject

Used in

mapping

Nested in

Syntax

<aims:acetateObject

     Attributes that set values:

     When using ArcMap Server:
     units="database | pixel" [database]

     When using Image Server:
     lower="string" [1:1]
     units="database | pixel" [database]
     upper="string" [1:infinity]
>

     <aims:coordSys... />
     <aims:line... />
     <aims:northArrow... />
     <aims:point... />
     <aims:polygon... />
     <aims:scalebar... />
     <aims:text... />

</aims:acetateObject >

Description

Defines the scale thresholds and units of an object to be placed on an acetate layer.

Restrictions

Acetate layers are designed to show a limited number of graphic features such as a northarrow, scalebar, some text, and one or two points, lines, or polygons. The acetate layer is not designed for displaying large numbers of features. If you add many features to an acetate layer, a noticeable degradation in response time and performance is likely. If too many features are added, the service may stop responding.
The attributes upper and lower are valid only with Image Server.
When an object is projected on an ArcMap Image Service, points and line and polygon vertices will be placed properly when units="database". However, line segments and polygon edges will be straight rather than projected.
When using ArcMap Image Services, any aims:scalebar, aims:northArrow, and aims:text objects are always drawn first before any point, line, or polygon objects.

Attribute Descriptions for acetateObject

Attribute	Usage
units	Determines how coordinates for the object are specified. Coordinates can be specified two ways: Database. Refers to positioning an object using x,y coordinates in the coordinate system of the ArcIMS service or request. For example, if the service is in Robinson, then the coordinates for the object should also be in Robinson. If the coordinates for the object are different from the coordinate system used in the service or request, then aims:coordSys should be used. <aims:acetateObject...> <aims:coordSys.../> ... </aims:acetateObject> Pixel. Refers to positioning an object using x,y coordinates in pixels. The pixels along the left edge of the map frame have an x-coordinate of zero. The pixels along the bottom edge have a y-coordinate of zero. /UL>
lower	Minimum scale to display Acetate Object using a relative scale such as 1:24000. Scale can also be calculated as the number of map units per pixel.
units	Determines how coordinates for the object are specified. Coordinates can be specified two ways: Database. Refers to positioning an object using x,y coordinates in the coordinate system of the ArcIMS service or request. For example, if the service is in Robinson, then the coordinates for the object should also be in Robinson. If the coordinates for the object are different from the coordinate system used in the service or request, then aims:coordSys should be used. <aims:acetateObject...> <aims:coordSys.../> ... </aims:acetateObject> Pixel. Refers to positioning an object using x,y coordinates in pixels. The pixels along the left edge of the map frame have an x-coordinate of zero. The pixels along the bottom edge have a y-coordinate of zero. /UL>
upper	Maximum scale to display Acetate Object using a relative scale such as 1:24000. Scale can also be calculated as the number of map units per pixel.

Examples for acetateObject

Example 1:

<aims:tcpConnection id="myTCPConnection" host="myMachine" port="5300"/>
<aims:mapService id="myMapService" connectionId="<%=myTCPConnection%>" name="serviceName" />

<aims:map id="myMap" serviceId="<%=myMapService%>" width="300" height="200" background="100,140,230" transcolor="0,0,0">
  <aims:createLayer layerId="LayerNorthArrow" name="AcetateLayer" type="acetate" visible="true">
    <aims:acetateObject units="pixel">
      <aims:northArrow x="50" y="50" type="3" shadow="230,230,230" />
    </aims:acetateObject>
    <aims:acetateObject units="pixel">
      <aims:line coords="50 10;250 10" >
        <aims:hashLineSymbol color="0,0,0" lineThickness="3" tickThickness="3" transparency="0.5" interval="16" width="16" type="foreground" antialiasing="false" overlap="true" />
      </aims:line>
    </aims:acetateObject>
  </aims:createLayer>
</aims:map>
<img src="<%=(myMap)%>" />

EDN: ESRI Developer Network