RASTERSHIELDSYMBOL

Used in

Servers

Image Feature

Parent elements

Syntax

<RASTERSHIELDSYMBOL	Attribute Description Table
When using Feature Server: (r)url="url string" antialiasing="true \| false" [false] boundary="true \| false" [false] font="Any system font" [Arial] fontcolor="0,0,0 - 255,255,255" [0,0,0] fontsize="1 - NNN" [12] fontstyle="regular \| bold \| italic \| underline \| outline \| bolditalic" [regular] image="path to image file" labelmode="full \| numericonly" [numericonly] printmode="titlecaps \| allupper \| alllower \| none" [none] shadow="0,0,0 - 255,255,255" transparency="0.0 - 1.0" [1.0] When using Image Server: (r)image="path to image file" antialiasing="true \| false" [false] font="Any system font" [Arial] fontcolor="0,0,0 - 255,255,255" [0,0,0] fontsize="1 - NNN" [12] fontstyle="regular \| bold \| italic \| underline \| outline \| bolditalic" [regular] labelmode="full \| numericonly" [numericonly] printmode="titlecaps \| allupper \| alllower \| none" [none] shadow="0,0,0 - 255,255,255" textposition="0,0 - N,N" transparency="0.0 - 1.0" [1.0] url="url string" > No Child Elements </RASTERSHIELDSYMBOL >
(r): Attribute or child element is required.

Description

A raster shield is a user-specified image and is used as a custom shield to identify roads (or other line features). The text associated with the image comes from a specified field and is placed on top of the image.

Restrictions

Works only with line features.
The attribute textposition is valid only with Image Services. Text will always be centered in Feature Services and when looking at a map configuration file locally in Author or ArcExplorer-Java Edition.
When using an ArcIMS HTML Viewer, ArcIMS Java Viewer, ArcExplorer-Java Edition, or any other client using the ArcIMS Servlet Connector, RASTERSHIELDSYMBOL 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 ArcIMS Help.

This restriction applies only when the ArcIMS Servlet Connector is used. It does not apply when any other connector, the Web ADF for the Microsoft .NET Framework, or the Web ADF for the Java Platform is used.

Notes

Acceptable image formats are JPG, GIF, and PNG.
The field for text is specified in the associated label renderer element.
The image needs to be wide enough to support any long text. The image will not automatically resize to accommodate long strings.
This element is not available from the ArcIMS Author interface.

Attribute Descriptions for RASTERSHIELDSYMBOL

Attribute	Usage
boundary	Draws a boundary around feature. Valid only with Feature Services.
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.
font	Font name. The name is case sensitive. If font name uses "&", use "&" instead. For example, ESRI Transportation & Civic should be written as ESRI Transportation & Civic. For Feature Services, the font must reside on the client machine or else the system default font is used.
fontcolor	Font color using RGB values.
fontsize	Font size.
fontstyle	Font style.
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). Required for Image Services and ignored by Feature Services.
labelmode	Determines what value is drawn on raster shield. If "full" is used, the entire field value, such as I-80, is displayed. If "numericonly" is used, only numbers within the field are displayed. For example, I-80 is displayed as 80.
printmode	Determines how labels are printed. If "none" is used, no change is made to the label: Welcome to ArcIMS. If "alllower" is used, all letters are lowercase: welcome to arcims. If "allupper" is used, all letters are uppercase: WELCOME TO ARCIMS. If "titlecaps" is used, the first letter of each word in a label is uppercase and everything else is lowercase: Welcome To Arcims.
shadow	Shadow color using RGB values.
textposition	Determines where text is placed in relation to shield image. The coordinate 0,0 is in the bottom left corner, and x and y are positive and measured in pixels. If attribute is not used, then text is placed in center of shield image. Valid only with Image Services.
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. Required for Feature Services, and ignored by Image Services.

Examples for RASTERSHIELDSYMBOL

Example 1: When in a SIMPLELABELRENDERER in CONFIG or REQUEST.

Example 2: When in a VALUEMAPLABELRENDERER in CONFIG or REQUEST.

<?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="-178.215027" miny="18.924782" maxx="-66.969849" maxy="71.406647" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </PROPERTIES>
      <WORKSPACES>
         <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="ROADS2" visible="true" id="100">
        <DATASET name="ROADS" type="line" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <VALUEMAPLABELRENDERER lookupfield="ADMN_CLASS" labelfield="ROUTE" linelabelposition="placeabove">
          <EXACT value="State Highway" label="State Highway">
            <RASTERSHIELDSYMBOL font="Arial" fontstyle="bold" fontsize="16" fontcolor="255,255,255" labelmode="numericonly" url="http://mycomputer.domain.com/website/state.gif" image="c:\arcims\website\state.gif" />
          </EXACT>
          <EXACT value="US Highway" label="US Highway">
            <RASTERSHIELDSYMBOL font="Arial" fontstyle="bold" fontsize="16" fontcolor="0,0,0" labelmode="numericonly" url="http://mycomputer.domain.com/website/us.gif" image="c:\arcims\website\us.gif" />
          </EXACT>
          <EXACT value="Interstate" label="Interstate">
            <RASTERSHIELDSYMBOL font="Arial" fontstyle="bold" fontsize="16" fontcolor="255,255,255" labelmode="numericonly" url="http://mycomputer.domain.com/website/interstate.gif" image="c:\arcims\website\interstate.gif" />
          </EXACT>
          <OTHER>
            <RASTERSHIELDSYMBOL transparency="1.0" font="Arial" fontstyle="bolditalic" fontsize="16" fontcolor="255,255,255" shadow="125,125,125" url="http://mycomputer.domain.com/website/other.gif" image="c:\arcims\website\other.gif" />
          </OTHER>
          </VALUEMAPLABELRENDERER>
          <SIMPLERENDERER>
            <SIMPLELINESYMBOL type="solid" width="1" captype="round" jointype="round" color="33,44,27" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

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

<?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" disabledtypes=""/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <FEATURECOORDSYS id="4326"/>
        <FILTERCOORDSYS id="4326"/>
        <ENVELOPE minx="-141.003005981445" miny="41.9133186340332" maxx="-52.6202812194824" maxy="83.1083221435546" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="province" id="0">
        <FCLASS type="polygon"> </FCLASS>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="227,227,27" />
        </SIMPLERENDERER>
      </LAYERINFO>
      <LAYERINFO type="featureclass" visible="true" name="ROADS" id="1">
        <FCLASS type="line"> </FCLASS>
        <GROUPRENDERER>
          <SIMPLELABELRENDERER field="ROUTE">
            <RASTERSHIELDSYMBOL url="http://mycomputer.domain.com/website/shield.gif" />
          </SIMPLELABELRENDERER>
          <SIMPLERENDERER>
            <SIMPLELINESYMBOL color="255,0,0" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>