Colobot
Public Member Functions | List of all members
CSoundInterface Class Reference

Sound plugin interface. More...

#include <sound.h>

Inheritance diagram for CSoundInterface:
Inheritance graph
[legend]

Public Member Functions

virtual bool Create ()
 
void CacheAll ()
 
void AddMusicFiles ()
 
virtual bool Cache (Sound bSound, const std::string &bFile)
 
virtual bool CacheMusic (const std::string &bFile)
 
virtual bool IsCached (Sound bSound)
 
virtual bool IsCachedMusic (const std::string &bFile)
 
virtual bool GetEnable ()
 
virtual void SetAudioVolume (int volume)
 
virtual int GetAudioVolume ()
 
virtual void SetMusicVolume (int volume)
 
virtual int GetMusicVolume ()
 
virtual void SetListener (const Math::Vector &eye, const Math::Vector &lookat)
 
virtual void FrameMove (float rTime)
 
virtual int Play (Sound sound, float amplitude=1.0f, float frequency=1.0f, bool bLoop=false)
 
virtual int Play (Sound sound, const Math::Vector &pos, float amplitude=1.0f, float frequency=1.0f, bool bLoop=false)
 
virtual bool FlushEnvelope (int channel)
 
virtual bool AddEnvelope (int channel, float amplitude, float frequency, float time, SoundNext oper)
 
virtual bool Position (int channel, const Math::Vector &pos)
 
virtual bool Frequency (int channel, float frequency)
 
virtual bool Stop (int channel)
 
virtual bool StopAll ()
 
virtual bool MuteAll (bool bMute)
 
virtual bool PlayMusic (int rank, bool bRepeat, float fadeTime=2.0f)
 
virtual bool PlayMusic (const std::string &filename, bool bRepeat, float fadeTime=2.0f)
 
virtual bool RestartMusic ()
 
virtual void SuspendMusic ()
 
virtual void StopMusic (float fadeTime=2.0f)
 
virtual bool IsPlayingMusic ()
 
virtual bool PlayPauseMusic (const std::string &filename, bool repeat)
 
virtual void StopPauseMusic ()
 

Detailed Description

Sound plugin interface.

Member Function Documentation

bool CSoundInterface::AddEnvelope ( int  channel,
float  amplitude,
float  frequency,
float  time,
SoundNext  oper 
)
virtual

Add envelope to sound. Envelope is a operatino that will be performend on sound in future like changing frequency

Parameters
channel- channel to work on
amplitude- change amplitude
frequency- change frequency
time- when to change (sample time)
oper- operation to perform
Returns
return true on success

Reimplemented in ALSound.

void CSoundInterface::AddMusicFiles ( )

Function called to add all music files to list

bool CSoundInterface::Cache ( Sound  bSound,
const std::string &  bFile 
)
virtual

Function called to cache sound effect file. This function is called by plugin interface for each file.

Parameters
bSound- id of a file, will be used to identify sound files
bFile- file to load
Returns
return true on success

Reimplemented in ALSound.

void CSoundInterface::CacheAll ( )

Function called to cache all sound effect files. Function calls CSoundInterface::Cache() for each file

bool CSoundInterface::CacheMusic ( const std::string &  bFile)
virtual

Function called to cache music file. This function is called by CRobotMain for each file used in the mission.

Parameters
bFile- file to load
Returns
return true on success

Reimplemented in ALSound.

bool CSoundInterface::Create ( )
virtual

Function to initialize sound device

Reimplemented in ALSound.

bool CSoundInterface::FlushEnvelope ( int  channel)
virtual

Remove all operations that would be made on sound in channel.

Parameters
channel- channel to work on
Returns
return true on success

Reimplemented in ALSound.

void CSoundInterface::FrameMove ( float  rTime)
virtual

Update data each frame

Parameters
rTime- time since last update

Reimplemented in ALSound.

bool CSoundInterface::Frequency ( int  channel,
float  frequency 
)
virtual

Set sound frequency

Parameters
channel- channel to work on
frequency- change sound frequency
Returns
return true on success

Reimplemented in ALSound.

int CSoundInterface::GetAudioVolume ( )
virtual

Return global sound volume

Returns
global volume as int in range from 0 to MAXVOLUME

Reimplemented in ALSound.

bool CSoundInterface::GetEnable ( )
virtual

Return if plugin is enabled

Returns
return true if plugin is enabled

Reimplemented in ALSound.

