C4SoundSystem.cpp File Reference

#include "C4Include.h"
#include "platform/C4SoundSystem.h"
#include "lib/C4Random.h"
#include "game/C4Application.h"
#include "game/C4Viewport.h"
#include "object/C4Object.h"
#include "platform/C4SoundIncludes.h"
#include "platform/C4SoundInstance.h"
#include "platform/C4SoundLoaders.h"

Include dependency graph for C4SoundSystem.cpp:

Go to the source code of this file.

Functions
C4SoundInstance *	StartSoundEffect (const char *szSndName, bool fLoop, int32_t iVolume, C4Object *pObj, int32_t iCustomFalloffDistance, int32_t iPitch, C4SoundModifier *modifier)
C4SoundInstance *	StartSoundEffectAt (const char *szSndName, int32_t iX, int32_t iY, int32_t iVolume, int32_t iCustomFallofDistance, int32_t iPitch, C4SoundModifier *modifier)
C4SoundInstance *	GetSoundInstance (const char *szSndName, C4Object *pObj)
void	StopSoundEffect (const char *szSndName, C4Object *pObj)
void	SoundLevel (const char *szSndName, C4Object *pObj, int32_t iLevel)
void	SoundPan (const char *szSndName, C4Object *pObj, int32_t iPan)
void	SoundPitch (const char *szSndName, C4Object *pObj, int32_t iPitch)
void	SoundUpdate (C4SoundInstance *pInst, int32_t iLevel, int32_t iPitch)

Function Documentation

GetSoundInstance()

C4SoundInstance* GetSoundInstance	(	const char *	szSndName,
		C4Object *	pObj
	)

Definition at line 283 of file C4SoundSystem.cpp.

{
    return Application.SoundSystem.FindInstance(szSndName, pObj);
}

References Application, C4SoundSystem::FindInstance(), and C4Application::SoundSystem.

Here is the call graph for this function:

SoundLevel()

void SoundLevel	(	const char *	szSndName,
		C4Object *	pObj,
		int32_t	iLevel
	)

Definition at line 296 of file C4SoundSystem.cpp.

{
    // Sound level zero? Stop
    if (!iLevel) { StopSoundEffect(szSndName, pObj); return; }
    // Find or create instance
    C4SoundInstance *pInst = Application.SoundSystem.FindInstance(szSndName, pObj);
    if (!pInst) pInst = StartSoundEffect(szSndName, true, iLevel, pObj);
    if (!pInst) return;
    // Set volume
    pInst->SetVolume(iLevel);
    pInst->Execute();
}

References Application, C4SoundInstance::Execute(), C4SoundSystem::FindInstance(), C4SoundInstance::SetVolume(), C4Application::SoundSystem, StartSoundEffect(), and StopSoundEffect().

Here is the call graph for this function:

SoundPan()

void SoundPan	(	const char *	szSndName,
		C4Object *	pObj,
		int32_t	iPan
	)

Definition at line 309 of file C4SoundSystem.cpp.

{
    // Find instance
    C4SoundInstance *pInst = Application.SoundSystem.FindInstance(szSndName, pObj);
    if (!pInst) return;
    // Set pan
    pInst->SetPan(iPan);
    pInst->Execute();
}

References Application, C4SoundInstance::Execute(), C4SoundSystem::FindInstance(), C4SoundInstance::SetPan(), and C4Application::SoundSystem.

Here is the call graph for this function:

SoundPitch()

void SoundPitch	(	const char *	szSndName,
		C4Object *	pObj,
		int32_t	iPitch
	)

Definition at line 319 of file C4SoundSystem.cpp.

{
    // Find instance
    C4SoundInstance *pInst = Application.SoundSystem.FindInstance(szSndName, pObj);
    if (!pInst) return;
    // Set pitch
    pInst->SetPitch(iPitch);
    pInst->Execute();
}

References Application, C4SoundInstance::Execute(), C4SoundSystem::FindInstance(), C4SoundInstance::SetPitch(), and C4Application::SoundSystem.

Here is the call graph for this function:

SoundUpdate()

void SoundUpdate	(	C4SoundInstance *	pInst,
		int32_t	iLevel,
		int32_t	iPitch
	)

Definition at line 329 of file C4SoundSystem.cpp.

{
    // Set sound data
    pInst->SetVolume(iLevel);
    pInst->SetPitch(iPitch);
    // Ensure it's reflected in audio engine
    pInst->Execute();
}

References C4SoundInstance::Execute(), C4SoundInstance::SetPitch(), and C4SoundInstance::SetVolume().

Here is the call graph for this function:

StartSoundEffect()

C4SoundInstance* StartSoundEffect	(	const char *	szSndName,
		bool	fLoop,
		int32_t	iVolume,
		C4Object *	pObj,
		int32_t	iCustomFalloffDistance,
		int32_t	iPitch,
		C4SoundModifier *	modifier
	)

Definition at line 263 of file C4SoundSystem.cpp.

{
    // Sound check
    if (!Config.Sound.RXSound) return nullptr;
    // Start new
    return Application.SoundSystem.NewEffect(szSndName, fLoop, iVolume, pObj, iCustomFalloffDistance, iPitch, modifier);
}

References Application, Config, C4SoundSystem::NewEffect(), C4ConfigSound::RXSound, C4Config::Sound, and C4Application::SoundSystem.

Referenced by C4ViewportList::CloseViewport(), C4ControlEMMoveObject::CreateObject(), C4ViewportList::CreateViewport(), C4Object::DirectComContents(), C4Player::DoWealth(), C4Player::Eliminate(), C4Object::ExecLife(), C4GUI::GUISound(), C4GameLobby::MainDlg::OnCountdownPacket(), C4GameLobby::MainDlg::OnError(), C4Object::Promote(), C4Game::QuickSave(), C4Object::SetAction(), C4Player::SetHostility(), SoundLevel(), StartSoundEffectAt(), and C4Player::Surrender().

Here is the call graph for this function:

Here is the caller graph for this function:

StartSoundEffectAt()

C4SoundInstance* StartSoundEffectAt	(	const char *	szSndName,
		int32_t	iX,
		int32_t	iY,
		int32_t	iVolume,
		int32_t	iCustomFallofDistance,
		int32_t	iPitch,
		C4SoundModifier *	modifier
	)

Definition at line 271 of file C4SoundSystem.cpp.

{
    // Sound check
    if (!Config.Sound.RXSound) return nullptr;
    // Create
    C4SoundInstance *pInst = StartSoundEffect(szSndName, false, iVolume, nullptr, iCustomFallofDistance, iPitch, modifier);
    // Set volume by position
    if (pInst) pInst->SetVolumeByPos(iX, iY, iVolume);
    // Return
    return pInst;
}

References Config, C4ConfigSound::RXSound, C4SoundInstance::SetVolumeByPos(), C4Config::Sound, and StartSoundEffect().

Here is the call graph for this function:

StopSoundEffect()

void StopSoundEffect	(	const char *	szSndName,
		C4Object *	pObj
	)

Definition at line 288 of file C4SoundSystem.cpp.

{
    // Find instance
    C4SoundInstance *pInst = Application.SoundSystem.FindInstance(szSndName, pObj);
    if (!pInst) return;
    // Stop
    pInst->Stop();
}

References Application, C4SoundSystem::FindInstance(), C4Application::SoundSystem, and C4SoundInstance::Stop().

Referenced by C4Object::SetAction(), and SoundLevel().

Here is the call graph for this function:

Here is the caller graph for this function: