TRUETYPEMARKERSYMBOL

Used in

CONFIG  REQUEST  RESPONSE  

Servers

Image  Feature  ArcMap  

Parent elements

EXACT  LINE  OBJECT  OTHER  POINT  POLYGON  RANGE  SIMPLERENDERER 

Syntax

<TRUETYPEMARKERSYMBOL	Attribute Description Table
When using ArcMap Server:      (r)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:      (r)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" [false] >      No Child Elements </TRUETYPEMARKERSYMBOL >
(r): 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-Java Edition or the ArcIMS Java Viewers support only "mod_arithmetic" for rotatemethod.
• The attribute usecentroid is not valid with acetate layers.
• In ArcMap Image Services, symbol is valid only in acetate layers or when using LAYERDEF.
• 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
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. Performance is generally better if the field name is all upper case. When joined tables or fully qualified ArcSDE names are used for the field name in a map configuration file, this file cannot be read locally in ArcIMS Author or ArcExplorer-Java Edition. For shapefiles with no joined tables, the field can be referenced using the short format. anglefield="AREA" For shapefiles with joined tables, the name of the joined table must be included along with the field. anglefield="JOINEDTABLE.AREA" For ArcSDE layers without joined tables, the field can be referenced using the short format. anglefield="AREA" The fully qualified name can also be used. anglefield="ARCSDENAME.TABLE.AREA" For ArcSDE layers with joined tables, joined fields must be referenced using the fully qualified format. anglefield="ARCSDENAME.TABLE.AREA" 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 65535 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. Attribute not valid with acetate layers.

Back to top 

Examples for TRUETYPEMARKERSYMBOL

<?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" />         <FILTERCOORDSYS id="4326" />         <FEATURECOORDSYS id="4326"/>       </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.

<?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" />         <FILTERCOORDSYS id="4326" />         <FEATURECOORDSYS id="4326"/>       </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.

<?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" />         <FILTERCOORDSYS id="4326" />         <FEATURECOORDSYS id="4326"/>       </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>

Back to top