Matrix API

Matrix

Extends Effect.

Factory Function

createMatrix(config?: MatrixConfig)

Methods

See Effect for the full method reference: mount(), start(), pause(), resume(), configure(), withFade(), and destroy().

---

MatrixConfig

interface MatrixConfig {
    columns?: number;
    speed?: number;
    color?: string;
    fontSize?: number;
    trailLength?: number;
    scale?: number;
}

Property	Type	Default	Description
columns	number	40	Maximum number of active falling columns. Automatically halved on small screens.
speed	number	1	Fall speed multiplier. Higher values make characters fall faster.
color	string	'#00ff41'	Hex color string for the trailing characters. The head character is always white.
fontSize	number	14	Character size in pixels. Also determines column spacing. Scaled by scale.
trailLength	number	20	Base number of characters per column trail. Actual length varies randomly.
scale	number	1	Scales font size proportionally.

---

MatrixColumn

Internal representation of a falling column.

type MatrixColumn = {
    x: number;              // X position in pixels (center of column)
    y: number;              // Y position of the head character in pixels
    speed: number;          // Fall speed of this column
    chars: string[];        // Array of characters in the trail
    length: number;         // Number of characters in the trail
    headBrightness: number; // Brightness of the head character (0.8-1.0)
};