CHARTSYMBOL

CHARTSYMBOL

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

<CHARTSYMBOL	Attribute Description Table
antialiasing ="true \| false" [false] maxsize ="1 - NNN" maxvalue ="1 - NNN" minsize ="1 - NNN" minvalue ="1 - NNN" mode ="pie \| bar" [pie] outline ="0,0,0 - 255,255,255" [none] shadow ="0,0,0 - 255,255,255" size ="1 - NNN" sizefield ="string" transparency ="0.0 - 1.0" [1.0] > (m) <CHARTVALUE... /> </CHARTSYMBOL >
Bold: Attribute or child element is required. (m): Child element can be used multiple times.

Description:

Although chart symbols draw on the map, no information about the chart symbols is displayed in the legend. ArcIMS 3.1 does not support displaying chart values in the legend.

Restrictions:

The size of a chart can be determined in one of three ways:
1. Using the size attribute.
2. Using the sizefield attribute. This method works only with Image MapServices. It does not work with Feature MapServices.
3. Using the minsize, maxsize, minvalue, and maxvalue attributes.
One of the three options must be used or no charts are drawn. Size ranks first in priority, and it takes precedence over the other attributes even if they are included. Sizefield is second in priority, and it takes precedence over the other attributes if size is not present. Minsize, maxsize, minvalue, and maxvalue rank third in priority and are acknowledged only when size and sizefield are not present.

Notes:

A field listed in CHARTSYMBOL sizefield must also be listed in SIMPLELABELRENDERER field or VALUEMAPLABELRENDERER labelfield.
The attributes minsize and maxsize determine the minimum and maximum size of a chart, respectively. For each feature, the size of the chart is relative to other features based on the minimum and maximum values. These values are set using minvalue and maxvalue.

If a feature has a value less than or equal to minvalue, then the chart is drawn at minsize. If a feature has a value greater than or equal to maxvalue, then the chart is drawn at maxsize. In the following example, the values are based on population. If a feature has a population less than or equal to 10,000, then the size of the chart is 10 pixels. If the feature has a population greater than or equal to 200,000, then the size of the chart is 50 pixels.

<CHARTSYMBOL minsize="10" minvalue="10000" maxsize="50" maxvalue="200000" >

All other features are assigned a chart size between 10 and 50 pixels based on population. A feature with a population of 100,000 will have a chart approximately 30 pixels in size. A feature with a population of 1,000,000 is assigned a chart size of 50 pixels since that is the maximum size allowed using maxsize.
If the size assigned to a chart is very large, the chart may not display. If you find that no charts are displaying, try a smaller chart size.

Attribute Descriptions for CHARTSYMBOL:

Attribute	Usage	Back to Top
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.
maxsize	Maximum size of chart if size or sizefield is not used.
maxvalue	Maximum value that corresponds to the minimum chart size in minsize.
minsize	Minimum size of chart if size or sizefield is not used.
minvalue	Minimum value that corresponds to the minimum chart size in minsize.
mode	Type of chart: pie or bar.
outline	Outline color of charts using RGB values.
shadow	Shadow color using RGB values.
size	Size of charts. All charts are the same size.
sizefield	The field in the database containing the size of the chart. 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. Works only with Image MapServices. Does not work with Feature MapServices.
transparency	Value to set percentage of transparency. 1.0 is 0 percent transparent. 0.0 is 100 percent transparent.

Examples for CHARTSYMBOL:

Example 1: Using minsize, minvalue, maxsize, and maxvalue attributes.

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="-127.87777503188939" miny="30.378245451392196" maxx="-101.1629831289576" maxy="48.55733555119212" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
    </PROPERTIES>
    <WORKSPACES>
      <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
    </WORKSPACES>
    <LAYER type="featureclass" name="States" visible="true" id="0">
      <DATASET name="states" type="polygon" workspace="shp_ws-0" />
        <GROUPRENDERER>
          <SIMPLERENDERER>
            <SIMPLEPOLYGONSYMBOL fillcolor="127,127,27" />
          </SIMPLERENDERER>
          <SIMPLELABELRENDERER field="POP1999 POP1990">
            <CHARTSYMBOL minsize="10" minvalue="1000000" maxsize="50" maxvalue="7000000" outline="255,255,255" shadow="0,0,0" transparency="1.0" >
              <CHARTVALUE lookupfield="POP1990" color="255,0,0" />
              <CHARTVALUE lookupfield="POP1999" color="0,0,255" />
            </CHARTSYMBOL>
          </SIMPLELABELRENDERER>
        </GROUPRENDERER>
      </LAYER
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: Using sizefield with the field in a joined DBF file.

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="-127.87777503188939" miny="30.378245451392196" maxx="-101.1629831289576" maxy="48.55733555119212" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
    </PROPERTIES>
    <WORKSPACES>
      <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
    </WORKSPACES>
    <LAYER type="featureclass" name="States" visible="true" id="0">
      <DATASET name="states" type="polygon" workspace="shp_ws-0" />
        <SPATIALQUERY where="states.SUB_REGION='Mtn'" joinexpression="To=[states.STATE_FIPS],From=[relatefile.STATE_FIPS],Type=[scan]" jointables="relatefile" />
       <GROUPRENDERER>
          <SIMPLERENDERER>
            <SIMPLEPOLYGONSYMBOL fillcolor="127,127,27" />
          </SIMPLERENDERER>
          <SIMPLELABELRENDERER  field="POP1990 POP1999 RELATEFILE.CHARTSIZE">
            <CHARTSYMBOL mode="bar" sizefield="RELATEFILE.CHARTSIZE" transparency="1.0" >
              <CHARTVALUE lookupfield="POP1990" color="255,0,0" />
              <CHARTVALUE lookupfield="POP1999" color="0,0,255" />
            </CHARTSYMBOL>
          </SIMPLELABELRENDERER>
        </GROUPRENDERER>
      </LAYER
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: Using an ArcSDE layer and the size attribute.

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="-127.34083168343714" miny="27.246314948863663" maxx="-97.31362835016226" maxy="50.018623517052" name="Initial_Extent" />
      <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
        <SDEWORKSPACE name="sde_ws-4" server="ARCSDENAME" NAME="port:5151" user="SDE" encrypted="true" password="OCOBLVWKFCAEHC" />
      </WORKSPACES>
      <LAYER type="featureclass" name="SDE.US_STATES" visible="true" id="0">
      <DATASET name="SDE.US_STATES" type="polygon" workspace="sde_ws-4" />
      <GROUPRENDERER>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="27,27,227" />
        </SIMPLERENDERER>
          <SIMPLELABELRENDERER field="SDE.US_STATES.POP1999 SDE.US_STATES.POP1990">
            <CHARTSYMBOL size="30" >
              <CHARTVALUE lookupfield="SDE.US_STATES.POP1990" color="255,0,0" />
              <CHARTVALUE lookupfield="SDE.US_STATES.POP1999" color="0,0,255" />
            </CHARTSYMBOL>
          </SIMPLELABELRENDERER>
      </GROUPRENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>