SIMPLELABELRENDERER

SIMPLELABELRENDERER

Used in: CONFIG REQUEST RESPONSE
Parent elements: GROUPRENDERER LAYER LAYERDEF LAYERINFO SCALEDEPENDENTRENDERER

<SIMPLELABELRENDERER	Attribute Description Table
*field ="string"* featureweight ="no_weight \| med_weight \| high_weight" [no_weight] howmanylabels ="one_label_per_name \| one_label_per_shape \| one_label_per_part" labelbufferratio ="double" labelpriorities ="0,0,0,0,0,0,0,0 - 8,8,8,8,8,8,8,8 \| LE_PlaceOnTopHorizontal" [2,2,1,4,5,3,2,4] labelweight ="no_weight \| med_weight \| high_weight" [high_ weight] linelabelposition ="PlaceAbove \| PlaceBelow \| PlaceOnTop \| PlaceLeft \| PlaceRight \| PlaceAboveBelow \| PlaceLeftRight \| PlaceInLine \| PlaceParallel \| PlaceOnTopHorizontal" [PlaceAbove] rotationalangles ="string" > <CALLOUTMARKERSYMBOL... /> [Or] <CHARTSYMBOL... /> [Or] <RASTERSHIELDSYMBOL... /> [Or] <SHIELDSYMBOL... /> [Or] <TEXTSYMBOL... /> [Or] </SIMPLELABELRENDERER >
Bold: Attribute or child element is required.

Description:

Used for labeling features. A field is specified for labeling all features of a particular layer.

Restrictions:

Use only one symbol inside a SIMPLELABELRENDERER.
The attribute labelpriorities="LE_PlaceOnTopHorizontal" is limited to Image MapServices.

Notes:

When rotating symbols, the attribute labelpriorities always takes precedence over the attribute rotationalangles. If you find that your labels are not rotating as expected when using Image MapServices, remove the labelpriorities attribute if it is present.
If subfields is used in SPATIALQUERY or QUERY for a layer, any fields used for labeling must be included in the subfields list.
For more information on using renderers, see Using ArcXML Renderers.

Attribute Descriptions for SIMPLELABELRENDERER:

Attribute

Usage

featureweight

Used to prioritize the importance of features. The feature weight determines how important the feature labeled is for the label placement algorithm. If no_weight is specified, then the feature has no importance and can be labeled over. If high_weight is specified, then the feature has high importance and cannot be labeled over. Giving importance to features increases the complexity of the labeling problem and also the processing time.

field

Field containing text for labeling features. 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 3.
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 3.
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 3.

Labels can include data concatenated from two or more fields. Each field name is separated by a space:

Using a shapefile with no joined tables. The short format can be used for field names.
field="CITY STATE_NAME"
Using a shapefile with joined tables. The name of the joined table must be included along with the field names.
field="JOINEDTABLE.CITY JOINEDTABLE.STATE_NAME"
Files with joined fields cannot be read locally in ArcIMS Author or ArcExplorer 3.
Using an ArcSDE layer without joined tables. The short format can be used.
field="CITY STATE_NAME"
The full long name can also be used.
field="ARCSDENAME.TABLE.CITY ARCSDENAME.JOINEDTABLE.STATE_NAME"
Files with full long names cannot be read locally in ArcIMS Author or ArcExplorer 3.
Using an ArcSDE layer with joined tables. The full long format must be used.
field="ARCSDENAME.TABLE.CITY ARCSDENAME.JOINEDTABLE.STATE_NAME"
Files with full long names cannot be read locally in ArcIMS Author or ArcExplorer 3.

howmanylabels

Determines how often a feature is labeled.

One_label_per_part labels all parts of a feature in the case of multipart features. For instance, the State of Hawaii consists of several islands, but they are grouped together as one polygon feature. Each island is labeled.
One_label_per_name labels once per feature name. When several features share the same name, only one label is shown. For example, if there is more than one polygon with the name "Residential", only one "Residential" polygon is labeled.
One_label_per_shape labels once per feature even if there are multiple segments. For example, the group of islands that make up Hawaii are only labeled once. If there are other features with the same name, they are also labeled.

labelbufferratio

