Struct PcmRenderer 

pub struct PcmRenderer {
    pub sample_rate: u32,
    pub channels: u8,
}

A renderer that synthesizes tones into interleaved PCM f32 samples and encodes them as WAV.

Fields

sample_rate: u32

Output sample rate, in hertz.

channels: u8

Output channel count (1 for mono, 2 for stereo).

Implementations

impl PcmRenderer

pub fn new(options: RendererOptions) -> Result<Self, SoundRenderError>

Builds a renderer from validated RendererOptions.

pub fn render_tone(&self, tone: &Tone) -> Vec<f32>

Renders a single tone to interleaved PCM samples, centered in the stereo field.

Examples

use std::time::Duration;
use sim_lib_sound_core::{Frequency, Tone};
use sim_lib_sound_render::{PcmRenderer, RendererOptions};

let renderer = PcmRenderer::new(RendererOptions::new(8_000, 1).unwrap()).unwrap();
let tone = Tone::sine(Frequency::new(440.0).unwrap(), Duration::from_millis(10));
assert_eq!(renderer.render_tone(&tone).len(), 80);

pub fn render_mix(&self, tones: &[ScheduledTone]) -> Vec<f32>

Renders and sums a set of scheduled tones into a single mixed PCM buffer, honoring each tone’s start time and pan.

pub fn write_wav<W: Write>( &self, samples: &[f32], writer: W, ) -> Result<W, SoundRenderError>

Encodes samples as a 16-bit PCM WAV stream to writer, returning the writer on success.

Trait Implementations

impl Clone for PcmRenderer

fn clone(&self) -> PcmRenderer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PcmRenderer

impl Debug for PcmRenderer

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

Formats the value using the given formatter.

impl Eq for PcmRenderer

impl PartialEq for PcmRenderer

fn eq(&self, other: &PcmRenderer) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PcmRenderer