This is the base manager class for audio being played in a 3D environment. More...

#include <soundscapemanager.h>

Inheritance diagram for Mezzanine::Audio::SoundScapeManager:

Collaboration diagram for Mezzanine::Audio::SoundScapeManager:

Public Member Functions

SoundScapeManager ()

Class constructor.

SoundScapeManager (XML::Node &XMLNode)

XML constructor. More...

virtual ~SoundScapeManager ()

Class destructor.

virtual SoundProxy * CreateAmbientSoundProxy ()

Creates a blank Ambient SoundProxy without a stream attached to it. More...

virtual SoundProxy * CreateAmbientSoundProxy (Resource::DataStreamPtr Stream, const Audio::Encoding Encode)

Creates a new Ambient SoundProxy from a custom stream that is encoded. More...

virtual SoundProxy * CreateAmbientSoundProxy (Resource::DataStreamPtr Stream, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Ambient SoundProxy from a custom stream that is unencoded. More...

virtual SoundProxy * CreateAmbientSoundProxy (const String &FileName, const String &Group)

Creates a new Ambient SoundProxy from a file. More...

virtual SoundProxy * CreateAmbientSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const Audio::Encoding Encode)

Creates a new Ambient SoundProxy from a memory buffer that is encoded. More...

virtual SoundProxy * CreateAmbientSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Ambient SoundProxy from a memory buffer that is unencoded. More...

virtual SoundProxy * CreateDialogSoundProxy ()

Creates a blank Dialog SoundProxy without a stream attached to it. More...

virtual SoundProxy * CreateDialogSoundProxy (Resource::DataStreamPtr Stream, const Audio::Encoding Encode)

Creates a new Dialog SoundProxy from a custom stream that is encoded. More...

virtual SoundProxy * CreateDialogSoundProxy (Resource::DataStreamPtr Stream, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Dialog SoundProxy from a custom stream that is unencoded. More...

virtual SoundProxy * CreateDialogSoundProxy (const String &FileName, const String &Group)

Creates a new Dialog SoundProxy from a file. More...

virtual SoundProxy * CreateDialogSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const Audio::Encoding Encode)

Creates a new Dialog SoundProxy from a memory buffer that is encoded. More...

virtual SoundProxy * CreateDialogSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Dialog SoundProxy from a memory buffer that is unencoded. More...

virtual SoundProxy * CreateEffectSoundProxy ()

Creates a blank Effect SoundProxy without a stream attached to it. More...

virtual SoundProxy * CreateEffectSoundProxy (Resource::DataStreamPtr Stream, const Audio::Encoding Encode)

Creates a new Effect SoundProxy from a custom stream that is encoded. More...

virtual SoundProxy * CreateEffectSoundProxy (Resource::DataStreamPtr Stream, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Effect SoundProxy from a custom stream that is unencoded. More...

virtual SoundProxy * CreateEffectSoundProxy (const String &FileName, const String &Group)

Creates a new Effect SoundProxy from a file. More...

virtual SoundProxy * CreateEffectSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const Audio::Encoding Encode)

Creates a new Effect SoundProxy from a memory buffer that is encoded. More...

virtual SoundProxy * CreateEffectSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Effect SoundProxy from a memory buffer that is unencoded. More...

virtual iListener * CreateListener ()=0

Creates a new iListener. More...

virtual SoundProxy * CreateMusicSoundProxy ()

Creates a blank Music SoundProxy without a stream attached to it. More...

virtual SoundProxy * CreateMusicSoundProxy (Resource::DataStreamPtr Stream, const Audio::Encoding Encode)

Creates a new Music SoundProxy from a custom stream that is encoded. More...

virtual SoundProxy * CreateMusicSoundProxy (Resource::DataStreamPtr Stream, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Music SoundProxy from a custom stream that is unencoded. More...

virtual SoundProxy * CreateMusicSoundProxy (const String &FileName, const String &Group)

Creates a new Music SoundProxy from a file. More...

virtual SoundProxy * CreateMusicSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const Audio::Encoding Encode)

Creates a new Music SoundProxy from a memory buffer that is encoded. More...

virtual SoundProxy * CreateMusicSoundProxy (const String &StreamName, Char8 *Buffer, const UInt32 Length, const UInt32 Frequency, const Audio::BitConfig Config)

Creates a new Music SoundProxy from a memory buffer that is unencoded. More...

virtual SoundProxy * CreateSoundProxy (const UInt16 Type)=0

Creates a blank SoundProxy without a stream attached to it. More...

virtual SoundProxy * CreateSoundProxy (const UInt16 Type, Resource::DataStreamPtr Stream, const Audio::Encoding Encode)=0

Creates a new SoundProxy from a custom stream that is encoded. More...

virtual SoundProxy * CreateSoundProxy (const UInt16 Type, Resource::DataStreamPtr Stream, const UInt32 Frequency, const Audio::BitConfig Config)=0

Creates a new SoundProxy from a custom stream that is unencoded. More...

virtual SoundProxy * CreateSoundProxy (const UInt16 Type, const String &FileName, const String &Group)=0

Creates a new SoundProxy from a file. More...

virtual SoundProxy * CreateSoundProxy (const UInt16 Type, const String &StreamName, Char8 *Buffer, const UInt32 Length, const Audio::Encoding Encode)=0

Creates a new SoundProxy from a memory buffer that is encoded. More...

virtual SoundProxy * CreateSoundProxy (const UInt16 Type, const String &StreamName, Char8 *Buffer, const UInt32 Length, const UInt32 Frequency, const Audio::BitConfig Config)=0

Creates a new SoundProxy from a memory buffer that is unencoded. More...

virtual void Deinitialize ()=0

Removes this manager from any necessary configuration so it can be safely disposed of. More...

virtual void DestroyAllListeners ()=0

Deletes all stored iListener instances.

virtual void DestroyAllSoundProxies ()=0

Deletes all stored SoundProxy instances.

virtual void DestroyListener (iListener *ToBeDestroyed)=0

Deletes a iListener. More...

virtual void DestroySoundProxy (SoundProxy *ToBeDestroyed)=0

Deletes a SoundProxy. More...

virtual iBufferUpdate3DWorkUnit * GetBufferUpdate3DWork ()=0

Gets the work unit responsible for updating the buffers of soundproxies. More...

virtual ManagerType GetInterfaceType () const

This returns the type of this manager. More...

virtual iListener * GetListener (const UInt32 Index) const =0

Gets an iListener instance by index. More...

virtual UInt32 GetNumListeners () const =0

Gets the number of iListener instances in this manager. More...

virtual UInt32 GetNumSoundProxies () const =0

Gets the number of SoundProxy instances in this manager. More...

virtual SoundProxy * GetSoundProxy (const UInt32 Index) const =0

Gets an SoundProxy instance by index. More...

virtual void Initialize ()=0

Configures this manager for use prior to entering the main loop. More...

virtual void Pause (const UInt32 PL)=0

Sets the pause state of this manager, or has no effect depending on the value passed in. More...

Public Member Functions inherited from Mezzanine::WorldManager

WorldManager ()

Class constructor.

virtual ~WorldManager ()

Class destructor.

virtual void _SetWorld (World *Parent)

Sets the world this manager belongs to.

Exceptions

If	this manager is already initialized, this method will throw an "INVALID_STATE_EXCEPTION".

More...

virtual World * GetWorld () const

Gets the world this manager belongs to. More...

virtual bool IsPaused () const

Gets whether or not this manager is currently paused. More...

Public Member Functions inherited from Mezzanine::ManagerBase

ManagerBase ()

Class constructor.

virtual ~ManagerBase ()

Class destructor.

virtual String GetImplementationTypeName () const =0

This Allows any manager name to be sent to a stream. Primarily used for logging. More...

virtual String GetInterfaceTypeAsString () const

