A single static buffer sound (OGG) More...

#include <OgreOggStaticSound.h>

Inheritance diagram for OgreOggSound::OgreOggStaticSound:

[legend]

Public Member Functions
void	loop (bool loop)

void	setSource (ALuint &src)

bool	isMono ()

virtual const Ogre::String &	getFileName (void) const

Public Member Functions inherited from OgreOggSound::OgreOggISound
void	play (bool immediate=false)

void	pause (bool immediate=false)

void	stop (bool immediate=false)

void	loop (bool loop)

bool	isLooping ()

virtual void	setLoopOffset (float startTime)

float	getLoopOffset ()

void	startFade (bool dir, float fadeTime, FadeControl actionOnCompletion=OgreOggSound::FC_NONE)

bool	isTemporary () const

void	markTemporary ()

void	disable3D (bool disable)

bool	is3Ddisabled ()

virtual void	setPlayPosition (float seconds)

virtual float	getPlayPosition () const

SoundState	getState () const

bool	isPlaying () const

bool	isPaused () const

bool	isStopped () const

bool	isRelativeToListener () const

void	setGiveUpSourceOnStop (bool giveup=false)

void	setPosition (float posx, float posy, float posz)

void	setPosition (const Ogre::Vector3 &pos)

void	setDirection (float dirx, float diry, float dirz)

void	setDirection (const Ogre::Vector3 &dir)

void	setVelocity (float velx, float vely, float velz)

void	setVelocity (const Ogre::Vector3 &vel)

void	setVolume (float gain)

float	getVolume () const

void	setMaxVolume (float maxGain)

float	getMaxVolume ()

void	setMinVolume (float minGain)

float	getMinVolume ()

void	setConeAngles (float insideAngle=360.f, float outsideAngle=360.f)

float	getConeInsideAngle ()

float	getConeOutsideAngle ()

void	setOuterConeVolume (float gain=0.f)

float	getOuterConeVolume ()

void	setMaxDistance (float maxDistance)

const float	getMaxDistance () const

void	setRolloffFactor (float rolloffFactor)

const float	getRolloffFactor () const

void	setReferenceDistance (float referenceDistance)

const float	getReferenceDistance () const

void	setPitch (float pitch)

const float	getPitch () const

void	setRelativeToListener (bool relative)

const Ogre::Vector3 &	getPosition () const

const Ogre::Vector3 &	getDirection () const

bool	isFading () const

virtual void	update (float fTime)

ALuint	getSource () const

const Ogre::String &	getName (void) const

Ogre::uint8	getPriority () const

void	setPriority (Ogre::uint8 priority)

bool	addCuePoint (float seconds)

void	removeCuePoint (unsigned short index)

void	clearCuePoints ()

void	setCuePoint (unsigned short index)

float	getCuePoint (unsigned short index)

unsigned int	getNumCuePoints ()

float	getAudioLength () const

virtual const Ogre::String &	getMovableType (void) const

virtual const Ogre::AxisAlignedBox &	getBoundingBox (void) const

virtual float	getBoundingRadius (void) const

Ogre::SceneManager *	getSceneManager () const

void	setListener (SoundListener *listener)

void	_setSharedProperties (sharedAudioBuffer *buffer)

void	_getSharedProperties (BufferListPtr &buffers, float &length, ALenum &format)

Public Member Functions inherited from Ogre::MovableObject
	MovableObject ()

	MovableObject (const String &name)

virtual	~MovableObject ()

MovableObjectFactory *	_getCreator (void) const

LightList *	_getLightList ()

SceneManager *	_getManager (void) const

virtual const Affine3 &	_getParentNodeFullTransform (void) const

virtual void	_notifyCreator (MovableObjectFactory *fact)

virtual void	_notifyCurrentCamera (Camera *cam)

virtual void	_notifyManager (SceneManager *man)

virtual void	_releaseManualHardwareResources ()

virtual void	_restoreManualHardwareResources ()

void	addQueryFlags (uint32 flags)

void	addVisibilityFlags (uint32 flags)

void	detachFromParent (void)

Real	getBoundingRadiusScaled () const

bool	getCastShadows (void) const

const AxisAlignedBox &	getDarkCapBounds (const Light &light, Real dirLightExtrusionDist) const override

EdgeData *	getEdgeList (void)

