OBJECT

Used in

CONFIG  REQUEST  RESPONSE  

Servers

Image  

Parent elements

LAYER  LAYERINFO 

Syntax

<OBJECTAttribute Description Table
     (r)units="database | pixel"
     alignment="bottom_left | bottom_right | center | center_left | center_right | bottom_center | top_left | top_right | top_center" [bottom_left]
     lower="string" [1:1]
     upper="string" [1:infinity]
>


     For lines, option 1 using LINE:
     (r)<LINE... />
     <COORDSYS... />

     For lines, option 2 using POLYLINE and one symbol:
     (r)<POLYLINE... />
     (r)<HASHLINESYMBOL... /> [Or]
     (r)<RASTERMARKERSYMBOL... /> [Or]
     (r)<SIMPLELINESYMBOL... /> [Or]
     (r)<SIMPLEMARKERSYMBOL... /> [Or]
     (r)<TRUETYPEMARKERSYMBOL... /> [Or]
     <COORDSYS... />

     For points, option 1 using POINT:
     (r)<POINT... />
     <COORDSYS... />

     For points, option 2 using MULTIPOINT and one symbol:
     (r)<MULTIPOINT... />
     (r)<RASTERMARKERSYMBOL... /> [Or]
     (r)<SIMPLEMARKERSYMBOL... /> [Or]
     (r)<TRUETYPEMARKERSYMBOL... /> [Or]
     <COORDSYS... />

     For polygons, option 1 using POLYGON. RING and HOLE are not permitted:
     (r)<POLYGON... />
     <COORDSYS... />

     For polygons, option 2 using POLYGON and one symbol. RING and HOLE are permitted:
     (r)<POLYGON... />
     (r)<GRADIENTFILLSYMBOL... /> [Or]
     (r)<HASHLINESYMBOL... /> [Or]
     (r)<RASTERFILLSYMBOL... /> [Or]
     (r)<RASTERMARKERSYMBOL... /> [Or]
     (r)<SIMPLELINESYMBOL... /> [Or]
     (r)<SIMPLEMARKERSYMBOL... /> [Or]
     (r)<SIMPLEPOLYGONSYMBOL... /> [Or]
     (r)<TRUETYPEMARKERSYMBOL... /> [Or]
     <COORDSYS... />

     Other OBJECT child elements with Image Services:
     (r)<NORTHARROW... /> [Or]
     (r)<SCALEBAR... /> [Or]
     (r)<TEXT... /> [Or]
     <COORDSYS... />

</OBJECT >
(r): Attribute or child element is required.

Description

Defines an object to be placed on an acetate layer.

Restrictions


Notes


Attribute Descriptions for OBJECT

AttributeUsage
alignment When an acetate object is placed on a map, the origin point 0,0 is in the bottom left corner of the image by default. When using SEPARATELAYER, the desired point of origin is often the center of the image. This attribute allows you to determine the 0,0 origin point in relation to the output image.

Valid only when units="pixel". The following child elements can be aligned: SCALEBAR, NORTHARROW, TEXTMARKERSYMBOL, RASTERMARKERSYMBOL, and TRUETYPEMARKERSYMBOL.
lowerMinimum scale to display an object using a relative scale such as 1:24000. Scale can also be calculated as the number of map units per pixel.
unitsDetermines 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 COORDSYS should be used.

        <OBJECT...>
          <COORDSYS.../>
          ...
        </OBJECT>

  • 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.
upperMaximum scale to display an object using a relative scale such as 1:24000. Scale can also be calculated as the number of map units per pixel.
Back to top 

Examples for OBJECT

