Enum ProceduralEffect 

pub enum ProceduralEffect {
    None,
    JuliaSet,
    Mandelbrot,
    NewtonBasins,
    NovaJulia,
    CosmicAurora,
    Starfield,
    Fractal,
    Polynomial,
    Random,
}

Represents all supported procedural background overlay effects.

Variants

None

No overlay effect is applied; displays the raw, unaltered wallpaper.

JuliaSet

Julia Set fractal overlay.

• Characteristics: Rendered as thin, sharp, self-similar contour lines forming highly symmetrical branching patterns. Depending on the selected complex constant, the lines trace intricate shapes resembling swirling clouds, dendritic lace, spiral galaxy arms, leafy filaments, or crystalline snowflakes.
• Creator: Developed mathematically by the French mathematician Gaston Julia in 1918.
• Generator function: Calculated by mapping the convergence boundary under the recursive function: f(z) = z^2 + c where c is a fixed complex constant perturbation and the initial coordinate z_0 varies across the viewport.

Mandelbrot

Mandelbrot Set fractal overlay.

• Characteristics: Rendered as thin, sharp, self-similar contour lines tracing the boundary of the set. The lines expose highly detailed structural contours, including a main cardioid, circular period bulbs, swirling spiral valleys, and repeating miniature copies of the entire set connected by thin filaments.
• Creator: First visualized and defined by the Polish-born French-American mathematician Benoit Mandelbrot in 1980.
• Generator function: Modeled using the quadratic recurrence equation starting from the origin: z(n+1) = z(n)^2 + c where z_0 = 0 and the complex parameter c varies across the viewport grid coordinates.

NewtonBasins

Newton-Raphson Basin of Attraction fractal overlay.

• Characteristics: Symmetrical, kaleidoscope-like mandala structures representing root-finding convergence fields across complex space boundaries. It maps the limits of convergence zones where points migrate to specific roots of a polynomial equation.
• Creator: Formulated based on Sir Isaac Newton’s root-approximation methods (1690s) and Arthur Cayley’s subsequent complex-plane studies (1879).
• Generator function: Computed using a relaxed Newton-Raphson recurrence formula: z(n+1) = z(n) - lambda * f(z(n)) / f’(z(n)) on the polynomial f(z) = z^p - 1, where p is the integer polynomial power and lambda is a complex relaxation factor.

NovaJulia

Nova Julia liquid fractal overlay.

• Characteristics: Organic, flowing, fluid-like plumes resembling liquid mercury, cosmic nebulae, or dynamic plasma current paths.
• Creator: Developed by Paul Derbyshire in the late 1990s as a structural variation and relaxation of the classic Newton-Raphson fractal.
• Generator function: Evaluated using the relaxed Newton recurrence relation perturbed by a dynamic additive complex value: z(n+1) = z(n) - R * (z(n)^p - 1) / (p * z(n)^(p-1)) + c where p is the polynomial exponent, R is a complex relaxation modifier, and c is a fixed perturbation coordinate.

CosmicAurora

Procedural Cosmic Aurora wave generator.

Generator function: multi-frequency sinusoidal wave composition.

Starfield

Procedural Starfield / Bokeh generator.

Generator function: I(d) = I_0 * exp(-d^2 / (2 * sigma^2)) (Gaussian).

Fractal

Fractal mode selector: randomly chooses between Julia or Mandelbrot.

Polynomial

Fractal mode selector: randomly chooses between Newton or Nova.

Random

Fully randomised mode selector: picks any effect independently per display.

Implementations

impl ProceduralEffect

pub fn get_name(self) -> &'static str

Human-readable display name for diagnostics and terminal output.

pub fn resolve(self) -> Self

Resolves meta-variants (Fractal, Random) to a single concrete effect.

Concrete variants pass through unchanged so callers can always call resolve() unconditionally.

pub fn get_renderer( self, monitor: &Monitor, config: &Config, ) -> WallSwitchResult<Option<Box<dyn ImageEffect>>>

Constructs a heap-allocated, monitor-fitted ImageEffect for this variant.

Returns None for ProceduralEffect::None and the meta-variants Fractal / Random (callers should call resolve first).

Errors

Returns a WallSwitchError if the generator initialization fails.

Trait Implementations

impl Clone for ProceduralEffect

fn clone(&self) -> ProceduralEffect

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ProceduralEffect

impl Debug for ProceduralEffect

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ProceduralEffect

fn default() -> ProceduralEffect

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ProceduralEffect

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProceduralEffect

impl PartialEq for ProceduralEffect

fn eq(&self, other: &ProceduralEffect) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ProceduralEffect

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProceduralEffect

impl ValueEnum for ProceduralEffect

fn value_variants<'a>() -> &'a [Self]

All possible argument values, in display order.

fn to_possible_value<'a>(&self) -> Option<PossibleValue>

The canonical argument value.

fn from_str(input: &str, ignore_case: bool) -> Result<Self, String>

Parse an argument into Self.