#include <cstdlib>
#include <cstring>
#include <cmath>
#include "AUD_NULLDevice.h"
#include "AUD_I3DDevice.h"
#include "AUD_FileFactory.h"
#include "AUD_StreamBufferFactory.h"
#include "AUD_DelayFactory.h"
#include "AUD_LimiterFactory.h"
#include "AUD_PingPongFactory.h"
#include "AUD_LoopFactory.h"
#include "AUD_RectifyFactory.h"
#include "AUD_EnvelopeFactory.h"
#include "AUD_LinearResampleFactory.h"
#include "AUD_LowpassFactory.h"
#include "AUD_HighpassFactory.h"
#include "AUD_AccumulatorFactory.h"
#include "AUD_SumFactory.h"
#include "AUD_SquareFactory.h"
#include "AUD_ChannelMapperFactory.h"
#include "AUD_Buffer.h"
#include "AUD_ReadDevice.h"
#include "AUD_IReader.h"
#include "AUD_SequencerFactory.h"
#include "AUD_SilenceFactory.h"
#include <cassert>
#include "AUD_C-API.h"

Defines
#define	__STDC_CONSTANT_MACROS
#define	AUD_CAPI_IMPLEMENTATION
#define	NULL 0
Typedefs
typedef AUD_IFactory	AUD_Sound
typedef AUD_ReadDevice	AUD_Device
typedef AUD_Handle	AUD_Channel
Functions
void	AUD_initOnce ()
int	AUD_init (AUD_DeviceType device, AUD_DeviceSpecs specs, int buffersize)
void	AUD_exit ()
void	AUD_lock ()
void	AUD_unlock ()
AUD_SoundInfo	AUD_getInfo (AUD_Sound *sound)
AUD_Sound *	AUD_load (const char *filename)
AUD_Sound *	AUD_loadBuffer (unsigned char *buffer, int size)
AUD_Sound *	AUD_bufferSound (AUD_Sound *sound)
AUD_Sound *	AUD_delaySound (AUD_Sound *sound, float delay)
AUD_Sound *	AUD_limitSound (AUD_Sound *sound, float start, float end)
AUD_Sound *	AUD_pingpongSound (AUD_Sound *sound)
AUD_Sound *	AUD_loopSound (AUD_Sound *sound)
int	AUD_setLoop (AUD_Channel *handle, int loops)
AUD_Sound *	AUD_rectifySound (AUD_Sound *sound)
void	AUD_unload (AUD_Sound *sound)
AUD_Channel *	AUD_play (AUD_Sound *sound, int keep)
int	AUD_pause (AUD_Channel *handle)
int	AUD_resume (AUD_Channel *handle)
int	AUD_stop (AUD_Channel *handle)
int	AUD_setKeep (AUD_Channel *handle, int keep)
int	AUD_seek (AUD_Channel *handle, float seekTo)
float	AUD_getPosition (AUD_Channel *handle)
AUD_Status	AUD_getStatus (AUD_Channel *handle)
int	AUD_setListenerLocation (const float *location)
int	AUD_setListenerVelocity (const float *velocity)
int	AUD_setListenerOrientation (const float *orientation)
int	AUD_setSpeedOfSound (float speed)
int	AUD_setDopplerFactor (float factor)
int	AUD_setDistanceModel (AUD_DistanceModel model)
int	AUD_setSourceLocation (AUD_Channel handle, const float location)
int	AUD_setSourceVelocity (AUD_Channel handle, const float velocity)
int	AUD_setSourceOrientation (AUD_Channel handle, const float orientation)
int	AUD_setRelative (AUD_Channel *handle, int relative)
int	AUD_setVolumeMaximum (AUD_Channel *handle, float volume)
int	AUD_setVolumeMinimum (AUD_Channel *handle, float volume)
int	AUD_setDistanceMaximum (AUD_Channel *handle, float distance)
int	AUD_setDistanceReference (AUD_Channel *handle, float distance)
int	AUD_setAttenuation (AUD_Channel *handle, float factor)
int	AUD_setConeAngleOuter (AUD_Channel *handle, float angle)
int	AUD_setConeAngleInner (AUD_Channel *handle, float angle)
int	AUD_setConeVolumeOuter (AUD_Channel *handle, float volume)
int	AUD_setSoundVolume (AUD_Channel *handle, float volume)
int	AUD_setSoundPitch (AUD_Channel *handle, float pitch)
AUD_Device *	AUD_openReadDevice (AUD_DeviceSpecs specs)
AUD_Channel *	AUD_playDevice (AUD_Device device, AUD_Sound sound, float seek)
int	AUD_setDeviceVolume (AUD_Device *device, float volume)
int	AUD_setDeviceSoundVolume (AUD_Device device, AUD_Channel handle, float volume)
int	AUD_readDevice (AUD_Device device, data_t buffer, int length)
void	AUD_closeReadDevice (AUD_Device *device)
float *	AUD_readSoundBuffer (const char filename, float low, float high, float attack, float release, float threshold, int accumulate, int additive, int square, float sthreshold, int samplerate, int length)
static void	pauseSound (AUD_Channel *handle)
AUD_Channel *	AUD_pauseAfter (AUD_Channel *handle, float seconds)
AUD_Sound *	AUD_createSequencer (int muted, void *data, AUD_volumeFunction volume)
void	AUD_destroySequencer (AUD_Sound *sequencer)
void	AUD_setSequencerMuted (AUD_Sound *sequencer, int muted)
AUD_SequencerEntry *	AUD_addSequencer (AUD_Sound *sequencer, AUD_Sound sound, float begin, float end, float skip, void *data)
void	AUD_removeSequencer (AUD_Sound sequencer, AUD_SequencerEntry entry)
void	AUD_moveSequencer (AUD_Sound sequencer, AUD_SequencerEntry entry, float begin, float end, float skip)
void	AUD_muteSequencer (AUD_Sound sequencer, AUD_SequencerEntry entry, char mute)
int	AUD_readSound (AUD_Sound sound, sample_t buffer, int length)
void	AUD_startPlayback ()
void	AUD_stopPlayback ()
void	AUD_seekSequencer (AUD_Channel *handle, float time)
float	AUD_getSequencerPosition (AUD_Channel *handle)
int	AUD_doesPlayback ()
Variables
static AUD_IDevice *	AUD_device = NULL
static AUD_I3DDevice *	AUD_3ddevice = NULL