Example 1: When in CONFIG.
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-141.003006" miny="41.913319" maxx="-52.620281" maxy="83.108322" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FEATURECOORDSYS id="4326" />
        <FILTERCOORDSYS id="4326" />
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-16" directory="<path to CANADA ESRIDATA>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="province" visible="true" id="0">
        <DATASET name="province" type="polygon" workspace="shp_ws-16" />
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="227,127,227" filltype="solid" />
        </SIMPLERENDERER>
      </LAYER>
      <LAYER type="acetate" name="Selectedmark" id="acetate">
        <OBJECT units="pixel">
          <NORTHARROW type="4" size="15" coords="20 30" shadow="32,32,32" angle="0" antialiasing="true" overlap="false"/>
        </OBJECT>
      </LAYER>  
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When in a GET_IMAGE request.
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
      <IMAGESIZE width="643" height="502" />
      </PROPERTIES>
      <LAYER type="acetate" name="acetate" id="acetate">
      <OBJECT units="pixel">
          <TEXT coords="100 100" label="You are here">
            <TEXTMARKERSYMBOL font="Arial" />
        </TEXT>
      </OBJECT>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 3: When using POINT for one acetate layer and MULTIPOINT for a second acetate layer.
<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600" />
      </PROPERTIES>
      <LAYER type="acetate" name="acetate" id="acetate">
        <OBJECT units="pixel">
          <POINT coords="100 100" >
            <SIMPLEMARKERSYMBOL color="0,0,0" width="20" />
          </POINT>
        </OBJECT>
      </LAYER>
      <LAYER type="acetate" name="acetate" id="acetate">
        <OBJECT units="database">
          <SIMPLEMARKERSYMBOL color="0,0,0" width="20" />
          <MULTIPOINT>
             <POINT x="-120.1079549837513" y="40.99815142335011" />
             <POINT x="-110.99468788980437" y="30.88488432940315" />
             <POINT x="10.13210788980437" y="30.82488950980315" />
          </MULTIPOINT>
        </OBJECT>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 4: When using POLYLINE for one acetate layer and LINE for a second acetate layer.
<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600" />
      </PROPERTIES>
      <LAYER type="acetate" name="Selectedmark" id="acetate">
        <OBJECT units="database">
          <SIMPLELINESYMBOL color="0,0,0" width="6" />
          <POLYLINE>
            <PATH>
              <POINT x="-2.1079549837513" y="19.99815142335011" />
              <POINT x="28.99468788980437" y="15.88488432940315" />
              <POINT x="55.99468788980437" y="35.88488432940315" />
            </PATH>
          </POLYLINE>
        </OBJECT>  
      </LAYER>  
      <LAYER type="acetate" name="Selectedmark" id="acetate1">
        <OBJECT units="pixel">
          <LINE coords="0 0;400 0;400 13;0 13">
            <SIMPLELINESYMBOL color="0,255,0" width="6" />
          </LINE>
        </OBJECT>  
      </LAYER>  
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 5: When using POLYGON (Option 1) for one acetate layer and POLYGON, RING, and HOLE (Option 2) for a second acetate layer.
<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600" />
      </PROPERTIES>
      <LAYER type="acetate" name="acetate" id="acetate">
        <OBJECT units="pixel">
          <POLYGON coords="10 10;400 10;400 20;10 20;10 10">
            <SIMPLEPOLYGONSYMBOL fillcolor="255,255,0" />
          </POLYGON>
        </OBJECT>
      </LAYER>
      <LAYER type="acetate" name="acetate1" id="acetate1">
        <OBJECT units="database">
          <SIMPLEPOLYGONSYMBOL fillcolor="0,255,0" />
          <POLYGON>
            <RING>
              <POINT x="83.15605550814075" y="38.07185101549165" />
              <POINT x="111.09942196116728" y="-4.70645066589869" />
              <POINT x="155.1079549837513" y="-10.38915084069517" />
              <POINT x="139.1079549837513" y="66.38915084069517" />
              <POINT x="83.15605550814075" y="38.07185101549165" />
              <HOLE>
                <POINT x="100.15605550814075" y="20.07185101549165" />
                <POINT x="103.09942196116728" y="30.70645066589869" />
                <POINT x="106.1079549837513" y="30.38915084069517" />
                <POINT x="100.15605550814075" y="20.07185101549165" />
              </HOLE>
            </RING>
          </POLYGON>
        </OBJECT>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Back to top