<colormap>

Description

The <colormap> element can be a child element of <geograph>, <geolayer>, <datalabel>, or <shape> and specifies attributes related to the theme, gradient name, or list of colors as specified by its value attribute or by the colormap attribute of its parent element.

When <colormap> is included as a child of <geograph>, the colormap is applied to all elements displayed by the graphics widget. Individual <datalabel> or <shape> elements can specify their own colormaps using their own colormap attribute and customize settings using their own <colormap> child element.

Syntax

<dynamic>
  <widget class_="graphics"> 
    [1010data_QUERY] 
      <graphspec>
        <geograph colormap="[COLORMAP_VALUE]" ... >
          <geolayer ...>
            <datalabel colormap="[COLORMAP_VALUE]"...>
              <colormap value="[COLORMAP_VALUE]" 
               min="[MIN]" max="[MAX]"
               reverse="0|1|true|false" opacity="[OPACITY]"/>
            <shape colormap="[COLORMAP_VALUE]"...>
              <colormap value="[COLORMAP_VALUE]"
               min="[MIN]" max="[MAX]"
               reverse="0|1|true|false" opacity="[OPACITY]"/>
            </datalabel>
          </geolabel>
          <colormap min="[MIN]" max="[MAX]"
           reverse="0|1|true|false" opacity="[OPACITY]"/>
        </geograph>
    </graphspec> 
  </widget> 
</dynamic>

Attributes

value

Specifies a theme or list of colors that are used as the palette for coloring the polygons.

Note: This can also be specified using the colormap attribute of the parent element (i.e., <graphspec>, <datalabel>, and <shape>).

The value specified to this attribute is also used by 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 value 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 theme.

colorsteps

Specifies how the list of colors or theme that is specified to the colormap attribute are interpreted.

Valid values are:

auto

Generates a continuous color interpolation.

indexed

Generates a color function that is indexed by the length of the colors list.

Takes the integer value of the data value and uses that integer value as the index into the table of colors.

Predefined theme colors take only three colors.

[INTEGER_VALUE]

Generates an equally spaced number of interpolated colors based on the integer value specified.

[LIST_OF_VALUES]

Generates intervals for each of the colors in the colormap based on the list of values specified between the minimum and maximum values.

min

Specifies the minimum value to which the colormap is applied.

By default, the minimum value is determined by the data values to which the colormap is being applied.

max

Specifies the maximum value to which the colormap is applied.

By default, the maximum value is determined by the data values to which the colormap is being applied.

defcolor

Specifies the default color to use for non-numeric values.

By default, the color at the minimum value is used.

opacity

Specifies the opacity of the colormap. Accepts values between 0 and 1.

wrap

Specifies whether or not to cycle through the colormap for data values that fall outside the minimum and maximum values. Accepts 1 or 0 (or true or false).

When wrap="0" (or is not specified), data values outside the range are mapped to colors corresponding to the minimum or maximum.

When wrap="1", the colors will wrap around cyclically.

The default is 0.

scale

reverse

Specifies whether or not to reverse the colors in the colormap. Accepts 1 or 0.