Attract Matrix¶

The attract_matrix display mode renders animated matrix-style rain columns with green-fade trails, inspired by the film's iconic digital rain effect.

Features¶

Animated matrix rain columns with randomized speed and trail length
Optional radial gradient background on color panels
Configurable density, speed range, and trail length
"CYBERHUD" splash text at cycle peak
E-ink static mode (frozen single frame)
Panel-aware: color TFT, monochrome OLED, and e-ink

Options¶

Key	Type	Description	Default	Allowed Values
`min_speed`	float	Minimum column scroll speed in cells per second controlling the slowest falling columns	1.5	any valid float (0.1–10.0 recommended)
`max_speed`	float	Maximum column scroll speed in cells per second controlling the fastest falling columns	6	any valid float (must be greater than min_speed)
`trail_length`	int	Number of trailing cells behind the lead character controlling the fade tail length	16	any valid int (1–64 recommended)
`density`	float	Fraction of active columns on the panel from 0.1 sparse to 1.0 fully dense rain	1.0	any valid float (0.1–1.0)
`show_background`	bool	Enable radial gradient background on color panels adding depth behind the rain columns	false	true, false

CLI Examples¶

Activate the attract_matrix mode on the main region:

cyberhudctl display set 0 attract_matrix

Query the current policy values:

cyberhudctl display attract_matrix

Increase density for a denser rain effect:

cyberhudctl display attract_matrix density=0.8

Set faster column speeds with longer trails:

cyberhudctl display attract_matrix min_speed=3.0 max_speed=8.0 trail_length=24

Enable the radial gradient background on color panels:

cyberhudctl display attract_matrix show_background=true

Panel Compatibility¶

Color TFT — full green-fade rain columns with optional radial gradient background, smooth animation at configurable speed and density.
Monochrome OLED — rain columns render as white-on-black with intensity-based trail fade; the show_background option has no visible effect since gradient color information is absent.
E-Ink — a single frozen frame of matrix rain is composed and held statically, avoiding ghosting from partial refreshes. Animation speed options have no visible effect on e-ink panels.

E-Ink Behavior¶

On e-ink panels, the matrix rain mode produces a static snapshot of falling columns rather than continuous animation. The frozen frame captures column positions and trail fade at a single instant, suitable for slow-refresh displays. The min_speed, max_speed, and density options still influence the composition of the frozen frame (column spacing and trail length), but no motion occurs after the initial render.