Struct AudioTrack 

pub struct AudioTrack {
    clip: AudioClip,
    gain: f64,
    fade_in_secs: f64,
    fade_out_secs: f64,
    play_range: Option<Range<f64>>,
}

A sound’s content data: the clip plus how to play it.

Purely substance — clip trim and gain envelope. Everything time-positional (placement, window duration, enable, rate warps — including linear speed changes via with_duration) lives on the cell layer (Unplaced::at, with_duration, with_rate_func, with_enabled), exactly like a visual item’s data versus its AnimNode.

Fields

clip: AudioClip

gain: f64

fade_in_secs: f64

fade_out_secs: f64

play_range: Option<Range<f64>>

Implementations

impl AudioTrack

pub fn new(clip: AudioClip) -> Self

A track playing the whole clip at unit gain.

pub fn with_gain(self, gain: f64) -> Self

Set the track’s linear gain.

pub fn with_fade_in(self, secs: f64) -> Self

Fade in linearly over the first secs of the track.

pub fn with_fade_out(self, secs: f64) -> Self

Fade out linearly over the last secs of the track.

pub fn with_play_secs(self, range: Range<f64>) -> Self

Play only the clip’s seconds within range — a content trim, unlike the cell layer’s with_duration, which resamples the sound to fit a new window length.

The range is clamped to the clip: a start before the clip pulls to zero, an end past the clip’s duration truncates, and an empty or reversed span collapses to silence. Content-time zero always plays range.start seconds into the clip.

fn source_span(&self) -> (f64, f64)

The clip-second span actually played: play_range clamped to the clip’s extent.

pub(crate) fn play_window_secs(&self) -> f64

The track’s play length (its whole content axis).

impl AudioTrack

pub(crate) fn sample_at(&self, own: f64) -> [f32; 2]

The stereo sample this track produces at content-time own, or silence when own falls outside the play window.

A pure function of content time — the mixing walk calls it once per output sample. Fades are measured on the same content axis.

pub(crate) fn mix_span_into( &self, a: f64, b: f64, g_lo: usize, g_hi: usize, sample_rate: f64, pcm: &mut [f32], )

Add this track’s samples for global frames [g_lo, g_hi) into pcm (the whole timeline’s interleaved stereo buffer, absolute frame indices), where content time is the affine map t(g) = a + b·(g / sample_rate).

The seal-time bake’s linear fast path: the per-sample math is identical to AudioTrack::sample_at (window, fades and gain all measured on the content axis), arranged as one tight loop over the frames the bake proved audible.

Trait Implementations

impl Clone for AudioTrack

fn clone(&self) -> AudioTrack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AudioTrack

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

Formats the value using the given formatter.