TRUETYPEMARKERSYMBOL

TRUETYPEMARKERSYMBOL

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

<TRUETYPEMARKERSYMBOL	Attribute Description Table
When using ArcMap Server: character ="32 - 65535" angle ="0.0 - 360.0" [0] 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] outline ="0,0,0 - 255,255,255" When using Image or Feature Server: character ="32 - 65535" angle ="0.0 - 360.0" [0] anglefield ="string" 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] glowing ="0,0,0 - 255,255,255" outline ="0,0,0 - 255,255,255" overlap ="true \| false" [true] rotatemethod ="geographic \| arithmetic \| mod_arithmetic" [mod_arithmetic] shadow ="0,0,0 - 255,255,255" transparency ="0.0 - 1.0" [1.0] usecentroid ="true \| false" [true] > No Child Elements </TRUETYPEMARKERSYMBOL >
Bold: Attribute or child element is required.

Description:

Symbolizes point features using TrueType symbols.

Restrictions:

Overlap is valid only for Image Services. It is ignored when using Feature Services.
Outline and glowing should not be used together; use one or the other.
The attribute rotatemethod values "geographic" and "arithmetic" are valid only with Image Services. Feature Services and the legend in ArcExplorer 4 or the ArcIMS Java Viewers support only "mod_arithmetic" for rotatemethod.
In ArcMap Image Services, TRUETYPEMARKERSYMBOL is valid only in acetate layers.
Limitation using angle and anglefield with Image and Feature Services: When rotating truetype marker symbols in an Image or Feature Service, the marker may not be centered directly on top of the point it represents. The displacement varies depending on the font and character used. Not all characters are affected even within the same font. This issue is not a problem with ArcMap Image Services.

Notes:

TRUETYPEMARKERSYMBOL is not available from the ArcIMS Author interface.
The angle for a symbol can be user-defined with angle. Angles can also be read from a field in a database table using anglefield.
If the attributes angle and anglefield are both present, angle takes precedence, and anglefield is ignored.
If the symbols are rotating in an unexpected direction, double-check the value for rotatemethod.
If you are using custom TrueType symbols on a UNIX machine, the font must be installed in the following directory:
- For Solaris:
  /usr/openwin/lib/X11/fonts/TrueType
- For AIX:
  /usr/lpp/X11/lib/X11/fonts/TrueType
- For Linux:
  /usr/lib/X11/fonts/TrueType
- For HP-UX:
  /usr/lib/X11/fonts/ms.st/typefaces

Attribute Descriptions for TRUETYPEMARKERSYMBOL:

Attribute	Usage	Back to Top
angle	Angle of rotation in degrees.
anglefield	The field in the database that contains the angle of rotation for a TRUETYPEMARKERSYMBOL. The field can be in the layer table or in a joined table. For shapefiles with no joined tables, the field can be referenced using the short format. field="AREA" For shapefiles with joined tables, the name of the joined table must be included along with the field. field="JOINEDTABLE.AREA" Files with joined fields cannot be read locally in ArcIMS Author or ArcExplorer 4. For ArcSDE layers without joined tables, the field can be referenced using the short format. field="AREA" The full long name can also be used, but when a long name is used, the file cannot be read locally in ArcIMS Author or ArcExplorer 4. field="ARCSDENAME.TABLE.AREA" For ArcSDE layers with joined tables, joined fields must be referenced using the full long format. field="ARCSDENAME.TABLE.AREA" Files with joined fields cannot be read locally in ArcIMS Author or ArcExplorer 4. If both angle and anglefield are used, the attribute angle takes precedence.
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.
character	Text character ASCII value. The character must be a value between 32 and 255 in a font's character map; characters 0-31 are nonprintable and cannot be used.
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.
glowing	Glow color around symbol using RGB values.
outline	Outline color using RGB values.
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.
rotatemethod	Three methods of calculating angles are available and apply to both angle and anglefield: "geographic": An angle of 0 is north, and angles are calculated clockwise from north. "arithmetic": An angle of 0 is east, and angles are calculated counterclockwise from east. "mod_arithmetic": An angle of 0 is north, and angles are calculated counterclockwise from north.
shadow	Shadow color using RGB values.
transparency	Value to set percentage of transparency. 1.0 is 0 percent transparent. 0.0 is 100 percent transparent.
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 TRUETYPEMARKERSYMBOL:

Example 1:

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-0" />
        <SIMPLERENDERER>
          <TRUETYPEMARKERSYMBOL transparency="0.5" glowing="0,255,255" shadow="0,0,0" font="ESRI Cartography" fontstyle="bolditalic" character="252" fontcolor="255,255,0" fontsize="16" angle="90" antialiasing="false" overlap="true" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: Using data from anglefield to determine the angle rotation.

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.21502685546875" miny="18.924781799316406" maxx="-66.9698486328125" maxy="71.40664672851562" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="Cities" visible="true" id="1">
        <DATASET name="cities_rotate" type="point" workspace="shp_ws-0" />
        <SIMPLERENDERER>
          <TRUETYPEMARKERSYMBOL transparency="1.0" font="ESRI Cartography" fontstyle="bolditalic" character="252" fontcolor="255,255,0" fontsize="30" anglefield="rotate" rotatemethod="geographic" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: 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="10">
        <DATASET name="CNTRY94" type="polygon" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SIMPLERENDERER>
            <SIMPLEPOLYGONSYMBOL filltransparency="1.0" filltype="solid" fillcolor="0,227,0" />
          </SIMPLERENDERER>
          <SIMPLERENDERER >
            <TRUETYPEMARKERSYMBOL usecentroid="true" transparency="1.0" font="ESRI Cartography" fontstyle="bold" character="252" fontcolor="255,255,0" fontsize="24" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>