← All components

<effect>

ContentWallpaper

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

NameTypeDefaultDescription
typeString
particlesblobstopographyaurora
Effect template.
countIntElement count (particles, blobs, lines)
paletteStringComma-separated colors (cycled across elements). May be a single color.
speedFloatAnimation speed multiplier (effect-dependent)
qualityString
lowmediumhigh
Element-count multiplier — low (×0.5), medium (×1.0), high (×1.5). Defaults to global Animations setting.
seedInt1Deterministic randomness seed — fixes layout across reboots and snapshots.
sizeDpParticle radius (particles only)
radiusDpBlob soft radius (blobs only)
blurDpBlur radius (blobs/aurora — softens silhouette)
directionString
updowndrift
upParticle drift direction.
windFloatParticle horizontal drift coefficient
twinkleFloatParticle alpha modulation amount (0..1)
lineCountIntTopography line count
amplitudeDpTopography/aurora vertical excursion
frequencyFloatTopography horizontal density
strokeWidthDpTopography line thickness
bandsIntAurora band count
softnessDpAurora blur softness