← 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.
countInt—Element count (particles, blobs, lines)
paletteString—Comma-separated colors (cycled across elements). May be a single color.
speedFloat—Animation 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.
sizeDp—Particle radius (particles only)
radiusDp—Blob soft radius (blobs only)
blurDp—Blur radius (blobs/aurora — softens silhouette)
directionString
updowndrift
upParticle drift direction.
windFloat—Particle horizontal drift coefficient
twinkleFloat—Particle alpha modulation amount (0..1)
lineCountInt—Topography line count
amplitudeDp—Topography/aurora vertical excursion
frequencyFloat—Topography horizontal density
strokeWidthDp—Topography line thickness
bandsInt—Aurora band count
softnessDp—Aurora blur softness