Detailed Description

Definition in file AUD_C-API.cpp.

Define Documentation

#define __STDC_CONSTANT_MACROS

Definition at line 34 of file AUD_C-API.cpp.

#define AUD_CAPI_IMPLEMENTATION

Definition at line 97 of file AUD_C-API.cpp.

#define NULL 0

Definition at line 101 of file AUD_C-API.cpp.

Referenced by AUD_bufferSound(), AUD_delaySound(), AUD_exit(), AUD_init(), AUD_limitSound(), AUD_loopSound(), AUD_openReadDevice(), AUD_pauseAfter(), AUD_pingpongSound(), AUD_play(), AUD_playDevice(), AUD_readSoundBuffer(), and AUD_rectifySound().

Typedef Documentation

typedef AUD_Handle AUD_Channel

Definition at line 95 of file AUD_C-API.cpp.

typedef AUD_ReadDevice AUD_Device

Definition at line 94 of file AUD_C-API.cpp.

typedef AUD_IFactory AUD_Sound

Definition at line 93 of file AUD_C-API.cpp.

Function Documentation

AUD_SequencerEntry* AUD_addSequencer	(	AUD_Sound **	sequencer,
		AUD_Sound *	sound,
		float	begin,
		float	end,
		float	skip,
		void *	data
	)

Definition at line 890 of file AUD_C-API.cpp.

AUD_Sound* AUD_bufferSound ( AUD_Sound * sound )

Buffers a sound.

Parameters:

sound The sound to buffer.

Returns:: A handle of the sound buffer.

Definition at line 272 of file AUD_C-API.cpp.

References assert, and NULL.

void AUD_closeReadDevice ( AUD_Device * device )

Closes a read device.

Parameters:

device The read device.

Definition at line 766 of file AUD_C-API.cpp.

References assert.

AUD_Sound* AUD_createSequencer	(	int	muted,
		void *	data,
		AUD_volumeFunction	volume
	)

Definition at line 867 of file AUD_C-API.cpp.

References AUD_CHANNELS_STEREO, AUD_RATE_44100, AUD_Specs::channels, and AUD_Specs::rate.

AUD_Sound* AUD_delaySound	(	AUD_Sound *	sound,
		float	delay
	)

Delays a sound.

Parameters:

sound	The sound to dealy.
delay	The delay in seconds.

Returns:: A handle of the delayed sound.

Definition at line 286 of file AUD_C-API.cpp.

References assert, and NULL.

void AUD_destroySequencer ( AUD_Sound * sequencer )

Definition at line 880 of file AUD_C-API.cpp.