Used to set a buffer around the label. When this is set, no labels overlap within the buffer range. The ratio is the fraction of the height or the width of the label rectangle (whichever is smaller) compared to the width of the buffer. A ratio of 0.0 means no buffer. A ratio of 1.0 means that the buffer is twice the size of the label (the label width equals the buffer width). A negative ratio causes the buffer to be smaller than the label. This can be used to allow labels to overlap.

labelpriorities

Used to determine where to place the label around the point. The attribute accepts different weights for each of eight positions around the point. Each position corresponds to the positions as shown below:

1	2	3
8	X	4
7	6	5

In each position, the user can prioritize the importance of that position from 0 upwards. 0 signifies that the label should not be placed in that position. 1 means that this is an acceptable position for the label, and all higher numbers represent lesser priorities for that position. For example, "1,0,1,0,0,0,0,0" means that only the first and third label positions will be taken into account when labeling. In another example, "1,2,3,0,1,0,0,0" means try to label at the first and fifth position; if not, then put the label at the second position; if not, then put it at the third position; if this is not possible, then don't label it.

<SIMPLELABELRENDERER field="NAME" labelpriorities="1,2,3,0,1,0,0,0">

Another option is to place a label on top of points rather than around points. To do this, use "LE_PlaceOnTopHorizontal" for the label priority.

<SIMPLELABELRENDERER field="NAME" labelpriorities="LE_PlaceOnTopHorizontal">

labelweight

Used to prioritize the importance of labels. The label weight is usually set to high_weight since the labels are more important. This can be set lower if the labels are not as important as the feature.

linelabelposition

Determines where on the line to place the label. The following options are available:

PlaceAbove - Place above the line.
PlaceBelow - Place below the line.
PlaceOnTop - Place on the line.
PlaceLeft - Place at the left side of the line.
PlaceRight - Place at the right side of the line.
PlaceAboveBelow - Place above or below the line.
PlaceLeftRight - Place at either side of the line.
PlaceInLine - Place anywhere on the line.
PlaceParallel - Place parallel to the line.
PlaceOnTopHorizontal - Place label on top of the line but always horizontal.

rotationalangles

The rotational angles are possible angles that the label can be placed at, relative to the labeled point. By default, labels are always placed horizontally. To rotate a label, a comma-delimited list of up to eight rotational angles can be given and are prioritized from first to last. For example, if the first priority is to place labels at 45 degrees and the second priority is at 30 degrees, the rotational angles attribute would look like this:

<SIMPLELABELRENDERER field="NAME" rotationalangles="45,30">

Labelpriorities always take precedence over rotationalangles. If you find that your labels are not rotating as expected, remove the labelpriorities attribute if it is present. Alternatively, you can set all the labelpriorities to "0".

<SIMPLELABELRENDERER field="NAME" rotationalangles="45,30" >
or
<SIMPLELABELRENDERER field="NAME" labelpriorities="0,0,0,0,0,0,0,0" rotationalangles="45,30" >

Examples for SIMPLELABELRENDERER:

Example 1: When using a point 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="cities" visible="true" id="2">
        <DATASET name="cities" type="point" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SIMPLELABELRENDERER field="NAME" labelpriorities="0,0,1,2,2,0,0,0">
            <TEXTSYMBOL font="Arial" fontstyle="regular" fontsize="10" />
          </SIMPLELABELRENDERER>
          <SIMPLERENDERER>
            <SIMPLEMARKERSYMBOL color="255,0,255" width="8" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When using a line 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="-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="ROADS" visible="true" id="2">
        <DATASET name="ROADS" type="line" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SIMPLELABELRENDERER field="ROUTE" linelabelposition="placeontop" howmanylabels="one_label_per_shape">
            <TEXTSYMBOL antialiasing="true" font="Arial" fontstyle="regular" fontsize="10" />
          </SIMPLELABELRENDERER>
          <SIMPLERENDERER>
            <SIMPLELINESYMBOL type="solid" width="1" color="127,27,127" />
          </SIMPLERENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: When using 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 filltype="solid" fillcolor="113,169,249" />
          </SIMPLERENDERER>
          <SIMPLELABELRENDERER field="NAME" howmanylabels="one_label_per_part">
            <TEXTSYMBOL antialiasing="true" font="Comic Sans MS" fontsize="10" />
          </SIMPLELABELRENDERER>
        </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>