| @ -1,161 +0,0 @@ | |||
| /********************************************************************************************************************************** | |||
| * | |||
| * OpenAL cross platform audio library | |||
| * Copyright (c) 2004-2006, Apple Computer, Inc. All rights reserved. | |||
| * Copyright (c) 2007-2008, Apple Inc. All rights reserved. | |||
| * | |||
| * Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following | |||
| * conditions are met: | |||
| * | |||
| * 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. | |||
| * 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following | |||
| * disclaimer in the documentation and/or other materials provided with the distribution. | |||
| * 3. Neither the name of Apple Inc. ("Apple") nor the names of its contributors may be used to endorse or promote products derived | |||
| * from this software without specific prior written permission. | |||
| * | |||
| * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | |||
| * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS | |||
| * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |||
| * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED | |||
| * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN | |||
| * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |||
| * | |||
| **********************************************************************************************************************************/ | |||
| #ifndef __OAL_MAC_OSX_OAL_EXTENSIONS_H__ | |||
| #define __OAL_MAC_OSX_OAL_EXTENSIONS_H__ | |||
| #include <OpenAL/al.h> | |||
| /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ | |||
| /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |||
| ALC_EXT_MAC_OSX | |||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ | |||
| // Retrieve functions via alGetProcAddress() by passing in strings: alcMacOSXMixerOutputRate or alcMacOSXGetMixerOutputRate | |||
| // Setting the Mixer Output Rate effectively sets the samnple rate at which the mixer | |||
| typedef ALvoid (*alcMacOSXRenderingQualityProcPtr) (ALint value); | |||
| typedef ALvoid (*alMacOSXRenderChannelCountProcPtr) (ALint value); | |||
| typedef ALvoid (*alcMacOSXMixerMaxiumumBussesProcPtr) (ALint value); | |||
| typedef ALvoid (*alcMacOSXMixerOutputRateProcPtr) (ALdouble value); | |||
| typedef ALint (*alcMacOSXGetRenderingQualityProcPtr) (); | |||
| typedef ALint (*alMacOSXGetRenderChannelCountProcPtr) (); | |||
| typedef ALint (*alcMacOSXGetMixerMaxiumumBussesProcPtr) (); | |||
| typedef ALdouble (*alcMacOSXGetMixerOutputRateProcPtr) (); | |||
| /* Render Quality. Used with alcMacOSXRenderingQuality() */ | |||
| #define ALC_MAC_OSX_SPATIAL_RENDERING_QUALITY_HIGH 'rqhi' | |||
| #define ALC_MAC_OSX_SPATIAL_RENDERING_QUALITY_LOW 'rdlo' | |||
| // High Quality Spatial Algorithm suitable only for headphone use | |||
| #define ALC_IPHONE_SPATIAL_RENDERING_QUALITY_HEADPHONES 'hdph' | |||
| /* | |||
| Render Channels. Used with alMacOSXRenderChannelCount() | |||
| Allows a user to force OpenAL to render to stereo, regardless of the audio hardware being used | |||
| */ | |||
| #define ALC_MAC_OSX_RENDER_CHANNEL_COUNT_STEREO 'rcst' | |||
| /* GameKit extension */ | |||
| #define AL_GAMEKIT 'gksr' | |||
| /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |||
| AL_EXT_SOURCE_NOTIFICATIONS | |||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ | |||
| /* | |||
| Source Notifications | |||
| Eliminates the need for continuous polling for source state by providing a | |||
| mechanism for the application to receive source state change notifications. | |||
| Upon receiving a notification, the application can retrieve the actual state | |||
| corresponding to the notification ID for which the notification was sent. | |||
| */ | |||
| #define AL_QUEUE_HAS_LOOPED 0x9000 | |||
| /* | |||
| Notification Proc: ALSourceNotificationProc | |||
| sid - source id | |||
| notificationID - id of state that has changed | |||
| userData - user data provided to alSourceAddNotification() | |||
| */ | |||
| typedef ALvoid (*alSourceNotificationProc)(ALuint sid, ALuint notificationID, ALvoid* userData); | |||
| /* | |||
| API: alSourceAddNotification | |||
| sid - source id | |||
| notificationID - id of state for which caller wants to be notified of a change | |||
| notifyProc - notification proc | |||
| userData - ptr to applications user data, will be returned in the notification proc | |||
| Returns AL_NO_ERROR if request is successful. | |||
| Valid IDs: | |||
| AL_SOURCE_STATE | |||
| AL_BUFFERS_PROCESSED | |||
| AL_QUEUE_HAS_LOOPED - notification sent when a looping source has looped to it's start point | |||
| */ | |||
| typedef ALenum (*alSourceAddNotificationProcPtr) (ALuint sid, ALuint notificationID, alSourceNotificationProc notifyProc, ALvoid* userData); | |||
| /* | |||
| API: alSourceRemoveStateNotification | |||
| sid - source id | |||
| notificationID - id of state for which caller wants to remove an existing notification | |||
| notifyProc - notification proc | |||
| userData - ptr to applications user data, will be returned in the notification proc | |||
| */ | |||
| typedef ALvoid (*alSourceRemoveNotificationProcPtr) (ALuint sid, ALuint notificationID, alSourceNotificationProc notifyProc, ALvoid* userData); | |||
| /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |||
| ALC_EXT_ASA : Apple Spatial Audio Extension | |||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ | |||
| /* | |||
| Used with the ASA API calls: alcASAGetSource(), alcASASetSource(), alcASAGetListener(), alcASASetListener() | |||
| */ | |||
| typedef ALenum (*alcASAGetSourceProcPtr) (ALuint property, ALuint source, ALvoid *data, ALuint* dataSize); | |||
| typedef ALenum (*alcASASetSourceProcPtr) (ALuint property, ALuint source, ALvoid *data, ALuint dataSize); | |||
| typedef ALenum (*alcASAGetListenerProcPtr) (ALuint property, ALvoid *data, ALuint* dataSize); | |||
| typedef ALenum (*alcASASetListenerProcPtr) (ALuint property, ALvoid *data, ALuint dataSize); | |||
| /* listener properties */ | |||
| #define ALC_ASA_REVERB_ON 'rvon' // type ALuint | |||
| #define ALC_ASA_REVERB_GLOBAL_LEVEL 'rvgl' // type ALfloat -40.0 db - 40.0 db | |||
| #define ALC_ASA_REVERB_ROOM_TYPE 'rvrt' // type ALint | |||
| /* reverb room type presets for the ALC_ASA_REVERB_ROOM_TYPE property */ | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_SmallRoom 0 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_MediumRoom 1 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_LargeRoom 2 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_MediumHall 3 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_LargeHall 4 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_Plate 5 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_MediumChamber 6 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_LargeChamber 7 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_Cathedral 8 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_LargeRoom2 9 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_MediumHall2 10 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_MediumHall3 11 | |||
| #define ALC_ASA_REVERB_ROOM_TYPE_LargeHall2 12 | |||
| #define ALC_ASA_REVERB_EQ_GAIN 'rveg' // type ALfloat | |||
| #define ALC_ASA_REVERB_EQ_BANDWITH 'rveb' // type ALfloat | |||
| #define ALC_ASA_REVERB_EQ_FREQ 'rvef' // type ALfloat | |||
| /* source properties */ | |||
| #define ALC_ASA_REVERB_SEND_LEVEL 'rvsl' // type ALfloat 0.0 (dry) - 1.0 (wet) (0-100% dry/wet mix, 0.0 default) | |||
| #define ALC_ASA_OCCLUSION 'occl' // type ALfloat -100.0 db (most occlusion) - 0.0 db (no occlusion, 0.0 default) | |||
| #define ALC_ASA_OBSTRUCTION 'obst' // type ALfloat -100.0 db (most obstruction) - 0.0 db (no obstruction, 0.0 default) | |||
| #endif // __OAL_MAC_OSX_OAL_EXTENSIONS_H__ | |||