diff options
Diffstat (limited to 'src/android/jni/include/AL/oalMacOSX_OALExtensions.h')
| -rw-r--r-- | src/android/jni/include/AL/oalMacOSX_OALExtensions.h | 161 |
1 files changed, 161 insertions, 0 deletions
diff --git a/src/android/jni/include/AL/oalMacOSX_OALExtensions.h b/src/android/jni/include/AL/oalMacOSX_OALExtensions.h new file mode 100644 index 00000000..c3db3054 --- /dev/null +++ b/src/android/jni/include/AL/oalMacOSX_OALExtensions.h @@ -0,0 +1,161 @@ +/********************************************************************************************************************************** +* +* 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__ |