Crate wallswitch 

Re-exports

pub use self::app::*;

pub use self::backends::*;

pub use self::cli::*;

pub use self::core::*;

pub use self::error::*;

pub use self::sys::*;

pub use self::utils::*;

Modules

app

Orchestrates the core execution loops, quorum logic, and state management.

backends

Adapters for communicating with Desktop Environments, Window Managers, and Display Servers.

cli

Adapters for user interaction, command-line arguments, and terminal output formatting.

core

The pure Domain of the application. Contains all business rules, entities, and validation.

error

Global error definitions and centralized error handling logic.

sys

Adapters for interacting with the operating system (Filesystem, Processes, Environment).

utils

Generic, domain-agnostic utilities and extension traits used across the application.

Structs

AuroraGenerator

A procedural generator for rendering wave-like Cosmic Aurora overlays.

AuroraParams

Parameters for wave-frequency math operations in the Cosmic Aurora effect.

AuroraRowState

Dynamic calculations computed per image row to optimize thread execution.

FractalPreset

Represents a mathematical coordinate preset for procedural fractal effects.

JuliaGenerator

A procedural generator for rendering Julia Set fractals onto desktop backgrounds.

MandelbrotGenerator

A procedural generator for rendering Mandelbrot Set fractals onto desktop backgrounds.

NewtonGenerator

A procedural generator for rendering Newton-Raphson Basin fractals onto backgrounds.

NewtonPreset

Structural parameters for polynomial evaluation and deformation.

NovaGenerator

A procedural generator for rendering Nova Julia fractals onto desktop backgrounds.

NovaPreset

Structural parameters governing the Nova fluid dynamics.

RelaxedEscape

Escape results from relaxed Newton or Nova Julia iterations.

Star

Represents a single procedurally generated star element.

StarfieldGenerator

A procedural generator for rendering cosmic starfields and bokeh onto image backgrounds.

Viewport

Viewport mapper that transforms physical coordinate grids into complex space.

ViewportSpecs

Viewport configuration parameters representing current camera scale and rotation orientation.

Enums

ProceduralEffect

Represents the supported procedural background overlay effects.

Constants

MAX_ITERATIONS

The default maximum iteration limit for escape-time fractal calculation.

MIN_ITERATIONS

The default minimum iteration limit for escape-time fractal calculation.

ROTATION_STEPS

The number of angular steps used to evaluate structural rotations during optimization.

STAR_RANGE

The minimum and maximum limits for the randomized star count.

TARGET_RANGE

Target coverage ratio range for the Mandelbrot fractal viewport.

Traits

ImageEffect

Trait defining the behavior for any image processing effect.

Functions

blend_and_vignette

Blends the computed fractal color and vignette shadow onto a mutable ColorRGB pixel.

blend_channels_gamma

Linearizes sRGB values to perform mathematically correct alpha-blending, preventing dark-boundary artifacts.

calculate_circular_fade

Computes a flat-center circular edge-fade window (vignette/containment) with a smooth transition near the boundary radius.

calculate_distance_estimator

Calculates the analytical distance estimator (DEM) to the boundary of the fractal set. Returns a coordinate-independent distance value.

calculate_smooth_potential

Calculates the continuous potential (smooth coloring) value for quadratic escape-time fractals.

color_distance_estimator

Unifies distance estimator coloring logic shared by Julia and Mandelbrot generators.

color_relaxed_newton_fractal

Unifies relaxed Newton-Raphson/Nova Julia rendering math to ensure highly consistent visualization.

compute_escape_iterations

Executes complex escape-time steps for both Julia and Mandelbrot fractal types.

find_optimal_framing

Helper to find the optimal viewport rotation and zoom for a set of active complex points.

get_rotation_phasors

Returns an iterator over unit complex phasors representing structural rotation angles.

partition_rows

Partitions an RGB image buffer into mutable row segments for thread-safe parallel processing.

render_fractal_parallel

Helper function that performs parallel rendering over a viewport mapping physical pixels to complex coordinates.

smoothstep

Standard smoothstep mathematical interpolation function.

stretch_potential

Applies power-law (Gamma) stretching to enhance the visual contrast of fractal filaments.