RASTERMARKERSYMBOL

RASTERMARKERSYMBOL

Used in: CONFIG   REQUEST   RESPONSE
Servers: Image   Feature   ArcMap
Parent elements: EXACT   LINE   OBJECT   OTHER   POINT   POLYGON   RANGE   SIMPLERENDERER

<RASTERMARKERSYMBOL	Attribute Description Table
When using ArcMap Server: image ="path to image file" url ="url string" size ="1,1 - N,N" When using Image or Feature Server: image ="path to image file" url ="url string" antialiasing ="true \| false" [false] hotspot ="0,0 - N,N" [centered] overlap ="true \| false" [true] shadow ="0,0,0 - 255,255,255" size ="1,1 - N,N" transparency ="0.0 - 1.0" [1.0] usecentroid ="true \| false" [true] > No Child Elements </RASTERMARKERSYMBOL >
Bold: Attribute or child element is required.

Description:

Symbolizes point features using the specified raster image.

Restrictions:

Overlap is valid only for Image Services. It is ignored when using Feature Services.
When using an ArcIMS HTML Viewer, ArcIMS Java Viewer, ArcExplorer 4, or any other client using the ArcIMS Servlet Connector, RASTERMARKERSYMBOL is restricted in a SERVICEINFO response. The attribute image is not returned. This restriction can be lifted by setting the property spatialServer.AllowResponsePath to "true" in esrimap_prop. This property file is found in the same directory as the ArcIMS Servlet Connector. For more information on the location of esrimap_prop and its properties, see the ArcIMS Help.

This restriction applies only when the ArcIMS Servlet Connector is used. It does not apply to the ActiveX, ColdFusion, or Java Connectors.
In ArcMap Image Services, symbol is valid only in acetate layers.

Notes:

In the legend of ArcIMS Java Viewers and ArcExplorer 4, the swatch showing a symbol is limited in size. Images greater than approximately 16x16 pixels in size are truncated to fill the swatch. The full image displays on the map. In the ArcIMS HTML Viewer and other HTML implementations, the size of the swatch can be controlled using LEGEND.
Acceptable image formats are JPG and GIF.

Attribute Descriptions for RASTERMARKERSYMBOL:

Attribute	Usage	Back to Top
antialiasing	Used to make edges of labels and symbols smoother. When set to "true", antialiasing is active. Note that the time to generate a map may significantly increase when antialiasing is turned on.
hotspot	Determines where marker symbol is placed in relation to actual x,y location of the point the marker symbol represents. A hotspot of 0,0 places the point at the top left corner of the marker symbol. X,y coordinates are positive and measured in pixels. The default hotspot centers the marker symbol over the point based on its actual size. For example, if a marker symbol is 16x16 pixels, the default location is 8,8. If the size attribute is set to 32x32, the default hotspot center is still 8,8.
image	Full pathname to image. ArcIMS Spatial Server uses this pathname to find the image and add it to the map. UNC pathnames can be used (\\myComputer\arcims\output).
overlap	Determines if labels can overlap this symbol. When "true", labels can overlap. When "false", labels will not overlap the symbol. If labels are not drawing as expected, check if overlap is set to "false" for this symbol or any other symbol in the ArcIMS service.
shadow	Shadow color using RGB values.
size	Resizes marker symbol to new size in pixels. The default size is the actual width and height of the marker symbol. If size="0,0" is specified, the ImageServer writes a warning message to the log file and uses the default size settings.
transparency	Value to set percentage of transparency. 1.0 is 0 percent transparent. 0.0 is 100 percent transparent.
url	URL used by client to retrieve image.
usecentroid	By default, a marker symbol used on polygon layers draws markers at all polygon vertices. If usecentroid is "true", marker is placed in the centroid of the polygon. If multiple polygon parts exist, the marker falls on the part with the biggest area.

Examples for RASTERMARKERSYMBOL:

Example 1: When in CONFIG or REQUEST.

Back to Top

<?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="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
         <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="CITIES" visible="true" id="2">
        <DATASET name="CITIES" type="point" workspace="shp_ws-10" />
        <SIMPLERENDERER>
          <RASTERMARKERSYMBOL shadow="0,0,0" overlap="true" url="http://mymachine.domain.com/website/color.gif" image="C:\ArcIMS\WebSite\color.gif" transparency="1.0" size="16,16" hotspot="1,1" antialiasing="false" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When using usecentroid with a polygon layer.

Back to Top

<?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="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
         <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="CNTRY94" visible="true" id="0">
        <DATASET name="CNTRY94" type="polygon" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SIMPLERENDERER>
            <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="127,227,227" />
          </SIMPLERENDERER>
          <SIMPLERENDERER>
            <RASTERMARKERSYMBOL usecentroid="true" url="http://mymachine.domain.com/website/color.gif" image="C:\ArcIMS\WebSite\color.gif" size="16,16" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: When layer rendering is included in SERVICEINFO and RASTERMARKERSYMBOL is restricted.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <CAPABILITIES forbidden="GET_EXTRACT"/>
        <SCREEN dpi="120"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-141.003005981445" miny="29.9125167103556" maxx="-52.6202812194824" maxy="83.1083221435546" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Cities" id="Cities">
        <FCLASS type="point"> </FCLASS>
        <SIMPLERENDERER>
          <RASTERMARKERSYMBOL url="http://mymachine.domain.com/website/city.gif" overlap="true" />
        </SIMPLERENDERER>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>