---
title: Options reference
description: Every setting an Elroot Dot Matrix art takes, with its default and range.
---

# Options reference

Every art takes the same settings. Set them on the art's page, name them in your request ("make it amber and slower"), or pass them to `get_art`.

## Look and motion

| Setting | Default | Range | What it does |
|---|---|---|---|
| `color` | `#A6E22E` | hex colour | Colour of the lit dots |
| `color2` | none | hex colour | Colour of the dimmest dots; brightness blends from it to `color` |
| `background` | transparent | hex colour | Fills the area behind the dots |
| `grid` | on | on or off | A faint ring at every dot position |
| `speed` | `1` | 0 to 3 | 0 holds the art still |
| `spacing` | `8` | 4 to 20 | Pixels between dots; smaller is denser |
| `size` | `1` | 0.4 to 2 | Dot size |
| `shape` | `round` | `round`, `square` | Dot shape |
| `autoSpacing` | on in the library and in code from `get_art` | on or off | Under 360 px, draws dots closer (down to 3 px) so small arts keep their shape. See [Sizing](/opensource/dotmatrix/docs/sizing) |

Values outside a range are moved to the nearest end of it. Colours are hex, such as `#ff7a00` or `#f70`.

## Settings for one art

| Setting | Art | Default | What it does |
|---|---|---|---|
| `text` | Marquee | `HELLO WORLD` | The text that scrolls, up to 80 characters |
| `from` | Countdown | `10` | The number it counts down from, 1 to 99 |
| `hour12` | Clock | off | 12-hour time with AM and PM |

## Changing settings in your project

The file your assistant adds takes the same settings as properties, so later changes are a one-line request: "set the radar's speed to 0.6".
