Description:

Defines an object to be placed on an acetate layer.

Restrictions:

• When drawing lines, point, or polygons on an acetate layer, either Option 1 or Option 2 can be used, but not both. If Option 2 is selected, one symbol is also required. NORTHARROW, SCALEBAR, and TEXT have only one option for specifying a location.
• Acetate layers can only be used with Image and ArcMap Image Services in HTML Viewers.
• 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.

Notes:

• In acetate layers, two options are available for defining the location of a point, line, or polygon. In Option 1 for points, POINT includes the geometry, and one symbol element must be included as a child element of POINT. In Option 2, MULTIPOINT includes the geometry. The symbol is included as a child element of OBJECT.
  
  

  Option 1 for Points	Option 2 for Points
  <OBJECT units="pixel">   <POINT coords="0 0">     <SYMBOL>   <POINT> </OBJECT>	<OBJECT units="pixel" >   <SYMBOL>   <MULTIPOINT>     <POINT x="0" y="0" />   </MULTIPOINT> </OBJECT>

  
  
  In Option 1 for lines, LINE includes the geometry, and one symbol element must be included as a child element of LINE. In Option 2, POLYLINE, PATH, and either POINT or COORDS include the geometry. The symbol is included as a child element of OBJECT. Note that with Option 2, multiple PATHs can be included within one POLYLINE.
  
  

  Option 1 for Lines	Option 2 for Lines
  <OBJECT units="pixel">   <LINE coords="0 0;400 0;400 13;0 13">     <SYMBOL />   </LINE> </OBJECT>	<OBJECT units="database">   <SYMBOL />   <POLYLINE>     <PATH>       <COORDS>0 0;400 0;400 13;0 13</COORDS>     </PATH>   </POLYLINE> </OBJECT>

  
  
  In Option 1 for polygons, POLYGON includes the geometry, and one symbol element must be included as a child element of POLYGON. In Option 2, POLYGON, RING, HOLE, and either POINT or COORDS include the geometry. The symbol is included as a child element of OBJECT. Note that with Option 2, multiple RINGS and HOLEs can be included within one POLGYON.
  
  

  Option 1 for Polygons	Option 2 for Polygons
  <OBJECT units="pixel">   <POLYGON coords="10 10;400 10;400 20;10 20;10 10">     <SYMBOL />   </POLYGON> </OBJECT>	<OBJECT units="database">   <SYMBOL />   <POLYGON>     <RING>       <POINT x="83.15" y="38.07" />       <POINT x="111.09" y="-4.70" />       <POINT x="155.10" y="-10.38" />       <POINT x="139.10" y="66.38" />       <POINT x="83.15" y="38.07" />       <HOLE>         <COORDS>100.15 20.07;103.09 30.70;106.10 30.38;100.15 20.07</COORDS>       </HOLE>     </RING>   </POLYGON> </OBJECT>

  
  
  
• In order to project an acetate layer, COORDSYS must be included as a child element of OBJECT. COORDSYS is valid only when OBJECT units="database". The COORDSYS id should specify the current coordinate system of the x,y coordinates listed within the OBJECT.
• Scales can be set in ArcXML using a relative scale or by calculating the number of map units per pixel. A relative scale represents the scale in a ratio such as 1:24000. In this example, 1 meter equals 24000 meters, or 1 inch equals 24000 inches. When using relative scale, always use a colon (:) between the two values.
  
  Map units per pixel refers to the number of meters, feet, or decimal degrees represented by one pixel in a map. To convert from a relative scale to map units per pixel, the size of a pixel must first be calculated. The formula for finding the number of meters in a pixel is 0.0254 / dpi. The value 0.0254 is the number of meters in an inch, and dpi is the dpi set in the ArcIMS service or request. If no dpi is set in the service or request, the dpi is assumed to be 96. As an example of pixel size, if the dpi is 96, the pixel size is 0.0254 / 96 or 0.000265 m. To convert from a relative scale to map units per pixel:
  1. If the scale is in meters. To calculate the number of meters per pixel, take the relative scale and multiply by 0.000265. For example, if the relative scale is 1:24000, then the number of meters per pixel is 24000 * 0.000265, or 6.36 meters.
  2. If the scale is in feet. Do the calculation for meters (#1). Multiply the result by 3.28 (the number of feet in a meter). For example, if the number of meters per pixel is 6.36, the number of feet is 6.36 * 3.28, or 20.86 feet.
  3. If the scale is in decimal degrees. For these calculations, the earth is assumed to be an exact circle with a circumference of 40030.174 km. One degree is 111.195 km (40030.174/360 degrees), or 111195 meters. To calculate the number of degrees, first do the calculation for meters (#1). Next, divide the result by 111195. For example, if the number of meters per pixel is 6.36, the number of degrees is 6.36 / 111195, or 0.0000571968.

Attribute Descriptions for OBJECT:

Examples for OBJECT: