The wrapper around SDL_Mixer that plays sounds ingame. More...

#include <sound.h>

Public Member Functions
void	clear_sound ()
	Shuts down sound system.

void	preloadsound (int n)
	Loads the approriate sound file at the given index.

void	preloadmapsounds ()
	Loads the sounds for every element in the map sounds vector.

int	playsound (int n, const vec loc=nullptr, extentity ent=nullptr, int flags=0, int loops=0, int fade=0, int chanid=-1, int radius=0, int expire=-1)
	Plays a sound with the given attributes.

bool	stopsound (int n, int chanid, int fade)
	Stops playing a sound of index n in the specificied channel.

void	stopsounds ()
	Immediately kills all active sounds.

void	updatesounds ()
	Restarts and updates all sound indices.

int	playsoundname (const char s, const vec loc, int vol, int flags, int loops, int fade, int chanid, int radius, int expire)
	Plays a sound with the given attributes.

void	initsound ()
	Starts SDL_Mixer and initializes startup sound channels.

void	startmusic (const char name, const char cmd)
	Starts a nonpositional music track.

void	resetsound ()
	Resets the sound subsystem.

void	setstereo (const int *const on)
	Sets whether stereo audio is enabled.

int	getstereo ()
	Returns whether stereo or mono is enabled.

void	setmaxradius (const int *const dist)
	Sets the maximum radius to play sounds from.

int	getmaxradius ()
	Returns the maximum sound play radius.

void	setsoundchans (const int *const val)
	Sets the number of sound channels to use.

int	getsoundchans ()
	Returns the number of sound channels in use.

void	setsoundvol (const int *vol)
	Sets the map sound volume.

int	getsoundvol ()
	Returns the current sound volume.

void	setmusicvol (const int *musicvol)
	Sets the music sound volume.

int	getmusicvol ()
	Returns the current music volume.

void	setaudiodriver (const char *f)
	Sends a list of audio subsystems for SDL to bind to.

void	setsound (const int *on)
	Sets whether the sound engine is enabled.

int	getsound ()
	Returns whether sound is on.

void	registersound (const char name, const int vol)
	Adds a sound to the sound list at a given volume.

void	mapsound (const char name, const int vol, const int *maxuses)
	Adds a sound to the list of map sounds.

void	altsound (const char name, const int vol)
	Adds an alternative game sound.

void	altmapsound (const char name, const int vol)
	Adds an alternative map sound.

void	numsounds ()
	Returns to the console the number of game sounds loaded.

void	nummapsounds ()
	Returns to the console the number of map sounds loaded.

void	soundreset ()
	Resets the loaded game sounds.

void	mapsoundreset ()
	Resets the loaded map sounds.

Detailed Description

The wrapper around SDL_Mixer that plays sounds ingame.

This class stores and plays sounds on command into either positionally (as a point in the world) or nonpositionally (such as background music).

Member Function Documentation

◆ altmapsound()

void SoundEngine::altmapsound	(	const char *	name,
		const int *	vol )

Adds an alternative map sound.

Parameters

the	name of the sound to add
vol	the volume of the sound (0..255)

◆ altsound()

void SoundEngine::altsound	(	const char *	name,
		const int *	vol )

Adds an alternative game sound.

Parameters

the	name of the sound to add
vol	the volume of the sound (0..255)

◆ clear_sound()

void SoundEngine::clear_sound ( )

Shuts down sound system.

Stops playing any active music, cleans up game and map sound vectors, and shuts down SDL_Mixer.

◆ getmaxradius()

int SoundEngine::getmaxradius ( )

Returns the maximum sound play radius.

The distance is in cube units ( =12.5cm).

Returns: the maximum distance at which sounds will be played

◆ getmusicvol()

int SoundEngine::getmusicvol ( )

Returns the current music volume.

Returns: the current volume for music (0..255)

◆ getsound()

int SoundEngine::getsound ( )

Returns whether sound is on.

Returns: 1 if sound is on, 0 otherwise

◆ getsoundchans()

int SoundEngine::getsoundchans ( )

Returns the number of sound channels in use.

Returns: the number of sound channels in use (1..128)

◆ getsoundvol()

int SoundEngine::getsoundvol ( )

Returns the current sound volume.

Returns: the current volume for map sounds (0..255)

◆ getstereo()

int SoundEngine::getstereo ( )

Returns whether stereo or mono is enabled.

The return is in CubeScript friendly int form.

Returns: 1 if stereo enabled, 0 if mono enabled

◆ initsound()

void SoundEngine::initsound ( )

Starts SDL_Mixer and initializes startup sound channels.

Fails and disables sound output if SDL is v2.0.6.

◆ mapsound()

void SoundEngine::mapsound	(	const char *	name,
		const int *	vol,
		const int *	maxuses )

Adds a sound to the list of map sounds.

Parameters

name	the path to the sound
vol	the volume of the sound (0..255)
maxuses	the number of uses before the sound won't play

◆ mapsoundreset()

void SoundEngine::mapsoundreset ( )

Resets the loaded map sounds.

This clears the list of map environment sounds loaded into the sound engine.

◆ nummapsounds()

void SoundEngine::nummapsounds ( )

Returns to the console the number of map sounds loaded.

Returns: (to console) the number of map sounds

◆ numsounds()

