AaronCameron.net

I care not for your petty politics.

• 
• 
• 
• 
• 

Not a Member? - Login or Create an Account

Thursday the 24th of May 2012 @ 03:05am

Front Page Journal Projects Your Profile About

LibN2L N2L Home Older News Downloads Documentation (n2l5) Class Hierarchy Compound List File List n2l:: Members Functions Whole n2l:: Ref Documentation (libN2L-4) Class Hierarchy Compound List File List n2l:: Members Functions Whole n2l:: Ref Bugtracker Project Page Report a Bug Bug List Related Things Life 2130 Devel Game Journal

LibN2L-4 Library Code Reference Classes Compounds Files Members Method Index Full Reference cAudioMixer.cpp Go to the documentation of this file. /************************************************************************ Nova-2 Library (libN2L, or simply n2l) Game development C++ Library Copyright (C) 2002 Aaron Cameron This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA A copy of the GNU Lesser General Public License has been provided with this library in the file 'COPYING'. Contact information for the author of this library has been provided with this library in the file 'AUTHOR'. ************************************************************************/ #include "audio/cAudioMixer.h" #include "n2l/vfs.h" #include "audio/cAudioSource.h" #include <stdlib.h> /******************************************************************************/ namespace n2l { const cAudioMixer::tFrequency cAudioMixer::DefaultFrequency = cAudioMixer::tFrequency(MIX_DEFAULT_FREQUENCY); const cAudioMixer::tFormat cAudioMixer::DefaultFormat = cAudioMixer::tFormat(MIX_DEFAULT_FORMAT); const cAudioMixer::tSoundChannels cAudioMixer::DefaultSoundChannels = cAudioMixer::Channels_Stereo; const tSint cAudioMixer::DefaultChunkSize = 4096; const cAudioMixer::tMixChannels cAudioMixer::DefaultMixingChannels = 8; const cAudioMixer::tMixChannels cAudioMixer::MusicChannel = 0; cAutoPtr<cAudioMixer::cSubSysHolder> cAudioMixer::smSubSysHolder = new cAudioMixer::cSubSysHolder(); tBool cAudioMixer::smInited = false; cAudioMixer::tMixChannels cAudioMixer::smNumMixingChannels = 0; cAudioMixer::tSoundDriver cAudioMixer::smDriver = cAudioMixer::SoundDriver_Auto; cAudioMixer::tChannelSourceMap cAudioMixer::mChannelSourceMap; /**************************************************************************/ cAudioMixer::cSubSysHolder::cSubSysHolder() { } /**************************************************************************/ cAudioMixer::cSubSysHolder::~cSubSysHolder() { cAudioMixer::closeAudio(); } /**************************************************************************/ void cAudioMixer::setDriver( const tSoundDriver &iDriver ) { boundCheckSoundDriver( iDriver ); smDriver = iDriver; } /**************************************************************************/ const cAudioMixer::tSoundDriver cAudioMixer::getDriver() { return smDriver; } /**************************************************************************/ void cAudioMixer::openAudio( const tFrequency iFrequency, const tFormat iFormat, const tSoundChannels iSoundChannels, const tSint iChunkSize ) { // Make sure things are as they should be. boundCheckFrequency( iFrequency ); boundCheckFormat( iFormat ); boundCheckSoundChannels( iSoundChannels ); boundCheckChunkSize( iChunkSize ); // Choose a driver. if (smDriver == SoundDriver_Null) return; else if (smDriver == SoundDriver_Auto) n2lUnsetEnv( "SDL_AUDIODRIVER" ); else { if (!n2lSetEnv( "SDL_AUDIODRIVER", envStringForDriver(smDriver).c_str())) { throw cDriverLayerException( "cAudioMixer::openAudio", "Failed to select a driver", "Environment", "Environment out of space" ); } } requireSDLSubSystem( SDLSubSystemInitFlag_Audio ); // Set up the mixing device. if (-1==Mix_OpenAudio( tSint(iFrequency), tUint16(iFormat), tSint(iSoundChannels), tSint(iChunkSize) )) throw cDriverLayerException("cAudioMixer::openAudio", "Failed to open audio", "SDL_mixer", Mix_GetError() ); Mix_AllocateChannels( DefaultMixingChannels ); // Until Mix_loadMUS_RW is implemented, we'll reserve the // first channel for music, and play it like a regular sample. # ifdef N2L_FakeMusic Mix_ReserveChannels(1); smNumMixingChannels = DefaultMixingChannels-1; # else smNumMixingChannels = DefaultMixingChannels; # endif // Set a callback to multiplex the channel finishing code. Mix_ChannelFinished( cAudioMixer::mixerSampleFinishedCallback ); smInited = true; } /**************************************************************************/ void cAudioMixer::closeAudio() { if (smInited) { Mix_CloseAudio(); releaseSDLSubSystem( SDLSubSystemInitFlag_Audio ); smInited = false; } } /**************************************************************************/ const cAudioMixer::tFrequency cAudioMixer::frequency() { if (!smInited) throw cBadDataUseException( "cAudioMixer::frequency", "Mixer isn\'t running" ); int frequency, channels; tUint16 format; Mix_QuerySpec(&frequency, &format, &channels); return frequency; } /**************************************************************************/ const cAudioMixer::tFormat cAudioMixer::format() { if (!smInited) throw cBadDataUseException( "cAudioMixer::format", "Mixer isn\'t running" ); int frequency, channels; tUint16 format; Mix_QuerySpec(&frequency, &format, &channels); switch (format) { case AUDIO_U8: return Format_U8; case AUDIO_S8: return Format_S8; case AUDIO_U16LSB: return Format_U16LSB; case AUDIO_S16LSB: return Format_S16LSB; case AUDIO_U16MSB: return Format_U16MSB; case AUDIO_S16MSB: return Format_S16MSB; default: return Format_Unknown; } } /**************************************************************************/ const tUint cAudioMixer::sampleSize() { switch (format()) { case Format_U8: return 1; case Format_S8: return 1; case Format_U16LSB: return 2; case Format_S16LSB: return 2; case Format_U16MSB: return 2; case Format_S16MSB: return 2; default: return 0; } } /**************************************************************************/ const tString & cAudioMixer::formatAsString() { if (!smInited) throw cBadDataUseException( "cAudioMixer::formatAsString", "Mixer isn\'t running" ); int frequency, channels; tUint16 format; Mix_QuerySpec(&frequency, &format, &channels); static const tString AUDIO_U8_String("Unsigned 8-bit"); static const tString AUDIO_S8_String("Signed 8-bit"); static const tString AUDIO_U16LSB_String("Unsigned 16-bit LSB"); static const tString AUDIO_S16LSB_String("Signed 16-bit LSB"); static const tString AUDIO_U16MSB_String("Unsigned 16-bit MSB"); static const tString AUDIO_S16MSB_String("Signed 16-bit MSB"); // We don't do the system types because they just become one // of the other, already defined types. static const tString Format_Unknown_String("Unknown Format"); switch (format) { case AUDIO_U8: return AUDIO_U8_String; case AUDIO_S8: return AUDIO_S8_String; case AUDIO_U16LSB: return AUDIO_U16LSB_String; case AUDIO_S16LSB: return AUDIO_S16LSB_String; case AUDIO_U16MSB: return AUDIO_U16MSB_String; case AUDIO_S16MSB: return AUDIO_S16MSB_String; default: return Format_Unknown_String; } } /**************************************************************************/ const cAudioMixer::tSoundChannels cAudioMixer::soundChannels() { if (!smInited) throw cBadDataUseException( "cAudioMixer::formatAsString", "Mixer isn\'t running" ); int frequency, channels; tUint16 format; Mix_QuerySpec(&frequency, &format, &channels); if (channels==1) return Channels_Mono; else return Channels_Stereo; } /**************************************************************************/ void cAudioMixer::allocateMixingChannels( const tMixChannels iNum ) { if (!smInited) throw cBadDataUseException( "cAudioMixer::allocateMixingChannels", "Mixer isn\'t running" ); // Make sure there's at least one free channel, and one channel // for music if we need it. # ifdef N2L_FakeMusic const tSint MinChannels( 2 ); smNumMixingChannels = iNum-1; # else const tSint MinChannels( 1 ); smNumMixingChannels = iNum; # endif if (iNum<MinChannels) throw cOutOfBoundsException( "cAudioMixer::allocateMixingChannels", "Too few channels allocated" ); Mix_AllocateChannels( iNum ); } /**************************************************************************/ const tUint cAudioMixer::numChannelsPlaying() { if (!smInited) return 0; const tUint NumChannels( Mix_Playing(-1) ); # ifdef N2L_FakeMusic if (Mix_Playing(MusicChannel)) return NumChannels-1; # endif return NumChannels; } /**************************************************************************/ const tUint cAudioMixer::numFreeChannels() { if (!smInited) throw cBadDataUseException( "cAudioMixer::numFreeChannels", "Mixer isn\'t running" ); return smNumMixingChannels-numChannelsPlaying(); } /**************************************************************************/ const tUint cAudioMixer::numChannels() { if (!smInited) throw cBadDataUseException( "cAudioMixer::numChannels", "Mixer isn\'t running" ); return smNumMixingChannels; } /**************************************************************************/ void cAudioMixer::musicVolume( const tSint iVolume ) { if (!smInited) return; # ifdef N2L_FakeMusic Mix_Volume(MusicChannel,iVolume); # else Mix_VolumeMusic( iVolume ); # endif } /**************************************************************************/ void cAudioMixer::musicVolume( const tFloat iVolume ) { if (!smInited) return; const tFloat ClampedVolume( n2l_max(n2l_min(iVolume,1.0f),0.0f) ); # ifdef N2L_FakeMusic Mix_Volume(MusicChannel, tSint( ClampedVolume*tFloat(MIX_MAX_VOLUME) ) ); # else Mix_VolumeMusic( tSint( ClampedVolume*tFloat(MIX_MAX_VOLUME) ) ); # endif } /**************************************************************************/ void cAudioMixer::fadeOutMusic( const tUint iMilliseconds ) { if (!smInited) throw cBadDataUseException( "cAudioMixer::fadeOutMusic", "Mixer isn\'t running" ); # ifdef N2L_FakeMusic Mix_FadeOutChannel( MusicChannel, iMilliseconds ); # else Mix_FadeOutMusic( iMilliseconds ); # endif } /**************************************************************************/ const cAudioMixer::tFadeStatus cAudioMixer::musicFadeStatus() { if (!smInited) return Fading_None; # ifdef N2L_FakeMusic return tFadeStatus(Mix_FadingChannel( MusicChannel )); # else return tFadeStatus(Mix_FadingMusic()); # endif } /**************************************************************************/ void cAudioMixer::channelVolume( const tAudioChannel iChannel, const tFloat &iVolume ) { if (!smInited) throw cBadDataUseException( "cAudioMixer::channelVolume", "Mixer isn\'t running" ); if (Mix_AllocateChannels(-1)<=iChannel) throw cOutOfBoundsException( "cAudioMixer::channelVolume", tString("Channel volume set on non-existent channel: ")+ asString(iChannel) ); Mix_Volume( iChannel, tSint(128.0f*n2lMax(0.0f,n2lMin(1.0f,iVolume))) ); } /**************************************************************************/ const tString &cAudioMixer::driverName( const tSoundDriver &iDriver ) { static const tString DrvStrings[SoundDriver_NumSoundDrivers] = { "Auto-Detect", "OpenBSD", "OSS DSP", "ALSA", "/dev/audio Audio", "AL (Irix)", "ARTS Audio Daemon", "ESound Audio Daemon", "NAS Audio Daemon", "OSS DMA", "Win32 DirectX", "Win32 WaveOut", "BeOS baudio", "MacOS SoundManager", "AIX paud", "AHI Amiga", "Disk Output", "Null" }; if (iDriver<SoundDriver_Auto || iDriver>=SoundDriver_NumSoundDrivers) throw cOutOfBoundsException( "cAudioMixer::driverName", "Driver requested does not exist" ); return DrvStrings[ iDriver ]; } /**************************************************************************/ const tString &cAudioMixer::driverName() { return driverName(smDriver); } /**************************************************************************/ void cAudioMixer::registerSource( cAudioSource *ioSource ) { if (!smInited) throw cBadDataUseException( "cAudioMixer::registerSource", "Mixer isn\'t running" ); mChannelSourceMap[ioSource->currentChannel()] = ioSource; } /**************************************************************************/ void cAudioMixer::unregisterSource( cAudioSource *ioSource ) { if (!smInited) throw cBadDataUseException( "cAudioMixer::unregisterSource", "Mixer isn\'t running" ); tChannelSourceMap::iterator i = mChannelSourceMap.find( ioSource->currentChannel() ); if (i == mChannelSourceMap.end()) return; if (i->second == ioSource) i->second = 0; } /**************************************************************************/ void cAudioMixer::boundCheckFrequency( const tFrequency iFrequency ) { if (iFrequency <= 0) throw cOutOfBoundsException( "cAudioMixer::boundCheckFrequency", "Frequency out of range ( <=0 )" ); } /**************************************************************************/ void cAudioMixer::boundCheckFormat( const tFormat iFormat ) { if (iFormat == Format_U8 || iFormat == Format_S8 || iFormat == Format_U16LSB || iFormat == Format_S16LSB || iFormat == Format_U16MSB || iFormat == Format_S16MSB || iFormat == Format_U16SYS || iFormat == Format_S16SYS) return; throw cOutOfBoundsException( "cAudioMixer::boundCheckFormat", "Format out of range" ); } /**************************************************************************/ void cAudioMixer::boundCheckSoundChannels( const tSoundChannels iChannels ) { if (iChannels!=Channels_Mono && iChannels!=Channels_Stereo) throw cOutOfBoundsException( "cAudioMixer::boundCheckSoundChannels", "Num channels out of range" ); } /**************************************************************************/ void cAudioMixer::boundCheckChunkSize( const tSint iChunkSize ) { if (iChunkSize<=0) throw cOutOfBoundsException( "cAudioMixer::boundCheckChunkSize", "Chunk size out of range" ); } /**************************************************************************/ void cAudioMixer::boundCheckSoundDriver( const tSoundDriver &iDriver ) { if (iDriver<SoundDriver_Auto || iDriver>=SoundDriver_NumSoundDrivers) throw cOutOfBoundsException( "cAudioMixer::boundCheckSoundDriver", "Driver doesn\'t exist", asString(tUint(iDriver)) ); } /**************************************************************************/ const tString &cAudioMixer::envStringForDriver( const tSoundDriver &iDriver ) { static const tString DrvStrings[SoundDriver_NumSoundDrivers] = { "", "openbsd", "dsp", "alsa", "audio", "AL", "artsc", "esd", "nas", "dma", "dsound", "waveout", "baudio", "sndmgr", "paud", "AHI", "disk", "null" }; if (iDriver<SoundDriver_Auto || iDriver>=SoundDriver_NumSoundDrivers) throw cOutOfBoundsException( "cAudioMixer::envStringForDriver", "Driver requested does not exist" ); return DrvStrings[ iDriver ]; } /**************************************************************************/ void cAudioMixer::mixerSampleFinishedCallback( int iChannel ) { tChannelSourceMap::iterator i = mChannelSourceMap.find( iChannel ); if (i == mChannelSourceMap.end() || i->second == 0) return; if (i->second->currentChannel() == iChannel) i->second = 0; } } // namespace

©2012 Aaron Cameron