RASTERSHIELDSYMBOL

RASTERSHIELDSYMBOL

Used in: CONFIG   REQUEST   RESPONSE
Servers: Image   Feature
Parent elements: EXACT   OTHER   RANGE   SIMPLELABELRENDERER

<RASTERSHIELDSYMBOL	Attribute Description Table
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" textposition ="0,0 - N,N" transparency ="0.0 - 1.0" [1.0] > No Child Elements </RASTERSHIELDSYMBOL >
Bold: 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.
Boundary attribute valid only with Feature Services.
When using an ArcIMS HTML Viewer, ArcIMS Java Viewer, ArcExplorer 4, or any other browser using the ArcIMS Servlet Connector, RASTERFILLSYMBOL 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 servlet engine directory. 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.
Not valid with ArcMap Server.

Notes:

Acceptable image formats are JPG and GIF.
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	Back to Top
antialiasing	1 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.
boundary	2 Draws a boundary around feature. Only valid with Feature Services.
font	3 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	4 Font color using RGB values.
fontsize	5 Font size.
fontstyle	6 Font style.
image	7 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).
labelmode	8 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	9 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	10 Shadow color using RGB values.
textposition	11 Determines where text is placed in relation to shield image. The coordinate 0,0 is in the top 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.
transparency	12 Value to set percentage of transparency. 1.0 is 0 percent transparent. 0.0 is 100 percent transparent.
url	13 URL used by client to retrieve image.

Examples for RASTERSHIELDSYMBOL:

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

Back to Top

Example 2: When in a VALUEMAPLABELRENDERER 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="-178.215027" miny="18.924782" maxx="-66.969849" maxy="71.406647" name="Initial_Extent" />
         <MAPUNITS units="decimal_degrees" />
      </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.

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=";"/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <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>