const AxisAlignedBox &	getLightCapBounds (void) const override

uint32	getLightMask () const

Listener *	getListener (void) const

const String &	getName (void) const

Node *	getParentNode (void) const

SceneNode *	getParentSceneNode (void) const

Real	getPointExtrusionDistance (const Light *l) const

virtual uint32	getQueryFlags (void) const

bool	getReceivesShadows ()

Real	getRenderingDistance (void) const

Real	getRenderingMinPixelSize () const

uint8	getRenderQueueGroup (void) const

const ShadowRenderableList &	getShadowVolumeRenderableList (ShadowTechnique shadowTechnique, const Light light, HardwareIndexBufferSharedPtr indexBuffer, size_t *indexBufferUsedSize, bool extrudeVertices, Real extrusionDist, unsigned long flags=0)

virtual uint32	getTypeFlags (void) const

const Any &	getUserAny (void) const

UserObjectBindings &	getUserObjectBindings ()

const UserObjectBindings &	getUserObjectBindings () const

virtual uint32	getVisibilityFlags (void) const

bool	getVisible (void) const

virtual const AxisAlignedBox &	getWorldBoundingBox (bool derive=false) const

virtual const Sphere &	getWorldBoundingSphere (bool derive=false) const

bool	isAttached (void) const

bool	isDebugDisplayEnabled (void) const

virtual bool	isInScene (void) const

bool	isParentTagPoint () const

virtual bool	isVisible (void) const

const LightList &	queryLights (void) const

void	removeQueryFlags (uint32 flags)

void	removeVisibilityFlags (uint32 flags)

void	setCastShadows (bool enabled)

void	setDebugDisplayEnabled (bool enabled)

void	setLightMask (uint32 lightMask)

void	setListener (Listener *listener)

void	setQueryFlags (uint32 flags)

void	setRenderingDistance (Real dist)

void	setRenderingMinPixelSize (Real pixelSize)

virtual void	setRenderQueueGroup (uint8 queueID)

virtual void	setRenderQueueGroupAndPriority (uint8 queueID, ushort priority)

void	setUserAny (const Any &anything)

void	setVisibilityFlags (uint32 flags)

void	setVisible (bool visible)

Public Member Functions inherited from Ogre::ShadowCaster
virtual	~ShadowCaster ()

virtual ShadowRenderableListIterator	getShadowVolumeRenderableIterator (ShadowTechnique shadowTechnique, const Light light, HardwareIndexBufferSharedPtr indexBuffer, size_t *indexBufferUsedSize, bool extrudeVertices, Real extrusionDistance, unsigned long flags=0)

bool	hasEdgeList ()

Public Member Functions inherited from Ogre::AnimableObject
	AnimableObject ()

virtual	~AnimableObject ()

virtual AnimableValuePtr	createAnimableValue (const String &valueName)

const StringVector &	getAnimableValueNames (void) const

Protected Member Functions
	OgreOggStaticSound (const Ogre::String &name, Ogre::SceneManager *scnMgr)

	~OgreOggStaticSound ()

void	release ()

void	_openImpl (Ogre::DataStreamPtr &fileStream)

void	_openImpl (const Ogre::String &fName, sharedAudioBuffer *buffer)

void	_stopImpl ()

void	_pauseImpl ()

void	_playImpl ()

void	_updateAudioBuffers ()

void	_prebuffer ()

bool	_queryBufferInfo ()

void	_release ()

Protected Member Functions inherited from OgreOggSound::OgreOggISound
	OgreOggISound (const Ogre::String &name, Ogre::SceneManager *scnMgr)

virtual	~OgreOggISound ()

virtual void	_updateRenderQueue (Ogre::RenderQueue *queue)

virtual void	_notifyAttached (Ogre::Node *node, bool isTagPoint=false)

virtual void	_notifyMoved (void)

virtual void	visitRenderables (Ogre::Renderable::Visitor *visitor, bool debugRenderables)

void	_initSource ()

void	_markPlayPosition ()

void	_recoverPlayPosition ()

void	_updateFade (float fTime=0.f)

Protected Attributes
OggVorbis_File	mOggStream

vorbis_info *	mVorbisInfo

vorbis_comment *	mVorbisComment

Ogre::String	mAudioName

std::vector< char >	mBufferData

ALint	mPreviousOffset

