Skip To Content ArcGIS for Developers Sign In Dashboard

Web Map Specification

Dot Density Renderer

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.
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.
Value of this property must be dotDensity
visualVariables An array of sizeInfo objects used to vary the outline width based on the view.scale.

Example

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

{
  "renderer": {
    "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": {
      "unit": "people"
    },
    "dotValue": 100,
    "referenceScale": 577790,
    "seed": 1
  }
}

Feedback on this topic?