<shape>

The <shape> element is a child of the <geolayer> element and specifies attributes related to the polygon.

Description

When the type attribute in <geolayer> is set to states, counties, or countries, the default shape is polygon. When type is zipcodes or loacations, the default shape is point.

Syntax

<dynamic>
  <widget class_="graphics">
    <graphspec>
      <geograph ...>
        <geolayer shape="[SHAPE_TYPE]">
          <shape type="[SHAPE_TYPE]" 
           colormap="[COLORMAP]" 
           shapesize="[SHAPE_SIZE]" 
           color="[SHAPE_COLOR]" 
           edgecolor="[EDGE_COLOR]" 
           opacity="[OPACITY]" 
           thickness="[THICKNESS]|thick|thin" 
           pointsize="[POINT_SIZE]|small|medium|large">
            <colormap .../>
          </datalabel>
        </geolayer>
      </geograph>
    </graphspec>
  </widget>
</dynamic>

Attributes

type
Specifies the type of shape to use.

Valid values are:

polygon
point
[SHAPE_TYPE]

For a list of valid shapes, see Shape icons.

colormap
Specifies a theme, gradient name, or list of colors that are used as the palette for coloring the shapes.

This is also used in the legend defined by the <legend> element.

Valid values are:

theme
The coloring palette is based on the theme specified in the <graphspec>.

See <graphspec> for more information about specifying a theme.

This is the default if colormap is not specified.

[THEME_NAME]
The color palette is based on a given theme name.

The first three colors in the series colors for the theme are used.

See Color themes for a list of valid values.

[LIST_OF_COLORS]
The color palette is based on a semicolon-separated list of CSS colors (e.g., red;yellow;green), hexadecimal values (e.g., #F00;#FFA500;#00F), rgb values (e.g., rgb(255,0,0);rgb(255,165,0);rgb(0,0,255), or any combination of these (e.g., rgb(255,0,0);orange;#0000FF)

The default is the series colors for the given theme.

A <colormap> element may be included as a child of <shape> to specify additional attributes. For more information, see <colormap>

shapesize
Specifies the size of the shape.
color
Specifies the color used to fill the shape.

The color can be specified as any valid HTML color name, an RGB value, or a hex value.

edgecolor
Specifies the color used to outline the shape.

The color can be specified as any valid HTML color name, an RGB value, or a hex value.

opacity
Specifies the opacity of the color within the polygon. Accepts a value between 0 and 1.

To draw a completely transparent polygon (i.e., when only the outline of the polygon is needed), set opacity="0".

thickness
Specifies the polygon boundary thickness as a fraction of the plot range.

To draw polygons without a boundary, set thickness="0".

The following values can also be specified:
  • thick
  • thin
pointsize
Specifies the point size as a fraction of the plot range.
The following values can also be specified:
  • small
  • medium
  • large

Example

<dynamic>
  <widget class_="graphics" width_="800" height_="800">
    <graphspec>
      <geograph type="counties">
        <data states="oh" datalabel="name">
          <datalabel color="blue" size="10"/>
        </data>
        <shape type="polygon" color="lightblue" edgecolor="black" thickness="thin"/>
      </geograph>
    </graphspec>
  </widget>
</dynamic>

Example

<dynamic>
  <widget class_="graphics" width_="900">
    <table cols="state, lat, long, value, label, markersize, markershape">  
      New York, 40.66, -73.93, 105.5, In NY, 5, point;
      Montana, 47.04, -109.65, 75.3, In Montana, 10, pushpin;
      North Dakota, 46.81, -100.77, 25.3, In ND, 15, wifi;
      Tx, 31.48, -99.37, 17.5, In TX, 40, pin;
      Arizona, 34.3287, -111.67, 33.0, In Arizona, 30, telephone;
      Oregon, 43.93, -120.56, 42, In Oregon, 80, sad
    </table>
    <graphspec>
      <geograph title="Pin Markers" projection="orthographic">
        <geolayer type="states"/>
        <geolayer type="locations" x="long" y="lat" 
         value="value" datalabel="name" name="label" namevalue="value"
         shape="markershape" size="markersize">
          <datalabel color="white" size="15">
            <colormap value="black,white" xmin="10" xmax="120"/>
            <legend hide="0"/>
          </datalabel>
          <shape type="pin" edgecolor="lightgray" shapesize="40,80">
            <colormap value="black,orange" opacity="0.7"/>
            <legend hide="0"/>
          </shape>
        </geolayer>
      </geograph>
    </graphspec>
  </widget>
</dynamic>