int AUD_doesPlayback ( void )

Definition at line 1010 of file AUD_C-API.cpp.

References AUD_device, and AUD_JackDevice::doesPlayback().

void AUD_exit ( void )

Unitinitializes an audio device.

Definition at line 169 of file AUD_C-API.cpp.

References AUD_device, and NULL.

Referenced by AUD_init().

AUD_SoundInfo AUD_getInfo ( AUD_Sound * sound )

Returns information about a sound.

Parameters:

sound The sound to get the info about.

Returns:: The AUD_SoundInfo structure with filled in data.

Definition at line 233 of file AUD_C-API.cpp.

References assert, AUD_CHANNELS_INVALID, AUD_RATE_INVALID, AUD_Specs::channels, AUD_IFactory::createReader(), AUD_IReader::getLength(), AUD_IReader::getSpecs(), AUD_SoundInfo::length, AUD_Specs::rate, and AUD_SoundInfo::specs.

Referenced by reload_sequence_new_file().

float AUD_getPosition ( AUD_Channel * handle )

Retrieves the playback position of a handle.

Parameters:

handle The handle to the sound.

Returns:: The current playback position in seconds or 0.0 if the handle is invalid.

Definition at line 422 of file AUD_C-API.cpp.

References assert, and AUD_IDevice::getPosition().

Referenced by KX_SoundActuator::Update().

float AUD_getSequencerPosition ( AUD_Channel * handle )

Definition at line 988 of file AUD_C-API.cpp.

References AUD_device, AUD_JackDevice::getPlaybackPosition(), and AUD_IDevice::getPosition().

AUD_Status AUD_getStatus ( AUD_Channel * handle )

Returns the status of a playing, paused or stopped sound.

Parameters:

handle The handle to the sound.

Returns:: The status of the sound behind the handle.

Definition at line 428 of file AUD_C-API.cpp.

References assert, and AUD_IDevice::getStatus().

Referenced by KX_SoundActuator::Update().

int AUD_init	(	AUD_DeviceType	device,
		AUD_DeviceSpecs	specs,
		int	buffersize
	)

Initializes an audio device.

Parameters:

device	The device type that should be used.
specs	The audio specification to be used.
buffersize	The buffersize for the device.

Returns:: Whether the device has been initialized.

Definition at line 114 of file AUD_C-API.cpp.

References AUD_device, AUD_exit(), AUD_JACK_DEVICE, AUD_NULL_DEVICE, AUD_OPENAL_DEVICE, AUD_SDL_DEVICE, Device::device, Device_empty(), and NULL.

void AUD_initOnce ( void )

Initializes FFMPEG if it is enabled.

Definition at line 107 of file AUD_C-API.cpp.

AUD_Sound* AUD_limitSound	(	AUD_Sound *	sound,
		float	start,
		float	end
	)

Limits a sound.

Parameters:

sound	The sound to limit.
start	The start time in seconds.
end	The stop time in seconds.

Returns:: A handle of the limited sound.

Definition at line 300 of file AUD_C-API.cpp.

References assert, and NULL.

AUD_Sound* AUD_load ( const char * filename )

Loads a sound file.

Parameters:

filename The filename of the sound file.

Returns:: A handle of the sound file.

Definition at line 260 of file AUD_C-API.cpp.

References assert.

AUD_Sound* AUD_loadBuffer	(	unsigned char *	buffer,
		int	size
	)

Loads a sound file.

Parameters:

buffer	The buffer which contains the sound file.
size	The size of the buffer.

Returns:: A handle of the sound file.

Definition at line 266 of file AUD_C-API.cpp.

References assert.

void AUD_lock ( void )

Locks the playback device.

Definition at line 221 of file AUD_C-API.cpp.

References assert, and AUD_IDevice::lock().

AUD_Sound* AUD_loopSound ( AUD_Sound * sound )

Loops a sound.

Parameters:

sound The sound to loop.

Returns:: A handle of the looped sound.

Definition at line 328 of file AUD_C-API.cpp.

References assert, and NULL.

void AUD_moveSequencer	(	AUD_Sound *	sequencer,
		AUD_SequencerEntry *	entry,
		float	begin,
		float	end,
		float	skip
	)

Definition at line 901 of file AUD_C-API.cpp.

void AUD_muteSequencer	(	AUD_Sound *	sequencer,
		AUD_SequencerEntry *	entry,
		char	mute
	)

Definition at line 907 of file AUD_C-API.cpp.

AUD_Device* AUD_openReadDevice ( AUD_DeviceSpecs specs )