Gets a string of the interface type of this manager. More...

bool IsInitialized () const

Gets whether or not this manager has been initialized. More...

Additional Inherited Members
Public Types inherited from Mezzanine::ManagerBase
enum	ManagerType { MT_AudioManager = 1, MT_AnimationManager, MT_CollisionShapeManager, MT_CompositorManager, MT_GraphicsManager, MT_EventManager, MT_InputManager, MT_LogManager, MT_MaterialManager, MT_MeshManager, MT_NetworkManager, MT_ResourceManager, MT_ScriptingManager, MT_UIManager, MT_ActorManager = 100, MT_AreaEffectManager, MT_CameraManager, MT_DebrisManager, MT_PagingManager, MT_PhysicsManager, MT_SceneManager, MT_SoundScapeManager, MT_TerrainManager, MT_VehicleManager, MT_UserCreated = 512 }

Static Public Member Functions inherited from Mezzanine::ManagerBase
static String	GetTypeAsString (const ManagerType &ManagerType)
	Gets the string form of the type of manager. More...

static ManagerType	GetTypeFromString (const String &ManagerName)
	Gets the type of manager requested from a string. More...

Protected Attributes inherited from Mezzanine::WorldManager
bool	OperationsPaused
	This stores whether or not processing for some or all objects in this manager has been paused. More...

World *	ParentWorld
	A pointer to the world that created this manager. More...

Detailed Description

This is the base manager class for audio being played in a 3D environment.

Definition at line 77 of file soundscapemanager.h.

Constructor & Destructor Documentation

Mezzanine::Audio::SoundScapeManager::SoundScapeManager ( XML::Node & XMLNode)

XML constructor.

Parameters

XMLNode The node of the xml document to construct from.

Definition at line 53 of file soundscapemanager.cpp.

Member Function Documentation

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateAmbientSoundProxy ( )

virtual

