Home

nevrax.com

Nevrax.org News Mailing-list Documentation CVS Bugs License

Documentation                       Search   audio_mixer_user.h Go to the documentation of this file. /* Copyright, 2001 Nevrax Ltd. * * This file is part of NEVRAX NEL. * NEVRAX NEL is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2, or (at your option) * any later version. * NEVRAX NEL is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * You should have received a copy of the GNU General Public License * along with NEVRAX NEL; see the file COPYING. If not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * MA 02111-1307, USA. */ #ifndef NL_AUDIO_MIXER_USER_H #define NL_AUDIO_MIXER_USER_H #include "nel/misc/types_nl.h" #include "nel/sound/u_audio_mixer.h" #include "nel/misc/time_nl.h" #include "driver/source.h" #include "listener_user.h" #include "background_sound_manager.h" #include "mixing_track.h" #include "sound.h" #include <vector> #include <hash_set> #include <list> namespace NLSOUND { class CSimpleSource; class CEnvSoundUser; class CEnvEffect; class CSoundBank; class CSourceCommon; /* * Max number of tracks (physical sources) * * Note: In the Windows implementation of OpenAL, AL_SOURCES_MAX is currently defined to 32 * but seems unused. In alc.c (AL Context implementation), the function alcOpenDevice() contains: * // Check how many Hardware 3D Streaming buffers can be created * device->MaxNoOfSources = dsCaps.dwMaxHw3DStreamingBuffers; * and this value seems to be no more than 32 in DirectX8. */ const uint MAX_TRACKS = 32; template <class Pointer> struct THashPtr : public std::unary_function<const Pointer &, size_t> { size_t operator () (const Pointer &ptr) const { std::hash_set<uint>::hasher h; // transtype the pointer into int then hash it return h.operator()(uint(ptr)); } }; class CAudioMixerUser : public UAudioMixer { public: CAudioMixerUser(); static CAudioMixerUser *instance() { return _Instance; } virtual ~CAudioMixerUser(); virtual void init(/* uint32 balance_period=AUTOBALANCE_DEFAULT_PERIOD */); virtual void setPriorityReserve(TSoundPriority priorityChannel, uint reserve); virtual void setLowWaterMark(uint value); virtual void reset(); virtual void enable( bool b ); // virtual void loadEnvEffects( const char *filename ); virtual uint32 loadSampleBank(bool async, const std::string &filename, std::vector<std::string> *notfoundfiles=NULL ); virtual bool unloadSampleBank( const std::string &filename); virtual void reloadSampleBanks(bool async); virtual uint32 getLoadedSampleSize(); // virtual void loadSoundBank( const std::string &path ); // Load environment sounds ; treeRoot can be null if you don't want an access to the envsounds // virtual void loadEnvSounds( const char *filename, UEnvSound **treeRoot=NULL ); virtual TSoundId getSoundId( const std::string &name ); virtual USource *createSource( const std::string &name, bool spawn=false, TSpawnEndCallback cb=NULL, void *cbUserParam = NULL, CSoundContext *context = 0 ); virtual USource *createSource( TSoundId id, bool spawn=false, TSpawnEndCallback cb=NULL, void *cbUserParam = NULL, CSoundContext *context = 0 ); void addSource( CSourceCommon *source ); virtual void removeSource( CSourceCommon *source ); // void giveTrack( CSimpleSource *source ); // void releaseTrack( CSimpleSource *source ); virtual void setListenerPos (const NLMISC::CVector &pos); virtual UListener *getListener() { return &_Listener; } virtual void selectEnvEffects( const std::string &tag ); virtual void update(); virtual void getSoundNames( std::vector<std::string>& names ) const; virtual uint getPolyphony() const { return _NbTracks; } virtual uint getSourcesNumber() const { return _Sources.size(); } virtual uint getPlayingSourcesNumber() const; virtual uint getNumberAvailableTracks() const; virtual std::string getSourcesStats() const; void applyListenerMove( const NLMISC::CVector& listenerpos ); // CEnvSoundUser *getEnvSounds() { return _EnvSounds; } const NLMISC::CVector& getListenPosVector() const { return _ListenPosition; } // void removeMySource( USource *source ); // void addAmbiantSound( CSound *sound ) { _AmbSounds.insert( sound ); } // Allow to load sound files (nss) when the corresponding wave file is missing (see CSound) //static void allowMissingWave( bool b ) { CSound::allowMissingWave( b ); } virtual void setSamplePath(const std::string& path) { _SamplePath = path; } CBackgroundSoundManager *getBackgroundSoundManager() { return _BackgroundSoundManager; } virtual void writeProfile(std::ostream& out); virtual void loadBackgroundSoundFromRegion (const NLLIGO::CPrimRegion &region); virtual void loadBackgroundEffectsFromRegion (const NLLIGO::CPrimRegion &region); virtual void loadBackgroundSamplesFromRegion (const NLLIGO::CPrimRegion &region); virtual void loadBackgroundSound (const std::string &continent); virtual void playBackgroundSound (); virtual void stopBackgroundSound (); // virtual void setBackgroundSoundDayNightRatio (float ratio) { CBackgroundSoundManager::setDayNightRatio(ratio); } ISoundDriver* getSoundDriver(); void registerBufferAssoc(CSound *sound, IBuffer *buffer); void unregisterBufferAssoc(CSound *sound, IBuffer *buffer); void bufferUnloaded(IBuffer *buffer); void setBackgroundFlags(const TBackgroundFlags &backgroundFlags); // bool setPlaying(CSimpleSource *source); // void unsetPlaying(CSimpleSource *source); CTrack *getFreeTrack(CSimpleSource *source); void freeTrack(CTrack *track); void incPlayingSource() { ++_PlayingSources; }; void decPlayingSource() { --_PlayingSources; }; public: class IMixerUpdate { public: virtual void onUpdate() =0; }; void registerUpdate(IMixerUpdate *pmixerUpdate); void unregisterUpdate(IMixerUpdate *pmixerUpdate); class IMixerEvent { public: virtual void onEvent() =0; }; void addEvent(IMixerEvent *pmixerEvent, const NLMISC::TTime &date); void removeEvents(IMixerEvent *pmixerEvent); void addSourceWaitingForPlay(CSimpleSource *source); private: typedef std::hash_set<CSourceCommon*, THashPtr<CSourceCommon*> > TSourceContainer; typedef std::hash_set<IMixerUpdate*, THashPtr<IMixerUpdate*> > TMixerUpdateContainer; typedef std::hash_map<IBuffer*, std::vector<class CSound*>, THashPtr<IBuffer*> > TBufferToSourceContainer; typedef std::multimap<NLMISC::TTime, IMixerEvent*> TTimedEventContainer; typedef std::multimap<IMixerEvent*, TTimedEventContainer::iterator> TEventContainer; protected: TMixerUpdateContainer _UpdateList; std::vector<std::pair<IMixerUpdate*, bool> > _UpdateEventList; // std::vector<IMixerUpdate*> _UpdateRemoveList; TTimedEventContainer _EventList; TEventContainer _Events; std::vector<std::pair<NLMISC::TTime, IMixerEvent*> > _EventListUpdate; // std::vector<IMixerEvent*> _EventRemoveList; // void balanceSources() { if ( moreSourcesThanTracks() ) redispatchSourcesToTrack(); } void getFreeTracks( uint nb, CTrack **tracks ); // void computeEnvEffect( const NLMISC::CVector& listenerpos, bool force=false ); // bool moreSourcesThanTracks() const { return _NbTracks < _Sources.size(); } // void redispatchSourcesToTrack(); // void removeSource( TSourceContainer::iterator ips); virtual void getPlayingSoundsPos(std::vector<std::pair<bool, NLMISC::CVector> > &pos); private: std::vector<CTrack*> _FreeTracks; std::list<CSimpleSource*> _SourceWaitingForPlay; uint32 _PriorityReserve[NbSoundPriorities]; uint32 _ReserveUsage[NbSoundPriorities]; uint32 _LowWaterMark; static CAudioMixerUser *_Instance; ISoundDriver *_SoundDriver; CBackgroundSoundManager *_BackgroundSoundManager; //TSoundMap _Sounds; // TSoundSet _AmbSounds; CListenerUser _Listener; NLMISC::CVector _ListenPosition; // CEnvSoundUser *_EnvSounds; // uint32 _BalancePeriod; std::string _SamplePath; TBufferToSourceContainer _BufferToSources; // CSoundBank *_SoundBank; public: TSourceContainer _Sources; // TSourceContainer _PlayingSources; uint32 _PlayingSources; // std::vector<CEnvEffect*> _EnvEffects; private: CEnvEffect *_CurEnvEffect; public: // Temp (EDIT) CTrack *_Tracks [MAX_TRACKS]; uint _NbTracks; uint _MaxNbTracks; bool _Leaving; NLMISC::TTicks _StartTime; uint32 curTime() { return (uint32) (NLMISC::CTime::getLocalTime() - _StartTime); } #define NL_PROFILE_MIXER 1 #if NL_PROFILE_MIXER public: double _UpdateTime; double _CreateTime; uint32 _UpdateCount; uint32 _CreateCount; #endif friend struct displaySoundInfoClass; }; const char *getPriorityStr( TSoundPriority p ); } // NLSOUND #endif // NL_AUDIO_MIXER_USER_H /* End of audio_mixer_user.h */