Opens a read device, with which audio data can be read.

Parameters:

specs The specification of the audio data.

Returns:: A device handle.

Definition at line 692 of file AUD_C-API.cpp.

References NULL.

int AUD_pause ( AUD_Channel * handle )

Pauses a played back sound.

Parameters:

handle The handle to the sound.

Returns:: Whether the handle has been playing or not.

Definition at line 391 of file AUD_C-API.cpp.

References assert, and AUD_IDevice::pause().

Referenced by KX_SoundActuator::Update().

AUD_Channel* AUD_pauseAfter	(	AUD_Channel *	handle,
		float	seconds
	)

Pauses a playing sound after a specific amount of time.

Parameters:

handle	The handle to the sound.
time	The time in seconds.

Returns:: The silence handle.

Definition at line 848 of file AUD_C-API.cpp.

References assert, NULL, pauseSound(), AUD_IDevice::play(), and AUD_IDevice::setStopCallback().

AUD_Sound* AUD_pingpongSound ( AUD_Sound * sound )

Ping pongs a sound.

Parameters:

sound The sound to ping pong.

Returns:: A handle of the ping pong sound.

Definition at line 314 of file AUD_C-API.cpp.

References assert, and NULL.

AUD_Channel* AUD_play	(	AUD_Sound *	sound,
		int	keep
	)

Plays back a sound file.

Parameters:

sound	The handle of the sound file.
keep	When keep is true the sound source will not be deleted but set to paused when its end has been reached.

Returns:: A handle to the played back sound.

Definition at line 377 of file AUD_C-API.cpp.

References assert, NULL, and AUD_IDevice::play().

AUD_Channel* AUD_playDevice	(	AUD_Device *	device,
		AUD_Sound *	sound,
		float	seek
	)

Plays back a sound file through a read device.

Parameters:

device	The read device.
sound	The handle of the sound file.
seek	The position where the sound should be seeked to.

Returns:: A handle to the played back sound.

Definition at line 704 of file AUD_C-API.cpp.

References assert, NULL, AUD_SoftwareDevice::play(), and AUD_SoftwareDevice::seek().

int AUD_readDevice	(	AUD_Device *	device,
		data_t *	buffer,
		int	length
	)

Reads the next samples into the supplied buffer.

Parameters:

device	The read device.
buffer	The target buffer.
length	The length in samples to be filled.

Returns:: True if the reading succeeded, false if there are no sounds played back currently, in that case the buffer is filled with silence.

Definition at line 751 of file AUD_C-API.cpp.

References assert, and AUD_ReadDevice::read().

int AUD_readSound	(	AUD_Sound *	sound,
		sample_t *	buffer,
		int	length
	)

Definition at line 912 of file AUD_C-API.cpp.

References AUD_CHANNELS_MONO, AUD_FORMAT_INVALID, AUD_RATE_INVALID, AUD_DeviceSpecs::channels, AUD_ChannelMapperFactory::createReader(), AUD_DeviceSpecs::format, AUD_IReader::getLength(), i, length(), max, min, AUD_DeviceSpecs::rate, and AUD_IReader::read().

float* AUD_readSoundBuffer	(	const char *	filename,
		float	low,
		float	high,
		float	attack,
		float	release,
		float	threshold,
		int	accumulate,
		int	additive,
		int	square,
		float	sthreshold,
		int	samplerate,
		int *	length
	)

Reads a sound file into a newly created float buffer. The sound is therefore bandpassed, rectified and resampled.

Definition at line 779 of file AUD_C-API.cpp.

References AUD_CHANNELS_MONO, AUD_DeviceSpecs::channels, AUD_IFactory::createReader(), AUD_FileFactory::createReader(), AUD_Buffer::getBuffer(), AUD_IReader::getSpecs(), NULL, AUD_Specs::rate, AUD_DeviceSpecs::rate, AUD_IReader::read(), AUD_Buffer::resize(), and sum().

AUD_Sound* AUD_rectifySound ( AUD_Sound * sound )

Rectifies a sound.

Parameters:

sound The sound to rectify.

Returns:: A handle of the rectified sound.

Definition at line 357 of file AUD_C-API.cpp.

References assert, and NULL.

void AUD_removeSequencer	(	AUD_Sound *	sequencer,
		AUD_SequencerEntry *	entry
	)

Definition at line 896 of file AUD_C-API.cpp.

int AUD_resume ( AUD_Channel * handle )

Resumes a paused sound.

Parameters:

handle The handle to the sound.

