dotDensityRenderer | Web Map Specification

This renderer allows you to create dot density visualizations for polygon layers. Dot density visualizations randomly draw dots within each polygon to visualize the density of a population or some other variable. Each dot represents a fixed numeric value of an attribute or a subset of attributes.

Referenced by: renderer

Properties

Property	Details
attributes[]	An array of AttributeColorInfo objects defining the dot colors.
authoringInfo	An object containing metadata about the authoring process for creating a renderer object. This allows the authoring clients to save specific overridable settings so that next time it is accessed via the UI, their selections are remembered. Non-authoring clients can ignore it.
backgroundColor	The color used to shade the polygon fill behind the dots. Color is represented as a four-element array. The four elements represent values for red, green, blue, and alpha in that order. Values range from 0 through 255. If color is undefined for a symbol, the color value is null.
dotBlendingEnabled	Only applicable when two or more `attributes` are specified. When `true`, indicates that colors for overlapping dots will blend.
dotSize	Defines the size of each dot in points. The default is `1` in maps that don’t persist `dotSize`.
dotValue	Defines the dot value used for visualizing density. For example, if set to `100`, each dot will represent 100 units. If a `referenceScale` is provided, this value indicates the value of each dot at the view.scale matching the value in `referenceScale`.
legendOptions	Options for describing the renderer in the legend. This includes the title and the units describing the `dotValue`.
outline	Sets the outline of the polygon.
referenceScale	When defined, the renderer will recalculate the dot value linearly based on the change in the view’s scale. The rendering will maintain the density of points as drawn at the provided scale across various scales.
seed	The reference to a specific rendering of dots. This value ensures you can view the same dot density rendering for each draw.
type	Specifies the type of renderer used. Valid value of this property `dotDensity`
visualVariables[]	An array of sizeInfo objects used to vary the outline width based on the view.scale.

Dot Density Renderer Example

Dot Density Renderer of population by race in the United States.

{
  "type": "dotDensity",
  "attributes": [
    {
      "color": [
        242,
        60,
        63,
        255
      ],
      "field": "B03002_003E",
      "label": "White (non-Hispanic)"
    },
    {
      "color": [
        232,
        202,
        13,
        255
      ],
      "field": "B03002_012E",
      "label": "Hispanic"
    },
    {
      "color": [
        0,
        182,
        241,
        255
      ],
      "field": "B03002_004E",
      "label": "Black or African American"
    },
    {
      "color": [
        50,
        239,
        148,
        255
      ],
      "field": "B03002_006E",
      "label": "Asian"
    },
    {
      "color": [
        255,
        127,
        233,
        255
      ],
      "field": "B03002_005E",
      "label": "American Indian/Alaskan Native"
    },
    {
      "color": [
        226,
        196,
        165,
        255
      ],
      "field": "B03002_007E",
      "label": "Pacific Islander/Hawaiian Native"
    },
    {
      "color": [
        255,
        106,
        0,
        255
      ],
      "field": "B03002_008E",
      "label": "Other race"
    },
    {
      "color": [
        150,
        247,
        239,
        255
      ],
      "field": "B03002_009E",
      "label": "Two or more races"
    }
  ],
  "backgroundColor": [
    0,
    0,
    0,
    0
  ],
  "outline": {
    "color": [
      0,
      0,
      128,
      255
    ],
    "width": 0.99975,
    "type": "esriSLS",
    "style": "esriSLSSolid"
  },
  "dotBlendingEnabled": true,
  "legendOptions": {
    "dotLabel": "Dot",
    "unit": "people"
  },
  "dotValue": 100,
  "dotSize": 1,
  "referenceScale": 577790,
  "seed": 1
}