Attract Waveform¶

The waveform mode renders animated oscilloscope-style waveform traces across the panel. Traces morph between sine, sawtooth, and harmonic wave shapes with configurable amplitude, speed, and phosphor persistence trail.

Options¶

Key	Type	Description	Default	Allowed Values
`speed`	float	Animation rate multiplier controlling how quickly waveform traces morph and scroll across the panel	1.0	any valid float (0.1–10.0 recommended)
`density`	float	Waveform cycle density mapping 0.1 to 1.0 across 1.5 to 5.5 visible cycles on the panel	0.5	any valid float (0.1–1.0)
`amplitude`	float	Trace amplitude as a fraction of panel height controlling vertical extent of waveform oscillation	0.8	any valid float (0.1–1.0)
`traces`	int	Number of simultaneous waveform traces drawn on the panel each with independent wave shapes	3	any valid int (1–8 recommended)
`persistence`	float	Phosphor trail decay as a fraction of panel width controlling how long trace afterglow lingers	0.5	any valid float (0.0–1.0)
`direction`	string	Trace scroll direction, auto picks horizontal or vertical based on panel aspect ratio orientation	auto	auto, horizontal, vertical

Policy Fields¶

Field	Type	Range	Default	Description
Speed	float64	[0.1, 10.0]	1.0	Animation rate multiplier
Density	float64	[0.1, 1.0]	0.5	Visual density (reserved for uniformity)
Amplitude	float64	[0.1, 1.0]	0.8	Fraction of half panel height for trace amplitude
Traces	int	[1, 8]	3	Number of simultaneous waveform traces
Persistence	float64	[0.1, 1.0]	0.5	Phosphor trail decay as fraction of panel width
Direction	string	"auto" / "horizontal" / "vertical"	"auto"	Trace direction (auto picks based on aspect ratio)

CLI Examples¶

Query the current policy values:

cyberhudctl display attract_waveform

Set a faster animation with more traces and longer persistence:

cyberhudctl display config 0 speed=2.5 traces=5 persistence=0.8

Panel Compatibility¶

Color TFT — full-color waveform traces with phosphor-green glow and smooth gradient trails; multiple traces are drawn in distinct hues for visual separation.
Monochrome OLED — traces render as bright white lines against a black background; persistence trails use diminishing luminance to simulate phosphor decay.
E-Ink — a static decorative waveform frame is produced (see below).

E-Ink Behavior¶

On e-ink panels, the waveform mode renders a static decorative waveform frame for slow-refresh panels. Rather than animating continuous trace motion, a single snapshot of overlapping waveform shapes is composed and held as a non-interactive ambient display. The Speed and Persistence policy fields have no visible effect on e-ink panels since no animation occurs.