Returns:: Whether the handle has been paused or not.

Definition at line 397 of file AUD_C-API.cpp.

References assert, and AUD_IDevice::resume().

Referenced by KX_SoundActuator::Update().

int AUD_seek	(	AUD_Channel *	handle,
		float	seekTo
	)

Seeks a playing or paused sound.

Parameters:

handle	The handle to the sound.
seekTo	From where the sound file should be played back in seconds.

Returns:: Whether the handle has been valid or not.

Definition at line 416 of file AUD_C-API.cpp.

References assert, and AUD_IDevice::seek().

Referenced by KX_SoundActuator::Update().

void AUD_seekSequencer	(	AUD_Channel *	handle,
		float	time
	)

Definition at line 975 of file AUD_C-API.cpp.

References AUD_device, AUD_IDevice::seek(), and AUD_JackDevice::seekPlayback().

int AUD_setAttenuation	(	AUD_Channel *	handle,
		float	factor
	)

Sets the attenuation of a source. This value is used for distance calculation.

Parameters:

handle	The handle of the source.
factor	The new attenuation.

Returns:: Whether the action succeeded.

Definition at line 614 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setAttenuation().

Referenced by KX_SoundActuator::Update().

int AUD_setConeAngleInner	(	AUD_Channel *	handle,
		float	angle
	)

Sets the inner angle of the cone of a source.

Parameters:

handle	The handle of the source.
angle	The new inner angle of the cone.

Returns:: Whether the action succeeded.

Definition at line 638 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setConeAngleInner().

Referenced by KX_SoundActuator::Update().

int AUD_setConeAngleOuter	(	AUD_Channel *	handle,
		float	angle
	)

Sets the outer angle of the cone of a source.

Parameters:

handle	The handle of the source.
angle	The new outer angle of the cone.

Returns:: Whether the action succeeded.

Definition at line 626 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setConeAngleOuter().

Referenced by KX_SoundActuator::Update().

int AUD_setConeVolumeOuter	(	AUD_Channel *	handle,
		float	volume
	)

Sets the outer volume of the cone of a source. The volume between inner and outer angle is interpolated between inner volume and this value.

Parameters:

handle	The handle of the source.
volume	The new outer volume of the cone.

Returns:: Whether the action succeeded.

Definition at line 650 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setConeVolumeOuter().

Referenced by KX_SoundActuator::Update().

int AUD_setDeviceSoundVolume	(	AUD_Device *	device,
		AUD_Channel *	handle,
		float	volume
	)

Sets the volume of a played back sound of a read device.

Parameters:

device	The read device.
handle	The handle to the sound.
volume	The new volume, must be between 0.0 and 1.0.

Returns:: Whether the action succeeded.

Definition at line 735 of file AUD_C-API.cpp.

References assert, and AUD_SoftwareDevice::setVolume().

int AUD_setDeviceVolume	(	AUD_Device *	device,
		float	volume
	)

Sets the main volume of a device.

Parameters:

device	The device.
volume	The new volume, must be between 0.0 and 1.0.

Returns:: Whether the action succeeded.

Definition at line 721 of file AUD_C-API.cpp.

References assert, and AUD_SoftwareDevice::setVolume().

int AUD_setDistanceMaximum	(	AUD_Channel *	handle,
		float	distance
	)

Sets the maximum distance of a source. If a source is further away from the reader than this distance, the volume will automatically be set to 0.

Parameters:

handle	The handle of the source.
distance	The new maximum distance.

Returns:: Whether the action succeeded.

Definition at line 590 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setDistanceMaximum().

Referenced by KX_SoundActuator::Update().

int AUD_setDistanceModel ( AUD_DistanceModel model )

Sets the distance model.

Parameters:

model distance model.

Definition at line 502 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setDistanceModel().

Referenced by StartKetsjiShell().

int AUD_setDistanceReference	(	AUD_Channel *	handle,
		float	distance
	)

Sets the reference distance of a source.

Parameters:

handle	The handle of the source.
distance	The new reference distance.

Returns:: Whether the action succeeded.

Definition at line 602 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setDistanceReference().

Referenced by KX_SoundActuator::Update().

int AUD_setDopplerFactor ( float factor )

Sets the doppler factor. This value is a scaling factor for the velocity vectors of sources and listener which is used while calculating the doppler effect.

Parameters:

factor The new doppler factor.

Definition at line 489 of file AUD_C-API.cpp.

References assert, and AUD_I3DDevice::setDopplerFactor().

Referenced by StartKetsjiShell().