int CSoundInterface::GetMusicVolume ( )
virtual

Return music volume

Returns
music volume as int in range from 0 to MAXVOLUME

Reimplemented in ALSound.

bool CSoundInterface::IsCached ( Sound  bSound)
virtual

Function to check if sound effect file was cached.

Parameters
bSound- id of a sound effect file
Returns
return true if the file was cached

Reimplemented in ALSound.

bool CSoundInterface::IsCachedMusic ( const std::string &  bFile)
virtual

Function called to check if music file was cached.

Parameters
bFile- file to check
Returns
return true if the file was cached

Reimplemented in ALSound.

bool CSoundInterface::IsPlayingMusic ( )
virtual

Check if music if playing

Returns
return true if music is playing

Reimplemented in ALSound.

bool CSoundInterface::MuteAll ( bool  bMute)
virtual

Mute/unmute all sounds

Parameters
bMute
Returns
return true on success

Reimplemented in ALSound.

int CSoundInterface::Play ( Sound  sound,
float  amplitude = 1.0f,
float  frequency = 1.0f,
bool  bLoop = false 
)
virtual

Play specific sound

Parameters
sound- sound to play
amplitude- change amplitude of sound before playing
frequency- change sound frequency before playing (0.5 octave down, 2.0 octave up)
bLoop- loop sound
Returns
identifier of channel that sound will be played on

Reimplemented in ALSound.

int CSoundInterface::Play ( Sound  sound,
const Math::Vector pos,
float  amplitude = 1.0f,
float  frequency = 1.0f,
bool  bLoop = false 
)
virtual

Play specific sound

Parameters
sound- sound to play
pos- position of sound in space
amplitude- change amplitude of sound before playing
frequency- change sound frequency before playing (0.5 octave down, 2.0 octave up)
bLoop- loop sound
Returns
identifier of channel that sound will be played on

Reimplemented in ALSound.

bool CSoundInterface::PlayMusic ( int  rank,
bool  bRepeat,
float  fadeTime = 2.0f 
)
virtual

Start playing music

Parameters
rank- track number
bRepeat- repeat playing
fadeTime- time of transition between music
Returns
return true on success

Reimplemented in ALSound.

bool CSoundInterface::PlayMusic ( const std::string &  filename,
bool  bRepeat,
float  fadeTime = 2.0f 
)
virtual

Start playing music

Parameters
filename- name of file to play
bRepeat- repeat playing
fadeTime- time of transition between music
Returns
return true on success

Reimplemented in ALSound.

bool CSoundInterface::PlayPauseMusic ( const std::string &  filename,
bool  repeat 
)
virtual

Start playing pause music

Parameters
filename- name of file to play
Returns
return true on success

Reimplemented in ALSound.

bool CSoundInterface::Position ( int  channel,
const Math::Vector pos 
)
virtual

Set sound position in space

Parameters
channel- channel to work on
pos- new positino of a sound
Returns
return true on success

Reimplemented in ALSound.

bool CSoundInterface::RestartMusic ( )
virtual

Restart music

Returns
return true on success

Reimplemented in ALSound.

void CSoundInterface::SetAudioVolume ( int  volume)
virtual

Change global sound volume

Parameters
volume- range from 0 to MAXVOLUME

Reimplemented in ALSound.

void CSoundInterface::SetListener ( const Math::Vector eye,
const Math::Vector lookat 
)
virtual

Set listener position

Parameters
eye- position of listener
lookat- direction listener is looking at

Reimplemented in ALSound.

void CSoundInterface::SetMusicVolume ( int  volume)
virtual

Set music volume

Parameters
volume- range from 0 to MAXVOLUME

Reimplemented in ALSound.

bool CSoundInterface::Stop ( int  channel)
virtual

Stop playing sound

Parameters
channel- channel to work on
Returns
return true on success

Reimplemented in ALSound.

bool CSoundInterface::StopAll ( )
virtual

Stop playing all sounds

Returns
return true on success

Reimplemented in ALSound.

void CSoundInterface::StopMusic ( float  fadeTime = 2.0f)
virtual

Stop playing music

Returns
nothing

Reimplemented in ALSound.

void CSoundInterface::StopPauseMusic ( )
virtual

Stop playing pause music and return to the mission music

Returns
nothing

Reimplemented in ALSound.

void CSoundInterface::SuspendMusic ( )
virtual

Susspend playing music

Returns
nothing

Reimplemented in ALSound.


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