rawsample 0.2.0

A library for working with raw audio samples.
Documentation
  • Coverage
  • 93.62%
    44 out of 47 items documented1 out of 32 items with examples
  • Size
  • Source code size: 45.5 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 2.68 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 13s Average build duration of successful builds.
  • all releases: 13s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • HEnquist/rawsample
    4 2 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • HEnquist

RawSample

A library for working with raw audio samples.

Most audio APIs work with buffers of bytes. To do anything with the sample values, these raw bytes must be converted to and from numeric types.

This library aims to provide the low level tools for converting most common sample formats from raw bytes to float values. Both f32 and f64 are supported, as well as both big-endian and little-endian byte order.

use rawsample::{SampleWriter, SampleReader, SampleFormat};
// create a vec of samples
let values = vec![-0.5, -0.25, -0.125, 0.0, 0.125, 0.25, 0.5];
// create a vec to store raw bytes
let mut rawbytes: Vec<u8> = Vec::new();
// write the samples as raw bytes
f64::write_samples(&values, &mut rawbytes, &SampleFormat::S32LE).unwrap();
// create another vec to store the samples after reading back 
let mut values2 = Vec::new();
let mut slice: &[u8] = &rawbytes;

// read the raw bytes back as samples into the new vec 
f64::read_all_samples(&mut slice, &mut values2, &SampleFormat::S32LE).unwrap();