Rust-AO

libao bindings for Rust.

Usage

Build with cargo:

cargo build

Build documentation with rustdoc, rooted at doc/ao/index.html:

cargo doc

Run tests. Tests must not be run in parallel because libao may only be instantiated once in a given process. Running tests concurrently can cause race conditions on library initialization, causing spurious test failure:

REST_TEST_TASKS=1 cargo test

Examples are included in the documentation.

lib.rs:

Bindings to libao, a low-level library for audio output.

use ao::{AO, SampleFormat, Driver, Sample};
use ao::Endianness::Native;
use std::error::Error;
use std::num::Float;
use std::path::Path;

fn main() {
    let lib = AO::init();
    let format = SampleFormat::<i16, &'static str>::new(44100, 1, Native, None);
    let driver = match lib.get_driver("wav") {
        Some(d) => play_sinusoid(d, format),
        None => panic!("No such driver: \"wav\"")
    };
    
}

fn play_sinusoid<S: AsRef<str>>(driver: Driver, format: SampleFormat<i16, S>) {
    match driver.open_file(&format, &Path::new("out.wav"), false) {
        Ok(d) => {
            let samples: Vec<i16> = (0..44100).map(|i| {
                ((1.0 / 44100.0 / 440.0 * i as f32).sin() * 32767.0) as i16
            }).collect();
            d.play(&samples);
        }
        Err(e) => {
            println!("Failed to open output file: {}", e.description());
        }
    }
}