Struct SamplePlayer 

pub struct SamplePlayer { /* private fields */ }

Plays pre-decoded audio samples.

This node plays audio that’s already been decoded into memory as f32 samples. It reports its native sample rate, so Klingt will automatically handle resampling if the output device runs at a different rate.

Example

use symphonium::SymphoniumLoader;
use klingt::{Klingt, nodes::SamplePlayer};

let decoded = SymphoniumLoader::new().load_f32("music.ogg", None)?;
let mut player = SamplePlayer::new(
    decoded.as_interleaved(),
    decoded.channels(),
    decoded.sample_rate,
);
player.set_looping(true);

let mut klingt = Klingt::default_output()?;
let handle = klingt.add(player);
klingt.output(&handle);

Large Files

For very large files, loading everything into memory may not be ideal. Consider implementing a streaming player using a ring buffer fed by a decoder thread.

Implementations

impl SamplePlayer

pub fn new(samples: Vec<f32>, channels: usize, sample_rate: u32) -> Self

Create a player from interleaved audio samples.

Arguments

• samples - Interleaved audio data (L, R, L, R, … for stereo)
• channels - Number of channels in the audio data
• sample_rate - Sample rate of the audio data in Hz

Playback starts immediately. Use PlayerMessage::Pause to start paused.

pub fn set_looping(&mut self, looping: bool)

Enable or disable looping.

When enabled, playback restarts from the beginning when it reaches the end.

pub fn sample_rate(&self) -> u32

Get the source sample rate in Hz.

pub fn channels(&self) -> usize

Get the number of audio channels.

pub fn duration_secs(&self) -> f64

Get the total duration in seconds.

pub fn position_secs(&self) -> f64

Get the current playback position in seconds.

pub fn is_playing(&self) -> bool

Check if playback is currently active.

Trait Implementations

impl AudioNode for SamplePlayer

type Message = PlayerMessage

Message type for parameter updates.

fn process( &mut self, _ctx: &ProcessContext, messages: impl Iterator<Item = PlayerMessage>, _inputs: &[Input], outputs: &mut [Buffer], )

Process one block of audio.

fn num_inputs(&self) -> usize

Number of audio input channels (0 for sources).

fn num_outputs(&self) -> usize

Number of audio output channels.

fn native_sample_rate(&self) -> Option<u32>

Native sample rate of this node, if it has one.