nevrax.org : docs

00001 
+00007 /* Copyright, 2001 Nevrax Ltd.
+00008  *
+00009  * This file is part of NEVRAX NEL.
+00010  * NEVRAX NEL is free software; you can redistribute it and/or modify
+00011  * it under the terms of the GNU General Public License as published by
+00012  * the Free Software Foundation; either version 2, or (at your option)
+00013  * any later version.
+00014 
+00015  * NEVRAX NEL is distributed in the hope that it will be useful, but
+00016  * WITHOUT ANY WARRANTY; without even the implied warranty of
+00017  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+00018  * General Public License for more details.
+00019 
+00020  * You should have received a copy of the GNU General Public License
+00021  * along with NEVRAX NEL; see the file COPYING. If not, write to the
+00022  * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
+00023  * MA 02111-1307, USA.
+00024  */
+00025 
+00026 #ifndef NL_SOUND_DRIVER_AL_H
+00027 #define NL_SOUND_DRIVER_AL_H
+00028 
+00029 #include "nel/misc/types_nl.h"
+00030 #include "sound/driver/sound_driver.h"
+00031 #include "sound/driver/openal/source_al.h"
+00032 #include "sound/driver/openal/buffer_al.h"
+00033 #include <AL/al.h>
+00034 #ifdef NL_OS_WINDOWS
+00035 #include <objbase.h> // needed before eax.h
+00036 #define EAX_AVAILABLE
+00037 #endif
+00038 
+00039 #ifdef EAX_AVAILABLE
+00040 #include <eax.h> // no EAX on Linux !
+00041 #endif
+00042 
+00043 #include <vector>
+00044 
+00045 
+00046 namespace NLSOUND {
+00047 
+00048 
+00049 // alGenBuffers, alGenSources
+00050 //typedef ALAPI ALvoid ALAPIENTRY (*TGenFunctionAL) ( ALsizei, ALuint* );
+00051 typedef ALvoid (*TGenFunctionAL) ( ALsizei, ALuint* );
+00052 
+00053 // alIsBuffer, alIsSource
+00054 //typedef ALAPI ALboolean ALAPIENTRY (*TTestFunctionAL) ( ALuint );
+00055 typedef ALboolean (*TTestFunctionAL) ( ALuint );
+00056 
+00057 
+00058 #ifdef EAX_AVAILABLE
+00059 // EAXSet global function
+00060 extern EAXSet   EAXSetProp;
+00061 
+00062 // EAXGet global function
+00063 extern EAXGet   EAXGetProp;
+00064 #endif
+00065 
+00066 
+00067 #ifdef NL_DEBUG
+00068 void TestALError();
+00069 #else
+00070 #define TestALError() 
+00071 #endif
+00072 
+00073 
+00074 
+00087 class CSoundDriverAL : public ISoundDriver
+00088 {
+00089 public:
+00090 
+00092         CSoundDriverAL();
+00093 
+00095         static CSoundDriverAL   *instance() { return _Instance; }
+00096 
+00098         virtual bool                    init();
+00099 
+00101         virtual IBuffer                 *createBuffer();
+00102 
+00104         virtual IListener               *createListener();
+00105 
+00107         virtual uint                    countMaxSources()       { return 32; }
+00108 
+00110         virtual ISource                 *createSource();
+00111 
+00113         void                                    applyRolloffFactor( float f );
+00114 
+00116         virtual bool                    loadWavFile( IBuffer *destbuffer, const char *filename );
+00117 
+00119         virtual void                    commit3DChanges() {}
+00120 
+00122         virtual void                    writeProfile(std::ostream& out) {}
+00123 
+00124         // Does not create a sound loader
+00125 
+00126 public:
+00127         
+00129         virtual                                 ~CSoundDriverAL();
+00130 
+00131 protected:
+00132 
+00133         friend CBufferAL::~CBufferAL();
+00134         friend CSourceAL::~CSourceAL();
+00135 
+00137         void                                    removeBuffer( IBuffer *buffer );
+00138 
+00140         void                                    removeSource( ISource *source );
+00141 
+00142 protected:
+00143 
+00145         void                                    allocateNewItems( TGenFunctionAL algenfunc, TTestFunctionAL altestfunc,
+00146                                                                                           std::vector<ALuint>& names, uint index, uint nb );
+00147 
+00149         void                                    generateItems( TGenFunctionAL algenfunc, TTestFunctionAL altestfunc, uint nb, ALuint *array );
+00150 
+00152         uint                                    compactAliveNames( std::vector<ALuint>& names, TTestFunctionAL testfunc );
+00153 
+00155         ALuint                                  createItem( TGenFunctionAL algenfunc, TTestFunctionAL altestfunc,
+00156                                                                                 std::vector<ALuint>& names, uint& index, uint allocrate );
+00157 
+00159         bool                                    deleteItem( ALuint name, TGenFunctionAL aldeletefunc, std::vector<ALuint>& names );
+00160         
+00161 private:
+00162 
+00163         // The instance of the singleton
+00164         static CSoundDriverAL   *_Instance;
+00165 
+00166         // Allocated buffers
+00167         std::vector<ALuint>             _Buffers;
+00168 
+00169         // Allocated sources
+00170         std::vector<ALuint>             _Sources;
+00171 
+00172         // Number of exported buffers (including any deleted buffers)
+00173         uint                                    _NbExpBuffers;
+00174 
+00175         // Number of exported sources (including any deleted buffers)
+00176         uint                                    _NbExpSources;
+00177 
+00178         // Rolloff factor (not in the listener in OpenAL, but relative to the sources)
+00179         float                                   _RolloffFactor;
+00180 
+00181 };
+00182 
+00183 
+00184 } // NLSOUND
+00185 
+00186 
+00187 #endif // NL_SOUND_DRIVER_AL_H
+00188 
+00189 /* End of sound_driver_al.h */
+