Attract Bokeh¶

The bokeh mode renders soft out-of-focus light circles that drift gently across the panel with varying sizes, opacities, and positions. The effect mimics bokeh photography — large translucent circles with radial gradient edges that overlap and blend to produce a dreamy, ambient aesthetic.

Options¶

Key	Type	Description	Default	Allowed Values
`speed`	float	Drift speed multiplier controlling how quickly bokeh circles move across the panel surface	1.0	any valid float (0.1–10.0 recommended)
`density`	float	Circle count scaling factor from sparse (0.1) to maximum coverage (1.0) on the display	0.5	any valid float (0.1–1.0)
`size_variance`	float	Radius spread from uniform circles (0.0) to maximum size variation (1.0) in the scene	0.5	any valid float (0.0–1.0)
`saturation`	float	Color saturation level from desaturated pastel (0.0) to vivid fully-saturated hues (1.0)	0.7	any valid float (0.0–1.0)

Policy Fields¶

Field	Type	Range	Default	Description
Speed	float64	[0.1, 10.0]	1.0	Drift speed multiplier
Density	float64	[0.1, 1.0]	0.5	Circle count scaling
SizeVariance	float64	[0.0, 1.0]	0.5	Radius spread (0=uniform, 1=max spread)
Saturation	float64	[0.0, 1.0]	0.7	Color saturation

CLI Examples¶

Query the current policy values:

cyberhudctl display policy attract_bokeh

Set a faster drift speed with higher circle density:

cyberhudctl display config 0 speed=2.5 density=0.8

Panel Compatibility¶

Color TFT — full-color radial gradient circles with saturation control and smooth blending between overlapping circles.
Monochrome OLED — circles use luminance-only values without color; gradients render as grayscale intensity falloff from center to edge.
E-Ink — a static frozen bokeh scatter frame is produced (see below).

E-Ink Behavior¶

On e-ink panels, the bokeh mode renders a static frozen bokeh scatter frame suitable for slow-refresh displays. Rather than animating continuous drift, a single arrangement of circles is composed and held indefinitely, avoiding the ghosting and flicker that partial refreshes would introduce. The Speed policy field has no visible effect on e-ink panels since no animation occurs.