Attract Starfield¶

The starfield mode renders a perspective depth starfield effect where stars emanate from a central vanishing point and accelerate toward panel edges, simulating forward motion through space. Stars are drawn as single-pixel or short-trail sprites with speed and trail length proportional to distance from the center.

Options¶

Key	Type	Description	Default	Allowed Values
`speed`	float	Travel speed multiplier controlling how quickly stars accelerate outward from the central vanishing point	1.0	any valid float (0.1–10.0)
`density`	float	Star density scaling factor from sparse starfield (0.1) to a densely packed star-filled space (1.0)	0.5	any valid float (0.1–1.0)
`layers`	int	Number of depth layers simulating parallax, with farther layers moving slower than nearer layers	4	any valid int (1–8)

Policy Fields¶

Field	Type	Range	Default	Description
Speed	float64	[0.1, 10.0]	1.0	Travel speed multiplier
Density	float64	[0.1, 1.0]	0.5	Star density scaling
Layers	int	[1, 8]	4	Depth layers

CLI Examples¶

Query the current policy values:

cyberhudctl display attract_starfield

Set a faster travel speed with more depth layers:

cyberhudctl display config 0 speed=3.0 layers=6

Panel Compatibility¶

Color TFT — full-color star sprites with brightness scaling per depth layer; nearer stars appear brighter and leave longer trails as they accelerate toward the edges.
Monochrome OLED — stars render as white pixels or short trails against a black background; depth layers use luminance variation to convey distance.
E-Ink — a static starfield frame is produced (see below).

E-Ink Behavior¶

On e-ink panels, the starfield mode renders a static starfield frame for slow-refresh panels. Rather than animating continuous forward motion, a single arrangement of stars at varying depths is composed and held as a non-interactive ambient display. The Speed policy field has no visible effect on e-ink panels since no animation occurs.