Mirrors/rodio
2
0
Fork 0
mirror of https://github.com/RustAudio/rodio synced 2024-12-13 21:52:38 +00:00
Code Issues Projects Releases Packages Wiki Activity

Rename Handle to Sink and add methods

Browse source
This commit is contained in:
Pierre Krieger 2015-10-16 15:14:56 +02:00
parent dad2088c39
commit efc00ff834
2 changed files with 20 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
src/engine.rs
View file

@ -121,16 +121,6 @@ impl Engine {
next_sounds: next_sounds,
}
}
/// Starts playing a sound and returns a `Handler` to control it.
// TODO: remove me
pub fn play<S>(&self, endpoint: &Endpoint, source: S) -> Handle
where S: Source + Send + 'static, S::Item: Sample, S::Item: Send
{
let handle = self.start(endpoint);
handle.append(source);
handle
}
}
/// Handle to a playing sound.

28
src/lib.rs
View file

@ -30,9 +30,19 @@ lazy_static! {
/// Handle to a playing sound.
///
/// Note that dropping the handle doesn't stop the sound. You must call `stop` explicitely.
pub struct Handle(engine::Handle<'static>);
pub struct Sink(engine::Handle<'static>);
impl Sink {
pub fn new(endpoint: &Endpoint) -> Sink {
Sink(ENGINE.start(&endpoint))
}
pub fn append<S>(&self, source: S) where S: Source + Send + 'static,
S::Item: Sample, S::Item: Send
{
self.0.append(source);
}
impl Handle {
/// Changes the volume of the sound.
///
/// The value `1.0` is the "normal" volume (unfiltered input). Any value other than 1.0 will
@ -67,18 +77,20 @@ impl Handle {
}
}
/// Plays a sound once. Returns a `Handle` that can be used to control the sound.
/// Plays a sound once. Returns a `Sink` that can be used to control the sound.
#[inline]
pub fn play_once<R>(endpoint: &Endpoint, input: R) -> Handle
pub fn play_once<R>(endpoint: &Endpoint, input: R) -> Sink
where R: Read + Seek + Send + 'static
{
let input = decoder::Decoder::new(input);
Handle(ENGINE.play(&endpoint, input))
play(endpoint, input)
}
/// Plays a sound.
pub fn play<S>(endpoint: &Endpoint, source: S) -> Handle where S: Source + Send + 'static,
S::Item: Sample, S::Item: Send
pub fn play<S>(endpoint: &Endpoint, source: S) -> Sink where S: Source + Send + 'static,
S::Item: Sample, S::Item: Send
{
Handle(ENGINE.play(&endpoint, source))
let sink = Sink::new(endpoint);
sink.append(source);
sink
}