Struct AudioAnalysis 

pub struct AudioAnalysis {
    pub frame_rate: u32,
    pub amplitude: Vec<f32>,
    pub bands: Vec<[f32; 16]>,
    pub start: f64,
    pub end: Option<f64>,
}

Per-track audio analysis: amplitude (RMS) and frequency bands per video frame.

Fields

frame_rate: u32

The video frame rate this analysis was computed at.

amplitude: Vec<f32>

RMS amplitude per frame, normalized 0..1 over the whole track.

bands: Vec<[f32; 16]>

16 log-spaced frequency bands (20 Hz–16 kHz) per frame, normalized 0..1.

start: f64

Where the track sits on the scenario timeline (AudioTrack::start).

The analysis indexes the file from its own sample 0, while every consumer asks in scenario time. Without this the two only line up when start == 0: a track placed at 73 s played from its beginning while the waveform drew the file’s content at 73 s. Held here rather than at the call sites because the cache is keyed by path and the painters never see the AudioTrack.

end: Option<f64>

AudioTrack::end, past which the track is cut and the visualisation must go flat rather than keep drawing an envelope nobody hears.

Implementations

impl AudioAnalysis

pub fn amplitude_at(&self, time: f64) -> f32

Get the amplitude at a given time (seconds), clamped to valid range.

pub fn band_at(&self, time: f64, band: u8) -> f32

Get a specific band [0..16) value at a given time.

pub fn amplitude_smoothed(&self, time: f64, smoothing_frames: u32) -> f32

Smoothed amplitude at time: average over the past smoothing_frames frames (inclusive of current).

pub fn band_smoothed(&self, time: f64, band: u8, smoothing_frames: u32) -> f32

Smoothed band value at time over smoothing_frames frames.

Trait Implementations

impl Clone for AudioAnalysis

fn clone(&self) -> AudioAnalysis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AudioAnalysis

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

Formats the value using the given formatter.