Attract Shapes¶

The shapes mode renders pulsing and rotating geometric shapes (regular polygons) across the panel for a dynamic abstract art effect. Each shape oscillates in scale at a configurable pulse rate while rotating continuously, creating a mesmerizing animated pattern.

Options¶

Key	Type	Description	Default	Allowed Values
`speed`	float	Rotation speed multiplier controlling how quickly the polygon shapes spin continuously on screen	1.0	any valid float (0.1–10.0 recommended)
`density`	float	Visual density factor from sparse placement (0.1) to maximum shape coverage (1.0) on panel	0.5	any valid float (0.1–1.0)
`shape_count`	int	Number of shapes to display simultaneously on the panel surface as rotating polygon elements	8	any valid int (1–32 recommended)
`pulse_rate`	float	Scale oscillation rate in oscillations per second controlling the breathing pulsation of each shape	1.0	any valid float (0.1–5.0 recommended)
`complexity`	int	Number of polygon sides for each shape from triangle (3) to octagon (8)	6	any valid int (3–8)

Policy Fields¶

Field	Type	Range	Default	Description
Speed	float64	[0.1, 10.0]	1.0	Rotation speed multiplier
Density	float64	[0.1, 1.0]	0.5	Reserved for uniformity
ShapeCount	int	[1, 50]	8	Number of shapes to display
PulseRate	float64	[0.1, 5.0]	1.0	Scale oscillation rate (oscillations/second)
Complexity	int	[3, 8]	6	Number of polygon sides

CLI Examples¶

Query the current policy values:

cyberhudctl display attract_shapes

Set more shapes with faster rotation and triangular polygons:

cyberhudctl display config 0 shape_count=12 speed=3.0 complexity=3

Panel Compatibility¶

Color TFT — full-color polygon rendering with smooth rotation and scale animation at the configured frame rate.
Monochrome OLED — shapes render as white outlines on black; rotation and pulsing animation remain active with grayscale intensity.
E-Ink — a static decorative shapes frame is produced (see below).

E-Ink Behavior¶

On e-ink panels, the shapes mode renders a static decorative shapes frame suitable for slow-refresh displays. Rather than animating continuous rotation and pulsing, a single arrangement of polygons is composed and held indefinitely, avoiding the ghosting and flicker that partial refreshes would introduce. The Speed and PulseRate policy fields have no visible effect on e-ink panels since no animation occurs.