Second Life Viewer: LLAudioEngine Class Reference

typedef std::map<LLUUID, LLAudioData *> LLAudioEngine::data_map [protected]

Definition at line 217 of file audioengine.h.

typedef std::map<LLUUID, LLAudioSource *> LLAudioEngine::source_map [protected]

Definition at line 216 of file audioengine.h.

LLAudioEngine::LLAudioEngine ( )

Definition at line 61 of file audioengine.cpp.

LLAudioEngine::~LLAudioEngine ( ) [virtual]

Definition at line 66 of file audioengine.cpp.

void LLAudioEngine::addAudioSource ( LLAudioSource * asp )

Definition at line 884 of file audioengine.cpp.

References LLAudioSource::getID(), and mAllSources.

Referenced by LLViewerObject::getAudioSource(), and triggerSound().

virtual void LLAudioEngine::allocateListener ( ) [protected, pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by init().

void LLAudioEngine::assetCallback	(	LLVFS *	vfs,
		const LLUUID &	uuid,
		LLAssetType::EType	type,
		void *	user_data,
		S32	result_code,
		LLExtStat	ext_status
	)			`[static]`

Definition at line 1131 of file audioengine.cpp.

References LLAudioDecodeMgr::addDecodeRequest(), FALSE, gAudioDecodeMgrp, gAudiop, getAudioData(), LLAssetStorage::getErrorString(), llendl, llinfos, llwarns, mCurrentTransfer, LLUUID::null, LLAudioData::setHasDecodedData(), LLAudioData::setHasLocalData(), LLAudioData::setHasValidData(), startNextTransfer(), and TRUE.

Referenced by startNextTransfer().

void LLAudioEngine::cleanupAudioSource ( LLAudioSource * asp )

Definition at line 890 of file audioengine.cpp.

References LLAudioSource::getID(), llendl, llwarns, and mAllSources.

Referenced by LLViewerObject::setAttachedSound().

void LLAudioEngine::cleanupBuffer ( LLAudioBuffer * bufferp )

Definition at line 577 of file audioengine.cpp.

References i, MAX_BUFFERS, mBuffers, NULL, and S32.

Referenced by LLAudioData::load().

virtual void LLAudioEngine::cleanupWind ( ) [protected, pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by enableWind().

void LLAudioEngine::commitDeferredChanges ( ) [protected]

Definition at line 845 of file audioengine.cpp.

References LLListener::commitDeferredChanges(), and mListenerp.

Referenced by idle().

virtual LLAudioBuffer* LLAudioEngine::createBuffer ( ) [protected, pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by getFreeBuffer().

virtual LLAudioChannel* LLAudioEngine::createChannel ( ) [protected, pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by getFreeChannel().

void LLAudioEngine::enableWind ( BOOL state_b ) [virtual]

Definition at line 463 of file audioengine.cpp.

References cleanupWind(), initWind(), and mEnableWind.

Referenced by audio_update_volume(), setMuted(), and toggle_wind_audio().

LLAudioSource * LLAudioEngine::findAudioSource ( const LLUUID & source_id )

Definition at line 851 of file audioengine.cpp.

References mAllSources, and NULL.

LLAudioData * LLAudioEngine::getAudioData ( const LLUUID & audio_uuid )

Definition at line 867 of file audioengine.cpp.

References mAllData.

Referenced by assetCallback(), LLAudioSource::play(), preloadSound(), process_preload_sound(), and LLAudioDecodeMgr::Impl::processQueue().

F32 LLAudioEngine::getDistanceFactor ( ) [virtual]

Definition at line 810 of file audioengine.cpp.

References LLListener::getDistanceFactor(), and mListenerp.

F32 LLAudioEngine::getDopplerFactor ( ) [virtual]

Definition at line 788 of file audioengine.cpp.

References LLListener::getDopplerFactor(), and mListenerp.

LLAudioBuffer * LLAudioEngine::getFreeBuffer ( )

Definition at line 478 of file audioengine.cpp.

References createBuffer(), i, llendl, llinfos, LLAudioBuffer::mAudioDatap, MAX_BUFFERS, LLAudioData::mBufferp, mBuffers, NULL, and S32.

Referenced by LLAudioData::load().

LLAudioChannel * LLAudioEngine::getFreeChannel ( const F32 priority )

Definition at line 522 of file audioengine.cpp.

References LLAudioChannel::cleanup(), createChannel(), LLAudioSource::getPriority(), LLAudioChannel::getSource(), i, mChannels, mNumChannels, NULL, S32, and LLAudioSource::setChannel().

Referenced by idle(), and LLAudioSource::setupChannel().

F32 LLAudioEngine::getInternetStreamGain ( )

Definition at line 633 of file audioengine.cpp.

References mInternetStreamGain.

virtual void LLAudioEngine::getInternetStreamInfo	(	char *	artist,
		char *	title
	)			`[inline, virtual]`

Reimplemented in LLAudioEngine_FMOD.

Definition at line 143 of file audioengine.h.

virtual const char* LLAudioEngine::getInternetStreamURL ( ) [inline, virtual]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 146 of file audioengine.h.

Referenced by LLViewerParcelMgr::processParcelProperties().

LLVector3 LLAudioEngine::getListenerPos ( ) [virtual]

Definition at line 742 of file audioengine.cpp.

References LLListener::getPosition(), mListenerp, and LLVector3::zero.

Referenced by LLAudioSource::updatePriority().

F32 LLAudioEngine::getMasterGain ( )

Definition at line 628 of file audioengine.cpp.

References mMasterGain.

Referenced by idle().

virtual BOOL LLAudioEngine::getMuted ( ) const [inline, virtual]

Definition at line 111 of file audioengine.h.

References mMuted.

Referenced by idle(), and startNextTransfer().

F32 LLAudioEngine::getRolloffFactor ( ) [virtual]

Definition at line 832 of file audioengine.cpp.

References LLListener::getRolloffFactor(), and mListenerp.

BOOL LLAudioEngine::hasDecodedFile ( const LLUUID & uuid )

Definition at line 904 of file audioengine.cpp.

References FALSE, LLDir::fileExists(), gDirUtilp, LLDir::getExpandedFilename(), LL_PATH_CACHE, LLUUID::toString(), TRUE, and UUID_STR_LENGTH.

Referenced by LLAudioDecodeMgr::addDecodeRequest(), LLAudioData::LLAudioData(), and LLAudioDecodeMgr::Impl::processQueue().

BOOL LLAudioEngine::hasLocalFile ( const LLUUID & uuid )

Definition at line 924 of file audioengine.cpp.

References LLAssetType::AT_SOUND, LLVFS::getExists(), and gVFS.

void LLAudioEngine::idle ( F32 max_decode_time = 0.f ) [virtual]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 165 of file audioengine.cpp.

References commitDeferredChanges(), default_max_decode_time, f, FALSE, gAudioDecodeMgrp, LLAudioSource::getChannel(), getFreeChannel(), getMasterGain(), getMuted(), i, LLAudioChannel::isPlaying(), LLAudioSource::isSyncSlave(), mAllSources, MAX_BUFFERS, MAX_CHANNELS, mBuffers, mChannels, LLAudioChannel::mLoopedThisFrame, NULL, LLAudioChannel::playSynced(), LLAudioDecodeMgr::processQueue(), S32, LLAudioSource::setChannel(), setInternalGain(), LLAudioChannel::setWaiting(), startNextTransfer(), TRUE, LLAudioChannel::updateBuffer(), updateBufferForData(), and updateChannels().

Referenced by idle(), and LLAudioEngine_FMOD::idle().

BOOL LLAudioEngine::init	(	const S32	num_channels,
		void *	userdata
	)			`[virtual]`

Reimplemented in LLAudioEngine_FMOD.

Definition at line 71 of file audioengine.cpp.

References allocateListener(), FALSE, gAudioDecodeMgrp, i, MAX_BUFFERS, mBuffers, mChannels, mEnableWind, mInternetStreamGain, mLastStatus, mMasterGain, mMaxWindGain, mMuted, mNumChannels, mUserData, NULL, S32, and TRUE.

Referenced by idle_startup(), and LLAudioEngine_FMOD::init().

virtual void LLAudioEngine::initInternetStream ( ) [inline, protected, virtual]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 184 of file audioengine.h.

virtual void LLAudioEngine::initWind ( ) [protected, pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by enableWind().

virtual int LLAudioEngine::isInternetStreamPlaying ( ) [pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by LLOverlayBar::enableMusicButtons(), and LLAudioStreamMusicListener::handleEvent().

BOOL LLAudioEngine::isWindEnabled ( ) [virtual]

Definition at line 609 of file audioengine.cpp.

References mEnableWind.

Referenced by toggle_wind_audio().

F64 LLAudioEngine::mapWindVecToGain ( LLVector3 wind_vec ) [protected]

Definition at line 644 of file audioengine.cpp.

References gain(), and LLVector3::magVec().

Referenced by LLAudioEngine_FMOD::updateWind().

F64 LLAudioEngine::mapWindVecToPan ( LLVector3 wind_vec ) [protected]

Definition at line 687 of file audioengine.cpp.

References F_PI, LLVector3::normVec(), and LLVector3::setVec().

Referenced by LLAudioEngine_FMOD::updateWind().

F64 LLAudioEngine::mapWindVecToPitch ( LLVector3 wind_vec ) [protected]

Definition at line 663 of file audioengine.cpp.

References F_PI, LLVector3::normVec(), and LLVector3::setVec().

Referenced by LLAudioEngine_FMOD::updateWind().

void LLAudioEngine::orientListener	(	LLVector3	up,
		LLVector3	at
	)			`[protected, virtual]`

Definition at line 767 of file audioengine.cpp.

References mListenerp, and LLListener::orient().

virtual void LLAudioEngine::pauseInternetStream ( int pause ) [pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by LLOverlayBar::musicPause().

BOOL LLAudioEngine::preloadSound ( const LLUUID & id )

Definition at line 591 of file audioengine.cpp.

References LLAudioDecodeMgr::addDecodeRequest(), FALSE, gAudioDecodeMgrp, gAudiop, getAudioData(), and TRUE.

Referenced by init_audio(), and LLPreviewSound::LLPreviewSound().

void LLAudioEngine::setDistanceFactor ( F32 factor ) [virtual]

Definition at line 801 of file audioengine.cpp.

References mListenerp, and LLListener::setDistanceFactor().

Referenced by audio_update_volume().

void LLAudioEngine::setDopplerFactor ( F32 factor ) [virtual]

Definition at line 779 of file audioengine.cpp.

References mListenerp, and LLListener::setDopplerFactor().

Referenced by audio_update_volume().

virtual void LLAudioEngine::setInternalGain ( F32 gain ) [protected, pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by idle(), and setMasterGain().

virtual void LLAudioEngine::setInternetStreamGain ( F32 vol ) [inline, virtual]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 145 of file audioengine.h.

References mInternetStreamGain.

Referenced by audio_update_volume(), and LLAudioEngine_FMOD::setInternetStreamGain().

void LLAudioEngine::setListener	(	LLVector3	pos,
		LLVector3	vel,
		LLVector3	up,
		LLVector3	at
	)			`[virtual]`

Definition at line 773 of file audioengine.cpp.

References mListenerp, and LLListener::set().

Referenced by audio_update_listener(), and init_audio().

void LLAudioEngine::setListenerPos ( LLVector3 vec ) [protected, virtual]

Definition at line 736 of file audioengine.cpp.

References mListenerp, and LLListener::setPosition().

void LLAudioEngine::setListenerVelocity ( LLVector3 vec ) [protected, virtual]

Definition at line 755 of file audioengine.cpp.

References mListenerp, and LLListener::setVelocity().

void LLAudioEngine::setMasterGain ( F32 gain )

Definition at line 622 of file audioengine.cpp.

References mMasterGain, and setInternalGain().

Referenced by audio_update_volume().

void LLAudioEngine::setMaxWindGain ( F32 gain ) [virtual]

Definition at line 638 of file audioengine.cpp.

References mMaxWindGain.

void LLAudioEngine::setMuted ( BOOL muted ) [virtual]

Definition at line 615 of file audioengine.cpp.

References enableWind(), and mMuted.

Referenced by audio_update_volume(), and idle_startup().

void LLAudioEngine::setRolloffFactor ( F32 factor ) [virtual]

Definition at line 823 of file audioengine.cpp.

References mListenerp, and LLListener::setRolloffFactor().

Referenced by audio_update_volume(), and audio_update_wind().

void LLAudioEngine::shutdown ( ) [virtual]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 105 of file audioengine.cpp.

References gAudioDecodeMgrp, i, mAllData, mAllSources, MAX_BUFFERS, MAX_CHANNELS, mBuffers, mChannels, NULL, and S32.

Referenced by cleanup_app(), and LLAudioEngine_FMOD::shutdown().

virtual void LLAudioEngine::startInternetStream ( const char * url ) [pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by LLAudioStreamMusicListener::handleEvent(), LLOverlayBar::musicPlay(), and LLViewerParcelMgr::processParcelProperties().

void LLAudioEngine::startNextTransfer ( )

virtual void LLAudioEngine::stopInternetStream ( ) [pure virtual]

Implemented in LLAudioEngine_FMOD.

Referenced by LLAudioStreamMusicListener::handleEvent(), LLOverlayBar::musicStop(), and LLViewerParcelMgr::processParcelProperties().

void LLAudioEngine::translateListener ( LLVector3 vec ) [protected, virtual]

Definition at line 761 of file audioengine.cpp.

References mListenerp, and LLListener::translate().

void LLAudioEngine::triggerSound	(	const LLUUID &	sound_id,
		const LLUUID &	owner_id,
		const F32	gain,
		const LLVector3d &	pos_global = `LLVector3d::zero`
	)

Definition at line 708 of file audioengine.cpp.

References addAudioSource(), gAudiop, LLUUID::generate(), LLVector3d::isExactlyZero(), mMuted, LLAudioSource::play(), LLAudioSource::setAmbient(), LLAudioSource::setPositionGlobal(), TRUE, and LLAudioSource::updatePriority().

Referenced by add_object(), LLPreviewSound::auditionSound(), LLViewerTextEditor::openEmbeddedSound(), process_sound_trigger(), ui_audio_callback(), and LLVOAvatar::updateCharacter().

BOOL LLAudioEngine::updateBufferForData	(	LLAudioData *	adp,
		const LLUUID &	audio_uuid = `LLUUID::null`
	)

Definition at line 429 of file audioengine.cpp.

References LLAudioDecodeMgr::addDecodeRequest(), FALSE, gAudioDecodeMgrp, LLAudioData::getBuffer(), LLAudioData::hasDecodedData(), LLAudioData::hasLocalData(), LLAudioData::load(), LLUUID::notNull(), and TRUE.

Referenced by idle(), and LLAudioSource::play().

void LLAudioEngine::updateChannels ( ) [virtual]

Definition at line 150 of file audioengine.cpp.

References i, MAX_CHANNELS, mChannels, S32, LLAudioChannel::update3DPosition(), and LLAudioChannel::updateLoop().

Referenced by idle().

virtual void LLAudioEngine::updateInternetStream ( ) [inline, protected, virtual]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 185 of file audioengine.h.

virtual void LLAudioEngine::updateWind	(	LLVector3	direction,
		F32	camera_height_above_water
	)			`[pure virtual]`

Implemented in LLAudioEngine_FMOD.

Referenced by audio_update_wind().

friend class LLPipeline [friend]

Definition at line 166 of file audioengine.h.

data_map LLAudioEngine::mAllData [protected]

Definition at line 220 of file audioengine.h.

Referenced by getAudioData(), and shutdown().

source_map LLAudioEngine::mAllSources [protected]

Definition at line 219 of file audioengine.h.

Referenced by addAudioSource(), cleanupAudioSource(), findAudioSource(), idle(), LLPipeline::postSort(), shutdown(), and startNextTransfer().

LLAudioBuffer* LLAudioEngine::mBuffers[MAX_BUFFERS] [protected]

Definition at line 226 of file audioengine.h.

Referenced by cleanupBuffer(), getFreeBuffer(), idle(), init(), and shutdown().

LLAudioChannel* LLAudioEngine::mChannels[MAX_CHANNELS] [protected]

Definition at line 222 of file audioengine.h.

Referenced by getFreeChannel(), idle(), init(), shutdown(), startNextTransfer(), and updateChannels().

LLUUID LLAudioEngine::mCurrentTransfer [protected]

Definition at line 210 of file audioengine.h.

Referenced by assetCallback(), and startNextTransfer().

LLFrameTimer LLAudioEngine::mCurrentTransferTimer [protected]

Definition at line 211 of file audioengine.h.

Referenced by startNextTransfer().

BOOL LLAudioEngine::mEnableWind [protected]

Definition at line 208 of file audioengine.h.

Referenced by enableWind(), init(), isWindEnabled(), and LLAudioEngine_FMOD::updateWind().

F32 LLAudioEngine::mInternetStreamGain [protected]

Definition at line 231 of file audioengine.h.

Referenced by getInternetStreamGain(), init(), LLAudioEngine_FMOD::setInternalGain(), setInternetStreamGain(), and LLAudioEngine_FMOD::updateInternetStream().

S32 LLAudioEngine::mLastStatus [protected]

Definition at line 205 of file audioengine.h.

Referenced by init().

LLListener* LLAudioEngine::mListenerp [protected]

Definition at line 200 of file audioengine.h.

Referenced by LLAudioEngine_FMOD::allocateListener(), commitDeferredChanges(), getDistanceFactor(), getDopplerFactor(), getListenerPos(), getRolloffFactor(), orientListener(), setDistanceFactor(), setDopplerFactor(), setListener(), setListenerPos(), setListenerVelocity(), setRolloffFactor(), LLAudioEngine_FMOD::shutdown(), and translateListener().

F32 LLAudioEngine::mMasterGain [protected]

Definition at line 228 of file audioengine.h.

Referenced by getMasterGain(), init(), and setMasterGain().

F32 LLAudioEngine::mMaxWindGain

Definition at line 168 of file audioengine.h.

Referenced by audio_update_wind(), init(), setMaxWindGain(), and LLAudioEngine_FMOD::updateWind().

BOOL LLAudioEngine::mMuted [protected]

Definition at line 202 of file audioengine.h.

Referenced by getMuted(), init(), setMuted(), and triggerSound().

F32 LLAudioEngine::mNextWindUpdate [protected]

Definition at line 233 of file audioengine.h.

Referenced by LLAudioEngine_FMOD::initWind().

S32 LLAudioEngine::mNumChannels [protected]

Definition at line 207 of file audioengine.h.

Referenced by getFreeChannel(), and init().

void* LLAudioEngine::mUserData [protected]

Reimplemented in LLAudioEngine_FMOD.

Definition at line 203 of file audioengine.h.

Referenced by init().

LLFrameTimer LLAudioEngine::mWindUpdateTimer [protected]

Definition at line 235 of file audioengine.h.

Referenced by LLAudioEngine_FMOD::updateWind().

LLAudioEngine Class Reference

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Types

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation


Public Member Functions
	LLAudioEngine ()
virtual	~LLAudioEngine ()
virtual BOOL	init (const S32 num_channels, void *userdata)
virtual void	shutdown ()
virtual void	setListener (LLVector3 pos, LLVector3 vel, LLVector3 up, LLVector3 at)
virtual void	updateWind (LLVector3 direction, F32 camera_height_above_water)=0
virtual void	idle (F32 max_decode_time=0.f)
virtual void	updateChannels ()
virtual BOOL	isWindEnabled ()
virtual void	enableWind (BOOL state_b)
virtual void	setMuted (BOOL muted)
virtual BOOL	getMuted () const
F32	getMasterGain ()
void	setMasterGain (F32 gain)
F32	getInternetStreamGain ()
virtual void	setDopplerFactor (F32 factor)
virtual F32	getDopplerFactor ()
virtual void	setDistanceFactor (F32 factor)
virtual F32	getDistanceFactor ()
virtual void	setRolloffFactor (F32 factor)
virtual F32	getRolloffFactor ()
virtual void	setMaxWindGain (F32 gain)
void	triggerSound (const LLUUID &sound_id, const LLUUID &owner_id, const F32 gain, const LLVector3d &pos_global=LLVector3d::zero)
BOOL	preloadSound (const LLUUID &id)
void	addAudioSource (LLAudioSource *asp)
void	cleanupAudioSource (LLAudioSource *asp)
LLAudioSource *	findAudioSource (const LLUUID &source_id)
LLAudioData *	getAudioData (const LLUUID &audio_uuid)
virtual void	startInternetStream (const char *url)=0
virtual void	stopInternetStream ()=0
virtual void	pauseInternetStream (int pause)=0
virtual int	isInternetStreamPlaying ()=0
virtual void	getInternetStreamInfo (char artist, char title)
virtual void	setInternetStreamGain (F32 vol)
virtual const char *	getInternetStreamURL ()
virtual LLVector3	getListenerPos ()
LLAudioBuffer *	getFreeBuffer ()
LLAudioChannel *	getFreeChannel (const F32 priority)
void	cleanupBuffer (LLAudioBuffer *bufferp)
BOOL	hasDecodedFile (const LLUUID &uuid)
BOOL	hasLocalFile (const LLUUID &uuid)
BOOL	updateBufferForData (LLAudioData *adp, const LLUUID &audio_uuid=LLUUID::null)
void	startNextTransfer ()
Static Public Member Functions
static void	assetCallback (LLVFS vfs, const LLUUID &uuid, LLAssetType::EType type, void user_data, S32 result_code, LLExtStat ext_status)
Public Attributes
F32	mMaxWindGain
Protected Types
typedef std::map< LLUUID, LLAudioSource * >	source_map
typedef std::map< LLUUID, LLAudioData * >	data_map
Protected Member Functions
virtual LLAudioBuffer *	createBuffer ()=0
virtual LLAudioChannel *	createChannel ()=0
virtual void	initWind ()=0
virtual void	cleanupWind ()=0
virtual void	setInternalGain (F32 gain)=0
void	commitDeferredChanges ()
virtual void	allocateListener ()=0
virtual void	initInternetStream ()
virtual void	updateInternetStream ()
virtual void	setListenerPos (LLVector3 vec)
virtual void	setListenerVelocity (LLVector3 vec)
virtual void	orientListener (LLVector3 up, LLVector3 at)
virtual void	translateListener (LLVector3 vec)
F64	mapWindVecToGain (LLVector3 wind_vec)
F64	mapWindVecToPitch (LLVector3 wind_vec)
F64	mapWindVecToPan (LLVector3 wind_vec)
Protected Attributes
LLListener *	mListenerp
BOOL	mMuted
void *	mUserData
S32	mLastStatus
S32	mNumChannels
BOOL	mEnableWind
LLUUID	mCurrentTransfer
LLFrameTimer	mCurrentTransferTimer
source_map	mAllSources
data_map	mAllData
LLAudioChannel *	mChannels [MAX_CHANNELS]
LLAudioBuffer *	mBuffers [MAX_BUFFERS]
F32	mMasterGain
F32	mInternetStreamGain
F32	mNextWindUpdate
LLFrameTimer	mWindUpdateTimer
Friends
class	LLPipeline