void SoundEngine::numsounds ( )

Returns to the console the number of game sounds loaded.

Returns: (to console) the number of game sounds

◆ playsound()

int SoundEngine::playsound	(	int	n,
		const vec *	loc = nullptr,
		extentity *	ent = nullptr,
		int	flags = 0,
		int	loops = 0,
		int	fade = 0,
		int	chanid = -1,
		int	radius = 0,
		int	expire = -1 )

Plays a sound with the given attributes.

Parameters

n	index of the sound to play
loc	world location to play at
ent	entity to associate with (overwrites location)
flags	music option flags
loops	number of times to loop
fade	ms to fade in over
chanid	music channel index to use
radius	distance over which sound is audible (in size 0 cubes)
expire	maximum time before the sound stops playing

◆ playsoundname()

int SoundEngine::playsoundname	(	const char *	s,
		const vec *	loc,
		int	vol,
		int	flags,
		int	loops,
		int	fade,
		int	chanid,
		int	radius,
		int	expire )

Plays a sound with the given attributes.

Parameters

s	name of the sound to play
loc	world location to play at
ent	entity to associate with (overwrites location)
flags	music option flags
loops	number of times to loop
fade	ms to fade in over
chanid	music channel index to use
radius	distance over which sound is audible (in size 0 cubes)
expire	maximum time before the sound stops playing

◆ preloadmapsounds()

void SoundEngine::preloadmapsounds ( )

Loads the sounds for every element in the map sounds vector.

Loads the related sound file for every valid map sound index (map entity sounds).

◆ preloadsound()

void SoundEngine::preloadsound ( int n )

Loads the approriate sound file at the given index.

Fails silently if index is invalid.

Parameters

n	the sound index to use

◆ registersound()

void SoundEngine::registersound	(	const char *	name,
		const int *	vol )

Adds a sound to the sound list at a given volume.

Parameters

name	the path to the sound
vol	the volume of the sound (0..255)

◆ setaudiodriver()

void SoundEngine::setaudiodriver ( const char * f )

Sends a list of audio subsystems for SDL to bind to.

By default, the standard Linux and Windows audio systems are set.

Parameters

f	a list of space-separated names for SDL to attempt to bind

◆ setmaxradius()

void SoundEngine::setmaxradius ( const int *const dist )

Sets the maximum radius to play sounds from.

The distance is in cube units ( =12.5cm).

Parameters

dist	the distance to render from

◆ setmusicvol()

void SoundEngine::setmusicvol ( const int * musicvol )

Sets the music sound volume.

Bounds limited to 0..255.

Parameters

vol	the volume level for music tracks

◆ setsound()

void SoundEngine::setsound ( const int * on )

Sets whether the sound engine is enabled.

Parameters

on	whether sound is enabled or not

◆ setsoundchans()

void SoundEngine::setsoundchans ( const int *const val )

Sets the number of sound channels to use.

Default value is 32; bounds limited to 1..128.

Parameters

val	the number of channels to use

◆ setsoundvol()

void SoundEngine::setsoundvol ( const int * vol )

Sets the map sound volume.

Bounds limited to 0..255.

Parameters

vol	the volume level for map sounds

◆ setstereo()

void SoundEngine::setstereo ( const int *const on )

Sets whether stereo audio is enabled.

Parameters

on	if true, enables stereo; if false, disables it

◆ soundreset()

void SoundEngine::soundreset ( )

Resets the loaded game sounds.

This clears the list of game (e.g. hud weapon) sounds loaded into the sound engine.

◆ startmusic()

void SoundEngine::startmusic	(	const char *	name,
		const char *	cmd )

Starts a nonpositional music track.

Parameters

name	(inc. path) of the track to play
cmd	the command to run (in CubeScript) at the end of the track

◆ stopsound()

bool SoundEngine::stopsound	(	int	n,
		int	chanid,
		int	fade )

Stops playing a sound of index n in the specificied channel.

Parameters

n	the sound index to stop playing
chanid	the channel id to use
fade	milliseconds to spend fading out the sound

◆ stopsounds()

void SoundEngine::stopsounds ( )

Immediately kills all active sounds.

Halts all sound channels in use and frees them.

◆ updatesounds()

void SoundEngine::updatesounds ( )

Restarts and updates all sound indices.

Pauses, reloads, and resumes playback of all active sounds. Does not play sounds if on the main menu.

The documentation for this class was generated from the following file:

/github/workspace/src/libprimis-headers/sound.h

Public Member Functions

Detailed Description

Member Function Documentation

◆ altmapsound()

◆ altsound()

◆ clear_sound()

◆ getmaxradius()

◆ getmusicvol()

◆ getsound()

◆ getsoundchans()

◆ getsoundvol()

◆ getstereo()

◆ initsound()

◆ mapsound()

◆ mapsoundreset()

◆ nummapsounds()

◆ numsounds()

◆ playsound()

◆ playsoundname()

◆ preloadmapsounds()

◆ preloadsound()

◆ registersound()

◆ setaudiodriver()

◆ setmaxradius()

◆ setmusicvol()

◆ setsound()

◆ setsoundchans()

◆ setsoundvol()

◆ setstereo()

◆ soundreset()

◆ startmusic()

◆ stopsound()

◆ stopsounds()

◆ updatesounds()