Protected Attributes inherited from OgreOggSound::OgreOggISound
float	mFadeTimer

float	mFadeTime

float	mFadeInitVol

float	mFadeEndVol

bool	mFade

FadeControl	mFadeEndAction

Ogre::DataStreamPtr	mAudioStream

ov_callbacks	mOggCallbacks

SoundListener *	mSoundListener

size_t	mBufferSize

ALuint	mSource

Ogre::SceneManager *	mScnMgr

Ogre::uint8	mPriority

Ogre::Vector3	mPosition

Ogre::Vector3	mDirection

Ogre::Vector3	mVelocity

float	mGain

float	mMaxGain

float	mMinGain

float	mMaxDistance

float	mRolloffFactor

float	mReferenceDistance

float	mPitch

float	mOuterConeGain

float	mInnerConeAngle

float	mOuterConeAngle

float	mPlayTime

Ogre::String	mName

SoundState	mState

bool	mLoop

bool	mDisable3D

bool	mGiveUpSource

bool	mStream

bool	mSourceRelative

bool	mLocalTransformDirty

bool	mPlayPosChanged

bool	mSeekable

bool	mTemporary

bool	mInitialised

Ogre::uint8	mAwaitingDestruction

BufferListPtr	mBuffers

ALenum	mFormat

unsigned long	mAudioOffset

unsigned long	mAudioEnd

float	mLoopOffset

float	mLoopStart

ALfloat	mPlayPos

std::deque< float >	mCuePoints

Friends
class	OgreOggSoundManager

Additional Inherited Members
Public Types inherited from Ogre::ShadowCaster
typedef std::vector< ShadowRenderable * >	ShadowRenderableList

typedef VectorIterator< ShadowRenderableList >	ShadowRenderableListIterator

Static Public Member Functions inherited from Ogre::MovableObject
static uint32	getDefaultQueryFlags ()

static uint32	getDefaultVisibilityFlags ()

static void	setDefaultQueryFlags (uint32 flags)

static void	setDefaultVisibilityFlags (uint32 flags)

Static Public Member Functions inherited from Ogre::ShadowCaster
static void	clearShadowRenderableList (ShadowRenderableList &shadowRenderables)

static void	extrudeVertices (const HardwareVertexBufferSharedPtr &vertexBuffer, size_t originalVertexCount, const Vector4 &lightPos, Real extrudeDist)

Detailed Description

A single static buffer sound (OGG)

Handles playing a sound from memory.

Constructor & Destructor Documentation

◆ OgreOggStaticSound()

OgreOggSound::OgreOggStaticSound::OgreOggStaticSound	(	const Ogre::String &	name,
		Ogre::SceneManager *	scnMgr
	)

protected

Constructor

Remarks: Creates a static sound object for playing audio from an OGG file.

Parameters

name	Unique name for sound.
scnMgr	SceneManager which created this sound (if the sound was created through the plugin method createMovableobject()).

◆ ~OgreOggStaticSound()

OgreOggSound::OgreOggStaticSound::~OgreOggStaticSound ( )

protected

Destructor

Member Function Documentation

◆ _openImpl() [1/2]

void OgreOggSound::OgreOggStaticSound::_openImpl	(	const Ogre::String &	fName,
		sharedAudioBuffer *	buffer
	)

protectedvirtual

Opens audio file.

Remarks: Uses a shared buffer.

Parameters

fName	Audio file name
buffer	Shared buffer reference

Reimplemented from OgreOggSound::OgreOggISound.

◆ _openImpl() [2/2]

void OgreOggSound::OgreOggStaticSound::_openImpl ( Ogre::DataStreamPtr & fileStream )

protectedvirtual

Opens audio file.

Remarks: Opens a specified file and checks validity. Reads first chunks of audio data into buffers.

Parameters

fileStream File stream pointer

Implements OgreOggSound::OgreOggISound.

◆ _pauseImpl()

void OgreOggSound::OgreOggStaticSound::_pauseImpl ( )

protectedvirtual

Pauses sound.

Remarks: Pauses playback on the source.

Implements OgreOggSound::OgreOggISound.

◆ _playImpl()

void OgreOggSound::OgreOggStaticSound::_playImpl ( )

protectedvirtual

Plays the sound.

