#audio #riff #sample #wave #pcm

riff-wave

Simple methods for reading and writing PCM wave files

7 releases

Uses old Rust 2015

0.1.3 Jun 22, 2022
0.1.2 May 26, 2016
0.0.3 May 25, 2016

#135 in Audio

Download history 152/week @ 2022-11-28 203/week @ 2022-12-05 277/week @ 2022-12-12 382/week @ 2022-12-19 155/week @ 2022-12-26 128/week @ 2023-01-02 190/week @ 2023-01-09 97/week @ 2023-01-16 278/week @ 2023-01-23 344/week @ 2023-01-30 131/week @ 2023-02-06 271/week @ 2023-02-13 203/week @ 2023-02-20 338/week @ 2023-02-27 187/week @ 2023-03-06 62/week @ 2023-03-13

886 downloads per month
Used in 72 crates (2 directly)

Apache-2.0

67KB
1.5K SLoC

riff-wave

Simple methods for reading and writing PCM wave files.

Examples

Reading a wave file

extern crate riff_wave;

use std::fs::File;
use std::io::BufReader;

use riff_wave::{ReadResult, WaveReader};

fn read_wave() -> ReadResult<()> {
	let file = File::open("examples/hello.wav")?;
	let reader = BufReader::new(file);
	let mut wave_reader = WaveReader::new(reader)?;

	loop {
		wave_reader.read_sample_i16()?;
	}	
}

Writing a wave file

extern crate riff_wave;

use std::f32::consts::PI;
use std::fs::File;
use std::io::BufWriter;

use riff_wave::{WaveWriter, WriteResult};

fn write_wave() -> WriteResult<()> {		
	const SAMPLE_RATE: u32 = 44100;
	const FREQUENCY: f32 = 2.0 * PI * 440.0; // radian per second

	let file = File::create("examples/hello.wav")?;
	let writer = BufWriter::new(file);

	let mut wave_writer = WaveWriter::new(1, SAMPLE_RATE, 16, writer)?;

	for n in 0..SAMPLE_RATE {
		let phase = FREQUENCY * n as f32 / SAMPLE_RATE as f32;
		let sample = (phase.sin() * 0.8 * i16::MAX as f32) as i16;

		wave_writer.write_sample_i16(sample)?;
	}

	Ok(())
}

Documentation

Documentation is available via cargo doc or via this link.

Dependencies

~165KB