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 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
// The MIT License (MIT) // // Copyright (c) 2013 Jeremy Letang (letang.jeremy@gmail.com) // // Permission is hereby granted, free of charge, to any person obtaining a copy of // this software and associated documentation files (the "Software"), to deal in // the Software without restriction, including without limitation the rights to // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of // the Software, and to permit persons to whom the Software is furnished to do so, // subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS // FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR // COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER // IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN // CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. /*! # ears __ears__ is a simple library for play Sounds and Musics in Rust. __ears__ is build on the top of OpenAL and libsndfile. * Provide anaccess to the OpenAL spatialization functionality in a simple way. * Accept a lot of audio formats thanks to libsndfile. # Example ```no_run extern crate ears; use ears::{Sound, AudioController}; fn main() { // Create a new Sound. let mut snd = Sound::new("path/to/my/sound.ogg").unwrap(); // Play the Sound snd.play(); // Wait until the end of the sound while snd.is_playing() {} } ``` # Functionnality __ears__ provide two way for play audio files. * The Sound class, which represent light sounds who can share a buffer of samples with another Sound. * The Music class, which is a bigger sound and who can't share sample buffer. # Use ears As said before, __ears__ require OpenAL and libsndfile, you need to install these two librarieson your system. Then import stuff from __ears__ in your project, you can import all the stuff: ```rust extern crate ears; use ears::*; # fn main() {} ``` or a specific one: ```rust extern crate ears; use ears::Music; # fn main() {} ``` */ #![crate_name = "ears"] //#![desc = "Easy Api in Rust for Sounds"] //#![license = "MIT"] #![crate_type = "dylib"] #![crate_type = "rlib"] #![allow(dead_code, unused_attributes)] //#![feature(macro_rules)] //#![feature(unsafe_destructor)] #![allow(unused_imports)] //#![allow(raw_pointer_derive)] #![allow(unused_must_use)] //#![allow(improper_ctypes)] extern crate libc; // Reexport public API pub use einit::{init, init_in}; pub use music::Music; pub use sound::Sound; pub use states::State; pub use sound_data::SoundData; pub use audio_controller::AudioController; pub use audio_tags::{AudioTags, Tags}; pub use recorder::Recorder; pub use record_context::RecordContext; // Hidden internal bindings mod internal; mod openal; mod sndfile; // The public ears API #[path = "init.rs"] mod einit; pub mod listener; mod sound; mod music; mod sound_data; mod states; mod audio_controller; mod audio_tags; mod recorder; mod record_context;