Remarks: Begins playback of all buffers queued on the source. If a source hasn't been setup yet it is requested and initialised within this call.

Implements OgreOggSound::OgreOggISound.

◆ _prebuffer()

void OgreOggSound::OgreOggStaticSound::_prebuffer ( )

protectedvirtual

Prefills buffer with audio data.

Remarks: Loads audio data onto the source ready for playback.

Implements OgreOggSound::OgreOggISound.

◆ _queryBufferInfo()

bool OgreOggSound::OgreOggStaticSound::_queryBufferInfo ( )

protectedvirtual

Calculates buffer size and format.

Remarks: Calculates a block aligned buffer size of 250ms using sound properties.

Implements OgreOggSound::OgreOggISound.

◆ _release()

void OgreOggSound::OgreOggStaticSound::_release ( )

protectedvirtual

Releases buffers and OpenAL objects.

Remarks: Cleans up this sounds OpenAL objects, including buffers and file pointers ready for destruction.

Implements OgreOggSound::OgreOggISound.

◆ _stopImpl()

void OgreOggSound::OgreOggStaticSound::_stopImpl ( )

protectedvirtual

Stops playing sound.

Remarks: Stops playing audio immediately. If specified to do so its source will be released also.

Implements OgreOggSound::OgreOggISound.

◆ _updateAudioBuffers()

void OgreOggSound::OgreOggStaticSound::_updateAudioBuffers ( )

protectedvirtual

Updates the data buffers with sound information.

Remarks: This function refills processed buffers with audio data from the stream, it automatically handles looping if set.

Implements OgreOggSound::OgreOggISound.

◆ getFileName()

virtual const Ogre::String& OgreOggSound::OgreOggStaticSound::getFileName ( void ) const

inlinevirtual

Gets the sounds file name

Reimplemented from OgreOggSound::OgreOggISound.

◆ isMono()

bool OgreOggSound::OgreOggStaticSound::isMono ( )

virtual

Returns whether sound is mono

Implements OgreOggSound::OgreOggISound.

◆ loop()

void OgreOggSound::OgreOggStaticSound::loop ( bool loop )

Sets the loop status.

Remarks: Immediately sets the loop status if a source is associated

Parameters

loop true=loop

◆ release()

void OgreOggSound::OgreOggStaticSound::release ( )

protected

Releases buffers.

Remarks: Cleans up and releases OpenAL buffer objects.

◆ setSource()

void OgreOggSound::OgreOggStaticSound::setSource ( ALuint & src )

virtual

Sets the source to use for playback.

Remarks: Sets the source object this sound will use to queue buffers onto for playback. Also handles refilling buffers and queuing up.

Parameters

src	OpenAL Source ID.

Implements OgreOggSound::OgreOggISound.

Friends And Related Function Documentation

◆ OgreOggSoundManager

friend class OgreOggSoundManager

friend

Member Data Documentation

◆ mAudioName

Ogre::String OgreOggSound::OgreOggStaticSound::mAudioName

protected

◆ mBufferData

std::vector<char> OgreOggSound::OgreOggStaticSound::mBufferData

protected

◆ mOggStream

OggVorbis_File OgreOggSound::OgreOggStaticSound::mOggStream

protected

Ogg file variables

◆ mPreviousOffset

ALint OgreOggSound::OgreOggStaticSound::mPreviousOffset

protected

◆ mVorbisComment

vorbis_comment* OgreOggSound::OgreOggStaticSound::mVorbisComment

protected

◆ mVorbisInfo

vorbis_info* OgreOggSound::OgreOggStaticSound::mVorbisInfo

protected

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

OgreOggStaticSound.h

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ OgreOggStaticSound()

◆ ~OgreOggStaticSound()

Member Function Documentation

◆ _openImpl() [1/2]

◆ _openImpl() [2/2]

◆ _pauseImpl()

◆ _playImpl()

◆ _prebuffer()

◆ _queryBufferInfo()

◆ _release()

◆ _stopImpl()

◆ _updateAudioBuffers()

◆ getFileName()

◆ isMono()

◆ loop()

◆ release()

◆ setSource()

Friends And Related Function Documentation

◆ OgreOggSoundManager

Member Data Documentation

◆ mAudioName

◆ mBufferData

◆ mOggStream

◆ mPreviousOffset

◆ mVorbisComment

◆ mVorbisInfo