/README.mdown

 1ObjectAL for iPhone, Apple TV, and Mac
 2======================================
 3
 4### Mac, iOS, and TVOS Audio, minus the headache.
 5
 6So you want to add audio to your app. Usually your audio needs are something like:
 7
 8* Play, Pause, Stop, Loop
 9* Volume, Pitch, Pan, Mute
10* Maybe some "power user" stuff, such as preloading and session control
11
12
13### But you want *more* than that.
14
15* You want it to be **intuitive** and **easy**.
16* You want to get up and running **fast**.
17* But most of all, you want it to **JUST BLOODY WORK**!
18
19
20### ObjectAL removes the pain.
21
22ObjectAL shields you from the nastiness of audio programming on iOS and Mac.
23
24* It knows how to manage audio sessions.
25* It knows OpenAL and AVAudioPlayer.
26* It knows what bugs are in which OS version, and how to work around them.
27* It knows how to navigate the arcane APIs and perform the right incantations.
28
29ObjectAL layers all that craziness away, giving you a clean, object oriented, Objective-C interface that just *works*.
30
31
32### With ObjectAL, the simple is easy, and the complex is possible.
33
34
35---------------------------------------------------------------------
36
37
38Find Out More
39-------------
40
41**Homepage:** <http://kstenerud.github.com/ObjectAL-for-iPhone>
42
43**Github:** <http://github.com/kstenerud/ObjectAL-for-iPhone>
44
45**Documentation:** ObjectAL.pdf (in the repository) or <http://kstenerud.github.com/ObjectAL-for-iPhone/documentation>
46
47**Community:** <http://groups.google.com/group/objectal-for-iphone>
48
49**Download:** <http://kstenerud.github.com/ObjectAL-for-iPhone/downloads.html>
50
51**Repository:** ` git clone http://github.com/kstenerud/ObjectAL-for-iPhone.git `
52
53
54---------------------------------------------------------------------
55
56
57License
58-------
59
60Copyright (c) 2009 Karl Stenerud. All rights reserved.
61
62Permission is hereby granted, free of charge, to any person obtaining a copy
63of this software and associated documentation files (the "Software"), to deal
64in the Software without restriction, including without limitation the rights
65to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
66copies of the Software, and to permit persons to whom the Software is
67furnished to do so, subject to the following conditions:
68
69The above copyright notice and this permission notice shall remain in place
70in this source code.
71
72THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
73IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
74FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
75AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
76LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
77OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
78THE SOFTWARE.
79
80Attribution is not required, but appreciated :)