#include <handle.h>

Public Member Functions
void	ConvertTo3D (float mindist, float maxdist, csVector3 pos, csVector3 dir, float rad)
	Converts this Handle to a 3D Handle. More...

void	ConvertTo3D (float mindist, float maxdist, csVector3 pos, csVector3 dir, float rad)
	Converts this Handle to a 3D Handle. More...

void	Fade (float volume, int time, int direction)
	Does fading calculation for this Handle. More...

void	Fade (float volume, int time, int direction)
	Does fading calculation for this Handle. More...

void	FadeStep ()
	Perform a fading step if it is needed. More...

bool	GetAutoRemove ()
	Returns state of AutoRemove. More...

bool	GetAutoRemove ()
	Returns state of AutoRemove. More...

uint	GetID () const
	Gets the ID of this handle. More...

csVector3	GetSourcePosition ()
	Gets the position of the source. More...

bool	Init (const char resname, bool loop, float volume_preset, int type, SoundControl &ctrl)
	Initialize this Handle. More...

virtual bool	Init (const char resname, bool loop, float volume_preset, int type, SoundControl &ctrl, bool dopplerEffect)
	Initialize this Handle. More...

bool	Is3D ()
	Detects if the source of this handle is 3D. More...

bool	IsDopplerEffectEnabled ()
	Check if the doppler effect is enabled for this sound. More...

bool	IsWithinMaximumDistance (csVector3 listenerPos) const
	Check if the listener is within the maximum distance allowed. More...

virtual void	OnSoundChange (SoundControl *sndCtrl)
	This function is called everytime the volume or the toggle change. More...

virtual bool	Perform (iTimerEvent *)
	Unpause the sound after the given delay has elapsed. More...

void	RemoveCallback ()
	Remove the callback. More...

void	RemoveCallback ()
	Remove the callback. More...

void	SetAutoRemove (bool toggle)
	Whether to remove this Sound/Handle on pause. More...

void	SetAutoRemove (bool toggle)
	Whether to remove this Sound/Handle on pause. More...

void	SetCallback (void(object), void(function)(void *))
	Sets a Callback to a object function. More...

void	SetCallback (void(object), void(function)(void *))
	Sets a Callback to a object function. More...

void	SetID (uint identifier)
	Sets the ID of this handle. More...

	SoundHandle (SoundSystemManager *)
	constructor More...

	SoundHandle ()
	constructor More...

void	UnpauseAfterDelay (unsigned int delay)
	Unpause the sound stream of this header after the given delay. More...

	~SoundHandle ()
	destructor More...

virtual	~SoundHandle ()
	destructor More...

Public Attributes
bool	autoremove
	remove this handle when pause? More...

int	fade
	>0 is number of steps up <0 is number of steps down, 0 is nothing More...

bool	fade_stop
	pause this sound after fading down true / false More...

float	fade_volume
	volume we add or remove in each step (during fading) More...

csString	name
	name of the resource or the file - not unique More...

float	preset_volume
	the volume all calculations are based upon More...

SoundControl *	sndCtrl

csRef< iSndSysData >	snddata
	pointer to sound data More...

csRef< iSndSysSource >	sndsource
	sndsource if 2D More...

csRef< iSndSysSource3D >	sndsource3d
	sndsource if 3D More...

csRef< iSndSysSource3DDirectionalSimple >	sndsourcedir
	additional source if 3D and directional More...

csRef< iSndSysStream >	sndstream
	sound stream More...

Protected Attributes
float	currentVolume
	the volume all calculations are based upon. More...

bool	dopplerEffect
	true if the doppler effect is enabled for this sound More...

Detailed Description

Definition at line 40 of file handle.h.

Constructor & Destructor Documentation

SoundHandle::SoundHandle ( SoundSystemManager * )

constructor

SoundHandle::~SoundHandle ( )

destructor

SoundHandle::SoundHandle ( )

constructor

virtual SoundHandle::~SoundHandle ( )

virtual

destructor

Member Function Documentation

void SoundHandle::ConvertTo3D	(	float	mindist,
		float	maxdist,
		csVector3	pos,
		csVector3	dir,
		float	rad
	)

Converts this Handle to a 3D Handle.

Note: doesnt work when type is CS_SND3D_DISABLE Also created directional sources if rad > 0

Parameters

mindist	distance when volume reaches max
maxdist	distance when volume is a min
pos	3d position of this sound
dir	direction this sound is emitting to (if rad > 0)
rad	radiation of the directional cone

void SoundHandle::ConvertTo3D	(	float	mindist,
		float	maxdist,
		csVector3	pos,
		csVector3	dir,
		float	rad
	)

Converts this Handle to a 3D Handle.

Note: doesnt work when type is CS_SND3D_DISABLE Also created directional sources if rad > 0

Parameters

mindist	distance when volume reaches max
maxdist	distance when volume is a min
pos	3d position of this sound
dir	direction this sound is emitting to (if rad > 0)
rad	radiation of the directional cone

void SoundHandle::Fade	(	float	volume,
		int	time,
		int	direction
	)

Does fading calculation for this Handle.

Parameters

volume	volume to add / substract
time	time within this must be done
direction	FADE_DOWN / FADE_UP or FADE_STOP

void SoundHandle::Fade	(	float	volume,
		int	time,
		int	direction
	)

Does fading calculation for this Handle.

Parameters

volume	volume to add / substract
time	time within this must be done
direction	FADE_DOWN / FADE_UP or FADE_STOP

void SoundHandle::FadeStep ( )

Perform a fading step if it is needed.

bool SoundHandle::GetAutoRemove ( )

Returns state of AutoRemove.

bool SoundHandle::GetAutoRemove ( )