Creates a blank Ambient SoundProxy without a stream attached to it.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 73 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateAmbientSoundProxy	(	Resource::DataStreamPtr	Stream,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Ambient SoundProxy from a custom stream that is encoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 82 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateAmbientSoundProxy	(	Resource::DataStreamPtr	Stream,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Ambient SoundProxy from a custom stream that is unencoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 91 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateAmbientSoundProxy	(	const String &	FileName,
		const String &	Group
	)

virtual

Creates a new Ambient SoundProxy from a file.

Parameters

FileName	The name of the file to read audio data from.
Group	The resource group in which the file resides.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 100 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateAmbientSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Ambient SoundProxy from a memory buffer that is encoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 109 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateAmbientSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Ambient SoundProxy from a memory buffer that is unencoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 118 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateDialogSoundProxy ( )

virtual

Creates a blank Dialog SoundProxy without a stream attached to it.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 75 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateDialogSoundProxy	(	Resource::DataStreamPtr	Stream,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Dialog SoundProxy from a custom stream that is encoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 84 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateDialogSoundProxy	(	Resource::DataStreamPtr	Stream,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Dialog SoundProxy from a custom stream that is unencoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 93 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateDialogSoundProxy	(	const String &	FileName,
		const String &	Group
	)

virtual

Creates a new Dialog SoundProxy from a file.

Parameters

FileName	The name of the file to read audio data from.
Group	The resource group in which the file resides.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 102 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateDialogSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Dialog SoundProxy from a memory buffer that is encoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

SoundName	The name of the SoundProxy instance.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 111 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateDialogSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Dialog SoundProxy from a memory buffer that is unencoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 120 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateEffectSoundProxy ( )

virtual

Creates a blank Effect SoundProxy without a stream attached to it.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 77 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateEffectSoundProxy	(	Resource::DataStreamPtr	Stream,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Effect SoundProxy from a custom stream that is encoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 86 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateEffectSoundProxy	(	Resource::DataStreamPtr	Stream,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Effect SoundProxy from a custom stream that is unencoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 95 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateEffectSoundProxy	(	const String &	FileName,
		const String &	Group
	)

virtual

Creates a new Effect SoundProxy from a file.

Parameters

FileName	The name of the file to read audio data from.
Group	The resource group in which the file resides.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 104 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateEffectSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Effect SoundProxy from a memory buffer that is encoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 113 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateEffectSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Effect SoundProxy from a memory buffer that is unencoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 122 of file soundscapemanager.cpp.

virtual iListener* Mezzanine::Audio::SoundScapeManager::CreateListener ( )

pure virtual

Creates a new iListener.

Returns: Returns a pointer to the iListener instance that was created.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateMusicSoundProxy ( )

virtual

Creates a blank Music SoundProxy without a stream attached to it.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 79 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateMusicSoundProxy	(	Resource::DataStreamPtr	Stream,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Music SoundProxy from a custom stream that is encoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 88 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateMusicSoundProxy	(	Resource::DataStreamPtr	Stream,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Music SoundProxy from a custom stream that is unencoded.

Parameters

Stream	A Datastream containing the data to be streamed for this SoundProxy.
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 97 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateMusicSoundProxy	(	const String &	FileName,
		const String &	Group
	)

virtual

Creates a new Music SoundProxy from a file.

Parameters

FileName	The name of the file to read audio data from.
Group	The resource group in which the file resides.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 106 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateMusicSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const Audio::Encoding	Encode
	)

virtual

Creates a new Music SoundProxy from a memory buffer that is encoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 115 of file soundscapemanager.cpp.

SoundProxy * Mezzanine::Audio::SoundScapeManager::CreateMusicSoundProxy	(	const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

virtual

Creates a new Music SoundProxy from a memory buffer that is unencoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

Definition at line 124 of file soundscapemanager.cpp.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::CreateSoundProxy ( const UInt16 Type)

pure virtual

Creates a blank SoundProxy without a stream attached to it.

Parameters

Type	A UInt16 that is the ID for the type of sound the created SoundProxy is to be categorized as.

Returns: Returns a pointer to the SoundProxy instance that was created.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::CreateSoundProxy	(	const UInt16	Type,
		Resource::DataStreamPtr	Stream,
		const Audio::Encoding	Encode
	)

pure virtual

Creates a new SoundProxy from a custom stream that is encoded.

Parameters

Type	A UInt16 that is the ID for the type of sound the created SoundProxy is to be categorized as.
Stream	A Datastream containing the data to be streamed for this SoundProxy.
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::CreateSoundProxy	(	const UInt16	Type,
		Resource::DataStreamPtr	Stream,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

pure virtual

Creates a new SoundProxy from a custom stream that is unencoded.

Parameters

Type	A UInt16 that is the ID for the type of sound the created SoundProxy is to be categorized as.
Stream	A Datastream containing the data to be streamed for this SoundProxy.
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::CreateSoundProxy	(	const UInt16	Type,
		const String &	FileName,
		const String &	Group
	)

pure virtual

Creates a new SoundProxy from a file.

Parameters

Type	A UInt16 that is the ID for the type of sound the created SoundProxy is to be categorized as.
FileName	The name of the file to read audio data from.
Group	The resource group in which the file resides.

Returns: Returns a pointer to the SoundProxy instance that was created.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::CreateSoundProxy	(	const UInt16	Type,
		const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const Audio::Encoding	Encode
	)

pure virtual

Creates a new SoundProxy from a memory buffer that is encoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

Type	A UInt16 that is the ID for the type of sound the created SoundProxy is to be categorized as.
StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Encode	The encoding to be expected when decoding audio for this SoundProxy.

Returns: Returns a pointer to the SoundProxy instance that was created.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::CreateSoundProxy	(	const UInt16	Type,
		const String &	StreamName,
		Char8 *	Buffer,
		const UInt32	Length,
		const UInt32	Frequency,
		const Audio::BitConfig	Config
	)

pure virtual

Creates a new SoundProxy from a memory buffer that is unencoded.

Note: The buffer is copied and put into a memory stream. Thus safe for disposal afterward.

Parameters

Type	A UInt16 that is the ID for the type of sound the created SoundProxy is to be categorized as.
StreamName	The name to be given to the stream being created.
Buffer	A pointer to the buffer where the audio data is located.
Length	The length of the buffer provided to this method(in bytes).
Frequency	The frequency (or sample rate) of the audio data.
Config	The bit configuration of the audio data. Helps to determine sample size.

Returns: Returns a pointer to the SoundProxy instance that was created.

virtual void Mezzanine::Audio::SoundScapeManager::Deinitialize ( )

pure virtual

Removes this manager from any necessary configuration so it can be safely disposed of.

Implements Mezzanine::ManagerBase.

virtual void Mezzanine::Audio::SoundScapeManager::DestroyListener ( iListener * ToBeDestroyed)

pure virtual

Deletes a iListener.

Parameters

ToBeDestroyed A pointer to the iListener you want deleted.

virtual void Mezzanine::Audio::SoundScapeManager::DestroySoundProxy ( SoundProxy * ToBeDestroyed)

pure virtual

Deletes a SoundProxy.

Parameters

ToBeDestroyed A pointer to the SoundProxy you want deleted.

virtual iBufferUpdate3DWorkUnit* Mezzanine::Audio::SoundScapeManager::GetBufferUpdate3DWork ( )

pure virtual

Gets the work unit responsible for updating the buffers of soundproxies.

Returns: Returns a pointer to the iBufferUpdate3DWorkUnit used by this manager.

ManagerBase::ManagerType Mezzanine::Audio::SoundScapeManager::GetInterfaceType ( ) const

virtual

This returns the type of this manager.

This is intended to make using and casting from Manager base easier. With this is is possible to cast from ManagerBase to the correct Manager Type.

Returns: This returns a ManagerTypeName to identify what this can be safely cast to.

Implements Mezzanine::ManagerBase.

Definition at line 130 of file soundscapemanager.cpp.

virtual iListener* Mezzanine::Audio::SoundScapeManager::GetListener ( const UInt32 Index) const

pure virtual

Gets an iListener instance by index.

Parameters

Index The index of the iListener to be retrieved.

Returns: Returns a pointer to the iListener at the specified index.

virtual UInt32 Mezzanine::Audio::SoundScapeManager::GetNumListeners ( ) const

pure virtual

Gets the number of iListener instances in this manager.

Returns: Returns a UInt32 representing the number of iListener instances contained in this manager.

virtual UInt32 Mezzanine::Audio::SoundScapeManager::GetNumSoundProxies ( ) const

pure virtual

Gets the number of SoundProxy instances in this manager.

Returns: Returns a UInt32 representing the number of SoundProxy instances contained in this manager.

virtual SoundProxy* Mezzanine::Audio::SoundScapeManager::GetSoundProxy ( const UInt32 Index) const

pure virtual

Gets an SoundProxy instance by index.

Parameters

Index The index of the SoundProxy to be retrieved.

Returns: Returns a pointer to the SoundProxy at the specified index.

virtual void Mezzanine::Audio::SoundScapeManager::Initialize ( )

pure virtual

Configures this manager for use prior to entering the main loop.

Exceptions

If	this is called while no valid world is set, this will throw an "INVALID_STATE_EXCEPTION".

Reimplemented from Mezzanine::WorldManager.

virtual void Mezzanine::Audio::SoundScapeManager::Pause ( const UInt32 PL)

pure virtual

Sets the pause state of this manager, or has no effect depending on the value passed in.

Parameters

PL	A bitfield describing the pause level being assigned to the parent world of this manager.

Implements Mezzanine::WorldManager.

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

/home/sqeaky/Code/Mezzanine/Mezzanine/src/Audio/soundscapemanager.h
/home/sqeaky/Code/Mezzanine/Mezzanine/src/Audio/soundscapemanager.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation