Attract Plasma¶

The plasma mode renders a lava-lamp-style plasma blob effect by evaluating overlapping sine-based color functions at each pixel position. The pattern morphs continuously over time, producing smooth organic blob shapes that shift and merge through a cycling 256-step gradient palette.

Options¶

Key	Type	Description	Default	Allowed Values
`speed`	float	Morph speed multiplier controlling how quickly the plasma blobs shift and evolve over time	1.0	any valid float (0.1–10.0 recommended)
`density`	float	Density parameter kept for uniformity across attract modes, does not visibly affect plasma output	0.5	any valid float (0.1–1.0)
`cycle_rate`	float	Color palette cycles per second controlling how rapidly the gradient hues rotate through the spectrum	1.0	any valid float (0.1–5.0 recommended)
`blob_scale`	float	Spatial frequency multiplier for blob size, higher values produce smaller more numerous blobs	1.0	any valid float (0.5–4.0)

Policy Fields¶

Field	Type	Range	Default	Description
Speed	float64	[0.1, 10.0]	1.0	Morph speed multiplier
Density	float64	[0.1, 1.0]	0.5	Reserved for uniformity
CycleRate	float64	[0.1, 5.0]	1.0	Color palette cycles/second
BlobScale	float64	[0.5, 4.0]	1.0	Spatial frequency multiplier

CLI Examples¶

Query current plasma policy settings:

cyberhudctl display attract_plasma

Set a faster morph speed with tighter blob scaling:

cyberhudctl display config 0 speed=3.0 blob_scale=2.0

Panel Compatibility¶

Color TFT — full RGB plasma rendering with smooth gradient transitions across the 256-step palette. This is the ideal panel type for the plasma effect.
Monochrome OLED — the plasma pattern is rendered in grayscale, mapping palette intensity to white levels. Blob shapes remain visible but without color variation.
E-Ink — renders a single static frame due to slow refresh characteristics. See E-Ink Behavior below.

E-Ink Behavior¶

On e-ink panels, the plasma mode renders a single static plasma frame at time=0 for slow-refresh panels. The RenderCacheKey remains stable after the initial frame, preventing unnecessary refreshes that would cause flicker or ghosting on e-ink displays.