Returns state of AutoRemove.

uint SoundHandle::GetID ( ) const

inline

Gets the ID of this handle.

Returns: the ID of this handle.

Definition at line 135 of file handle.h.

csVector3 SoundHandle::GetSourcePosition ( )

Gets the position of the source.

Note: : always call SoundHandle::Is3D() before calling this method.

Returns: the position of the source.

bool SoundHandle::Init	(	const char *	resname,
		bool	loop,
		float	volume_preset,
		int	type,
		SoundControl *&	ctrl
	)

Initialize this Handle.

Done within this because its not failsave. Returns true or false.

Parameters

resname	name of the resource
loop	LOOP or DONT_LOOP
volume_preset	volume which all calculation are based upon
type	3d type: can be CS_SND3D_DISABLE=0. CS_SND3D_RELATIVE=1 or CS_SND3D_ABSOLUTE=2
ctrl	SoundControl which controls this Handle

virtual bool SoundHandle::Init	(	const char *	resname,
		bool	loop,
		float	volume_preset,
		int	type,
		SoundControl *&	ctrl,
		bool	dopplerEffect
	)

virtual

Initialize this Handle.

Done within this because its not failsave. Returns true or false.

Parameters

resname	name of the resource
loop	LOOP or DONT_LOOP
volume_preset	volume which all calculation are based upon
type	3d type: can be CS_SND3D_DISABLE=0. CS_SND3D_RELATIVE=1 or CS_SND3D_ABSOLUTE=2
ctrl	SoundControl which controls this Handle
dopplerEffect	true to apply the doppler effect to this sound, false otherwise.

Reimplemented in SongHandle.

bool SoundHandle::Is3D ( )

Detects if the source of this handle is 3D.

Returns: true if the source is 3D, false otherwise.

bool SoundHandle::IsDopplerEffectEnabled ( )

Check if the doppler effect is enabled for this sound.

Returns: true if the doppler effect is enabled, false otherwise.

bool SoundHandle::IsWithinMaximumDistance ( csVector3 listenerPos ) const

Check if the listener is within the maximum distance allowed.

Parameters

listenerPos the listener position.

Returns: true if the listener is within the maximum distance from the object.

virtual void SoundHandle::OnSoundChange ( SoundControl * sndCtrl )

virtual

This function is called everytime the volume or the toggle change.

Parameters

sndCtrl the SoundControl that has been changed.

Implements iSoundControlListener.

virtual bool SoundHandle::Perform ( iTimerEvent * )

virtual

Unpause the sound after the given delay has elapsed.

void SoundHandle::RemoveCallback ( )

Remove the callback.

void SoundHandle::RemoveCallback ( )

Remove the callback.

void SoundHandle::SetAutoRemove ( bool toggle )

Whether to remove this Sound/Handle on pause.

True means it will be removed when Sound is paused (Unamanged Sound). False means it will stay and leak if you dont take care (Managed Sound).

Parameters

toggle true or false

void SoundHandle::SetAutoRemove ( bool toggle )

Whether to remove this Sound/Handle on pause.

True means it will be removed when Sound is paused (Unamanged Sound). False means it will stay and leak if you dont take care (Managed Sound).

Parameters

toggle true or false

void SoundHandle::SetCallback	(	void *	object,
		void()(void )	function
	)

Sets a Callback to a object function.

Parameters

object	pointer to the object
function	pointer to a static void function within the object

void SoundHandle::SetCallback	(	void *	object,
		void()(void )	function
	)

Sets a Callback to a object function.

Parameters

object	pointer to the object
function	pointer to a static void function within the object

void SoundHandle::SetID ( uint identifier )

inline

Sets the ID of this handle.

Parameters

id	the new ID of this handle.

Definition at line 141 of file handle.h.

void SoundHandle::UnpauseAfterDelay ( unsigned int delay )

Unpause the sound stream of this header after the given delay.

Parameters

delay the delay in milliseconds.

Member Data Documentation

bool SoundHandle::autoremove

remove this handle when pause?

Definition at line 49 of file handle.h.

float SoundHandle::currentVolume

protected

the volume all calculations are based upon.

Definition at line 187 of file handle.h.

bool SoundHandle::dopplerEffect

protected

true if the doppler effect is enabled for this sound

Definition at line 186 of file handle.h.

int SoundHandle::fade

>0 is number of steps up <0 is number of steps down, 0 is nothing

Definition at line 46 of file handle.h.

bool SoundHandle::fade_stop

pause this sound after fading down true / false

Definition at line 48 of file handle.h.

float SoundHandle::fade_volume

volume we add or remove in each step (during fading)

Definition at line 47 of file handle.h.

csString SoundHandle::name

name of the resource or the file - not unique

Definition at line 43 of file handle.h.

float SoundHandle::preset_volume

the volume all calculations are based upon

Definition at line 45 of file handle.h.

SoundControl * SoundHandle::sndCtrl

See also: SoundControl

Definition at line 44 of file handle.h.

csRef< iSndSysData > SoundHandle::snddata

pointer to sound data

Definition at line 51 of file handle.h.

csRef< iSndSysSource > SoundHandle::sndsource

sndsource if 2D

Definition at line 53 of file handle.h.

csRef< iSndSysSource3D > SoundHandle::sndsource3d

sndsource if 3D

Definition at line 54 of file handle.h.

csRef< iSndSysSource3DDirectionalSimple > SoundHandle::sndsourcedir

additional source if 3D and directional

Definition at line 55 of file handle.h.

csRef< iSndSysStream > SoundHandle::sndstream

sound stream

Definition at line 52 of file handle.h.

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

common/sound/handle.h

Public Member Functions

Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation