cpal/src/lib.rs

55 lines
1.4 KiB
Rust
Raw Normal View History

2014-12-11 16:23:33 +00:00
#![feature(unsafe_destructor)]
2014-12-11 13:22:55 +00:00
#[cfg(all(not(windows)))]
use this_platform_is_not_supported;
#[cfg(windows)]
#[path="wasapi/mod.rs"]
2014-12-11 15:28:26 +00:00
pub mod cpal_impl;
2014-12-11 16:23:33 +00:00
2014-12-11 17:09:48 +00:00
/// A `Channel` represents a sound output.
///
/// A channel must be periodically filled with new data, or the sound will
/// stop playing.
2014-12-11 16:23:33 +00:00
pub struct Channel(cpal_impl::Channel);
2014-12-11 17:09:48 +00:00
/// Represents a buffer that must be filled with audio data.
///
/// A `Buffer` object borrows the channel.
2014-12-11 16:23:33 +00:00
pub struct Buffer<'a, T>(cpal_impl::Buffer<'a, T>);
impl Channel {
pub fn new() -> Channel {
let channel = cpal_impl::Channel::new();
Channel(channel)
}
2014-12-11 17:09:48 +00:00
/// Returns the number of channels.
///
/// 1 for mono, 2 for stereo, etc.
2014-12-11 16:23:33 +00:00
pub fn get_channels(&self) -> u16 {
self.0.get_channels()
}
2014-12-11 17:09:48 +00:00
/// Adds some PCM data to the channel's buffer.
///
/// This function returns a `Buffer` object that must be filled with the audio data.
/// You can't know in advance the size of the buffer, as it depends on the current state
/// of the backend.
2014-12-11 16:23:33 +00:00
pub fn append_data<'a, T>(&'a mut self) -> Buffer<'a, T> {
Buffer(self.0.append_data())
}
}
impl<'a, T> Deref<[T]> for Buffer<'a, T> {
fn deref(&self) -> &[T] {
panic!()
}
}
impl<'a, T> DerefMut<[T]> for Buffer<'a, T> {
fn deref_mut(&mut self) -> &mut [T] {
self.0.get_buffer()
}
}