Struct SpectralOperator 

pub struct SpectralOperator;

Unified spectral operator — the single entry point for all spectral operations in the Qualia engine.

This is a zero-allocation facade: it holds no state and dispatches to the specialised submodules. All methods are &self or associated functions.

Implementations

impl SpectralOperator

pub fn emf_to_spd(alpha: f32, mu: f32, sigma: f32) -> Spd

Convert an EMF payload [α, μ, σ] to a Spectral Power Distribution.

pub fn spd_to_xyz(spd: &Spd) -> Xyz

Project an SPD to CIE XYZ tristimulus values.

pub fn xyz_to_linear_srgb(xyz: &Xyz) -> LinearRgb

Convert CIE XYZ to linear sRGB.

pub fn emf_to_linear_rgb(alpha: f32, mu: f32, sigma: f32) -> LinearRgb

Full EMF → linear sRGB pipeline.

pub fn linear_rgb_to_display(rgb: &LinearRgb) -> (u8, u8, u8)

Convert linear sRGB to 8-bit display sRGB (gamma-encoded).

pub fn emf_to_display_rgb(alpha: f32, mu: f32, sigma: f32) -> (u8, u8, u8)

Full EMF → 8-bit display sRGB pipeline.

pub fn delta_e(xyz_a: &Xyz, xyz_b: &Xyz) -> f32

CIE76 ΔE colour difference between two XYZ values.

pub fn xyz_to_lab(xyz: &Xyz) -> (f32, f32, f32)

Convert XYZ to CIELAB.

pub fn metamer_kernel_basis( out_basis: &mut [f32], ) -> Result<usize, MetamerError>

Compute the kernel basis for metameric-black SPDs.

pub fn min_norm_spd_for_xyz(target: &Xyz) -> Spd

Compute the minimum-norm SPD for a target XYZ.

pub fn fibre_spd(particular: &Spd, basis: &[f32], coeffs: &[f32]) -> Spd

Construct a fibre element: particular + Σ c_i · ker_i.

pub fn is_metameric(spd: &Spd, target: &Xyz, tolerance: f32) -> bool

Check if an SPD is metameric to a target XYZ.

pub fn is_in_gamut(xyz: &Xyz) -> bool

Check if a colour is in the sRGB gamut.

pub fn gamut_map(xyz: &Xyz) -> Xyz

Map an out-of-gamut colour to the closest in-gamut colour.

pub fn linear_srgb_to_xyz(rgb: &LinearRgb) -> Xyz

Convert linear sRGB to CIE XYZ.

pub fn spectral_blend_spd(a: &Spd, b: &Spd, t: f32) -> Spd

Blend two SPDs in spectral space.

pub fn spectral_blend_emf( alpha_a: f32, mu_a: f32, sigma_a: f32, alpha_b: f32, mu_b: f32, sigma_b: f32, t: f32, ) -> Xyz

Blend two EMF payloads in spectral space and return XYZ.

pub fn blend_divergence( alpha_a: f32, mu_a: f32, sigma_a: f32, alpha_b: f32, mu_b: f32, sigma_b: f32, t: f32, ) -> f32

ΔE divergence between spectral blend and gamma-encoded sRGB lerp.

pub fn tf_surface<'a>( raster: &'a [f32], frame_count: usize, bin_count: usize, sample_rate: u32, hop_size: usize, ) -> TfSurface<'a>

Create a time-frequency surface view from a raster.

pub fn surface_gain( surface: &TfSurface<'_>, region: &TfRegion, gain: f32, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Apply a gain to a region of the surface.

pub fn surface_gate( surface: &TfSurface<'_>, region: &TfRegion, threshold: f32, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Spectral gate: zero out bins below a threshold.

pub fn surface_copy_patch( surface: &TfSurface<'_>, src_region: &TfRegion, dst_frame: usize, dst_bin: usize, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Copy a rectangular patch to a new location.

pub fn surface_time_stretch( surface: &TfSurface<'_>, factor: f32, out: &mut [f32], ) -> Result<(usize, usize), SurfaceEditError>

Time-stretch by resampling along the time axis.

pub fn surface_pitch_shift( surface: &TfSurface<'_>, factor: f32, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Pitch-shift by resampling along the frequency axis.

pub fn surface_crossfade( surface_a: &TfSurface<'_>, surface_b: &TfSurface<'_>, t: f32, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Crossfade two surfaces.

pub fn surface_fade_in( surface: &TfSurface<'_>, fade_frames: usize, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Fade in over the first fade_frames frames.

pub fn surface_fade_out( surface: &TfSurface<'_>, fade_frames: usize, out: &mut [f32], ) -> Result<usize, SurfaceEditError>

Fade out over the last fade_frames frames.

pub fn batch_emf_to_display(emf: &[f32], out: &mut [u8]) -> usize

Batch EMF → display RGB: process N EMF payloads into N display RGB triples. emf is [α, μ, σ] triples (3N floats), out is N3 u8.

pub fn batch_emf_to_xyz(emf: &[f32], out: &mut [f32]) -> usize

Batch EMF → XYZ: process N EMF payloads into N XYZ triples. emf is [α, μ, σ] triples (3N floats), out is N3 f32.

pub fn batch_gamut_map(xyz: &[f32], out: &mut [f32]) -> usize

Batch gamut mapping: map N XYZ triples to in-gamut XYZ. out is N*3 f32.

Trait Implementations

impl Clone for SpectralOperator

fn clone(&self) -> SpectralOperator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpectralOperator

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

Formats the value using the given formatter.

impl Default for SpectralOperator

fn default() -> SpectralOperator

Returns the “default value” for a type.

impl Copy for SpectralOperator