1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105

//!
//! Rust bindings for [Libaudioverse](https://github.com/libaudioverse/libaudioverse), a highly flexible realtime audio synthesis library.
//!

extern crate libaudioverse_sys;

pub mod buffer;
pub mod nodes;
pub mod server;

use std::error;
use std::fmt;
use std::ptr;
use std::result;

use std::os::raw::{c_int, c_char};
use std::ffi::CStr;

use self::libaudioverse_sys::*;

pub use self::buffer::Buffer;
pub use self::nodes::Node;
pub use self::server::Server;

pub use self::nodes::buffer_node::BufferNode;
pub use self::nodes::environment_node::EnvironmentNode;
pub use self::nodes::file_streamer_node::FileStreamerNode;
pub use self::nodes::gain_node::GainNode;
pub use self::nodes::hrtf_node::HrtfNode;
pub use self::nodes::source_node::SourceNode;

pub use self::nodes::properties::bool_property::BoolProperty;
pub use self::nodes::properties::buffer_property::BufferProperty;
pub use self::nodes::properties::distance_model_property::{DistanceModel, DistanceModelProperty};
pub use self::nodes::properties::double_property::DoubleProperty;
pub use self::nodes::properties::float_property::FloatProperty;
pub use self::nodes::properties::float3_property::Float3Property;
pub use self::nodes::properties::float6_property::Float6Property;
pub use self::nodes::properties::node_state_property::{NodeState, NodeStateProperty};
pub use self::nodes::properties::panning_strategy_property::{PanningStrategy, PanningStrategyProperty};

#[derive(Debug)]
pub struct Error {
    pub code: i32,
    pub message: String
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> result::Result<(), fmt::Error> {
        // Displaying an `Error` simply displays the message from libaudioverse
        self.message.fmt(f)
    }
}

impl error::Error for Error {
    fn description(&self) -> &str { &self.message }
}

pub type Result<T> = result::Result<T, Error>;

fn check(code: LavError) -> Result<()> {
    if code == Lav_ERRORS_Lav_ERROR_NONE {
        return Ok(());
    }
    
    let mut msg: *const c_char = ptr::null_mut();
    unsafe {
        // Get the message corresponding to the last error that happened on this thread. 
        // The returned pointer is valid until another error occurs.
        let _error = Lav_errorGetMessage(&mut msg);
        let message = CStr::from_ptr(msg)
            .to_string_lossy()
            .into_owned();
        
        Err(Error {
            code: code as i32,
            message
        })
    }
}

/// Initializes Libaudioverse. Failure to do so will result in crashes. You may initialize the library more than once: subsequent initializations do nothing.
pub fn initialize() -> Result<()> {
    check(unsafe { Lav_initialize() })
}

pub fn is_initialized() -> Result<bool> {
    let mut res : c_int = 0;
    
    check(unsafe { Lav_isInitialized(&mut res) })?;
    Ok(res != 0)
}

/// Deinitializes Libaudioverse. Failure to do so may lead to crashes, depending on what is or is not created. It is not safe to assume that Libaudioverse will properly clean itself up at process exit unless this function is called. You must deinitialize the library exactly as many times as it has been initialized.
pub fn shutdown() -> Result<()> {
    check(unsafe { Lav_shutdown() })
}

#[test]
fn initializes_and_shuts_down() {
    initialize().unwrap();
    assert!(is_initialized().unwrap());
    shutdown().unwrap();
}