<effect>
Content Wallpaper
Generative animated background effect. Picks one of a fixed catalog of templates (particles, blobs, topography, aurora) and renders it on a Compose Canvas driven by the shared animation clock. Pauses when the wallpaper engine is not visible. Allowed wherever a <shape> is — typically inside <background> or a <layer>.
Example
<effect type="particles" count="60" color="#FFFFFF" speed="0.04" size="2dp" twinkle="0.6" />Attributes
| Name | Type | Default | Description |
|---|---|---|---|
type | String | — | Effect template. |
count | Int | — | Element count (particles, blobs, lines) |
palette | String | — | Comma-separated colors (cycled across elements). May be a single color. |
speed | Float | — | Animation speed multiplier (effect-dependent) |
quality | String | — | Element-count multiplier — `low` (×0.5), `medium` (×1.0), `high` (×1.5). Defaults to global Animations setting. |
seed | Int | 1 | Deterministic randomness seed — fixes layout across reboots and snapshots. |
size | Dp | — | Particle radius (particles only) |
radius | Dp | — | Blob soft radius (blobs only) |
blur | Dp | — | Blur radius (blobs/aurora — softens silhouette) |
direction | String | up | Particle drift direction. |
wind | Float | — | Particle horizontal drift coefficient |
twinkle | Float | — | Particle alpha modulation amount (0..1) |
lineCount | Int | — | Topography line count |
amplitude | Dp | — | Topography/aurora vertical excursion |
frequency | Float | — | Topography horizontal density |
strokeWidth | Dp | — | Topography line thickness |
bands | Int | — | Aurora band count |
softness | Dp | — | Aurora blur softness |