mirror of
https://github.com/ZDoom/zdoom-macos-deps.git
synced 2024-11-25 05:11:49 +00:00
+ FMOD Ex 4.44.61 (64-bit dylib)
http://www.fmod.org lipo libfmodex.dylib -extract x86_64 -output libfmodex_x64.dylib rm libfmodex.dylib mv libfmodex_x64.dylib libfmodex.dylib
This commit is contained in:
parent
73bbb2ac74
commit
09a79e8305
8 changed files with 4434 additions and 0 deletions
2499
fmodex/inc/fmod.h
Normal file
2499
fmodex/inc/fmod.h
Normal file
File diff suppressed because it is too large
Load diff
609
fmodex/inc/fmod.hpp
Normal file
609
fmodex/inc/fmod.hpp
Normal file
|
@ -0,0 +1,609 @@
|
||||||
|
/* ========================================================================================== */
|
||||||
|
/* FMOD Ex - C++ header file. Copyright (c), Firelight Technologies Pty, Ltd. 2004-2016. */
|
||||||
|
/* */
|
||||||
|
/* Use this header in conjunction with fmod.h (which contains all the constants / callbacks) */
|
||||||
|
/* to develop using C++ classes. */
|
||||||
|
/* ========================================================================================== */
|
||||||
|
|
||||||
|
#ifndef _FMOD_HPP
|
||||||
|
#define _FMOD_HPP
|
||||||
|
|
||||||
|
#include "fmod.h"
|
||||||
|
|
||||||
|
/*
|
||||||
|
Constant and defines
|
||||||
|
*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
FMOD Namespace
|
||||||
|
*/
|
||||||
|
namespace FMOD
|
||||||
|
{
|
||||||
|
class System;
|
||||||
|
class Sound;
|
||||||
|
class Channel;
|
||||||
|
class ChannelGroup;
|
||||||
|
class SoundGroup;
|
||||||
|
class Reverb;
|
||||||
|
class DSP;
|
||||||
|
class DSPConnection;
|
||||||
|
class Geometry;
|
||||||
|
|
||||||
|
/*
|
||||||
|
FMOD global system functions (optional).
|
||||||
|
*/
|
||||||
|
inline FMOD_RESULT Memory_Initialize(void *poolmem, int poollen, FMOD_MEMORY_ALLOCCALLBACK useralloc, FMOD_MEMORY_REALLOCCALLBACK userrealloc, FMOD_MEMORY_FREECALLBACK userfree, FMOD_MEMORY_TYPE memtypeflags = FMOD_MEMORY_ALL) { return FMOD_Memory_Initialize(poolmem, poollen, useralloc, userrealloc, userfree, memtypeflags); }
|
||||||
|
inline FMOD_RESULT Memory_GetStats (int *currentalloced, int *maxalloced, bool blocking = true) { return FMOD_Memory_GetStats(currentalloced, maxalloced, blocking); }
|
||||||
|
inline FMOD_RESULT Debug_SetLevel(FMOD_DEBUGLEVEL level) { return FMOD_Debug_SetLevel(level); }
|
||||||
|
inline FMOD_RESULT Debug_GetLevel(FMOD_DEBUGLEVEL *level) { return FMOD_Debug_GetLevel(level); }
|
||||||
|
inline FMOD_RESULT File_SetDiskBusy(int busy) { return FMOD_File_SetDiskBusy(busy); }
|
||||||
|
inline FMOD_RESULT File_GetDiskBusy(int *busy) { return FMOD_File_GetDiskBusy(busy); }
|
||||||
|
|
||||||
|
/*
|
||||||
|
FMOD System factory functions.
|
||||||
|
*/
|
||||||
|
inline FMOD_RESULT System_Create(System **system) { return FMOD_System_Create((FMOD_SYSTEM **)system); }
|
||||||
|
|
||||||
|
/*
|
||||||
|
'System' API
|
||||||
|
*/
|
||||||
|
|
||||||
|
class System
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
System(); /* Constructor made private so user cannot statically instance a System class.
|
||||||
|
System_Create must be used. */
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
|
||||||
|
// Pre-init functions.
|
||||||
|
FMOD_RESULT F_API setOutput (FMOD_OUTPUTTYPE output);
|
||||||
|
FMOD_RESULT F_API getOutput (FMOD_OUTPUTTYPE *output);
|
||||||
|
FMOD_RESULT F_API getNumDrivers (int *numdrivers);
|
||||||
|
FMOD_RESULT F_API getDriverInfo (int id, char *name, int namelen, FMOD_GUID *guid);
|
||||||
|
FMOD_RESULT F_API getDriverInfoW (int id, short *name, int namelen, FMOD_GUID *guid);
|
||||||
|
FMOD_RESULT F_API getDriverCaps (int id, FMOD_CAPS *caps, int *controlpaneloutputrate, FMOD_SPEAKERMODE *controlpanelspeakermode);
|
||||||
|
FMOD_RESULT F_API setDriver (int driver);
|
||||||
|
FMOD_RESULT F_API getDriver (int *driver);
|
||||||
|
FMOD_RESULT F_API setHardwareChannels (int numhardwarechannels);
|
||||||
|
FMOD_RESULT F_API setSoftwareChannels (int numsoftwarechannels);
|
||||||
|
FMOD_RESULT F_API getSoftwareChannels (int *numsoftwarechannels);
|
||||||
|
FMOD_RESULT F_API setSoftwareFormat (int samplerate, FMOD_SOUND_FORMAT format, int numoutputchannels, int maxinputchannels, FMOD_DSP_RESAMPLER resamplemethod);
|
||||||
|
FMOD_RESULT F_API getSoftwareFormat (int *samplerate, FMOD_SOUND_FORMAT *format, int *numoutputchannels, int *maxinputchannels, FMOD_DSP_RESAMPLER *resamplemethod, int *bits);
|
||||||
|
FMOD_RESULT F_API setDSPBufferSize (unsigned int bufferlength, int numbuffers);
|
||||||
|
FMOD_RESULT F_API getDSPBufferSize (unsigned int *bufferlength, int *numbuffers);
|
||||||
|
FMOD_RESULT F_API setFileSystem (FMOD_FILE_OPENCALLBACK useropen, FMOD_FILE_CLOSECALLBACK userclose, FMOD_FILE_READCALLBACK userread, FMOD_FILE_SEEKCALLBACK userseek, FMOD_FILE_ASYNCREADCALLBACK userasyncread, FMOD_FILE_ASYNCCANCELCALLBACK userasynccancel, int blockalign);
|
||||||
|
FMOD_RESULT F_API attachFileSystem (FMOD_FILE_OPENCALLBACK useropen, FMOD_FILE_CLOSECALLBACK userclose, FMOD_FILE_READCALLBACK userread, FMOD_FILE_SEEKCALLBACK userseek);
|
||||||
|
FMOD_RESULT F_API setAdvancedSettings (FMOD_ADVANCEDSETTINGS *settings);
|
||||||
|
FMOD_RESULT F_API getAdvancedSettings (FMOD_ADVANCEDSETTINGS *settings);
|
||||||
|
FMOD_RESULT F_API setSpeakerMode (FMOD_SPEAKERMODE speakermode);
|
||||||
|
FMOD_RESULT F_API getSpeakerMode (FMOD_SPEAKERMODE *speakermode);
|
||||||
|
FMOD_RESULT F_API setCallback (FMOD_SYSTEM_CALLBACK callback);
|
||||||
|
|
||||||
|
// Plug-in support
|
||||||
|
FMOD_RESULT F_API setPluginPath (const char *path);
|
||||||
|
FMOD_RESULT F_API loadPlugin (const char *filename, unsigned int *handle, unsigned int priority = 0);
|
||||||
|
FMOD_RESULT F_API unloadPlugin (unsigned int handle);
|
||||||
|
FMOD_RESULT F_API getNumPlugins (FMOD_PLUGINTYPE plugintype, int *numplugins);
|
||||||
|
FMOD_RESULT F_API getPluginHandle (FMOD_PLUGINTYPE plugintype, int index, unsigned int *handle);
|
||||||
|
FMOD_RESULT F_API getPluginInfo (unsigned int handle, FMOD_PLUGINTYPE *plugintype, char *name, int namelen, unsigned int *version);
|
||||||
|
FMOD_RESULT F_API setOutputByPlugin (unsigned int handle);
|
||||||
|
FMOD_RESULT F_API getOutputByPlugin (unsigned int *handle);
|
||||||
|
FMOD_RESULT F_API createDSPByPlugin (unsigned int handle, DSP **dsp);
|
||||||
|
FMOD_RESULT F_API registerCodec (FMOD_CODEC_DESCRIPTION *description, unsigned int *handle, unsigned int priority = 0);
|
||||||
|
FMOD_RESULT F_API registerDSP (FMOD_DSP_DESCRIPTION *description, unsigned int *handle);
|
||||||
|
|
||||||
|
// Init/Close
|
||||||
|
FMOD_RESULT F_API init (int maxchannels, FMOD_INITFLAGS flags, void *extradriverdata);
|
||||||
|
FMOD_RESULT F_API close ();
|
||||||
|
|
||||||
|
// General post-init system functions
|
||||||
|
FMOD_RESULT F_API update (); /* IMPORTANT! CALL THIS ONCE PER FRAME! */
|
||||||
|
|
||||||
|
FMOD_RESULT F_API set3DSettings (float dopplerscale, float distancefactor, float rolloffscale);
|
||||||
|
FMOD_RESULT F_API get3DSettings (float *dopplerscale, float *distancefactor, float *rolloffscale);
|
||||||
|
FMOD_RESULT F_API set3DNumListeners (int numlisteners);
|
||||||
|
FMOD_RESULT F_API get3DNumListeners (int *numlisteners);
|
||||||
|
FMOD_RESULT F_API set3DListenerAttributes(int listener, const FMOD_VECTOR *pos, const FMOD_VECTOR *vel, const FMOD_VECTOR *forward, const FMOD_VECTOR *up);
|
||||||
|
FMOD_RESULT F_API get3DListenerAttributes(int listener, FMOD_VECTOR *pos, FMOD_VECTOR *vel, FMOD_VECTOR *forward, FMOD_VECTOR *up);
|
||||||
|
FMOD_RESULT F_API set3DRolloffCallback (FMOD_3D_ROLLOFFCALLBACK callback);
|
||||||
|
FMOD_RESULT F_API set3DSpeakerPosition (FMOD_SPEAKER speaker, float x, float y, bool active);
|
||||||
|
FMOD_RESULT F_API get3DSpeakerPosition (FMOD_SPEAKER speaker, float *x, float *y, bool *active);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API setStreamBufferSize (unsigned int filebuffersize, FMOD_TIMEUNIT filebuffersizetype);
|
||||||
|
FMOD_RESULT F_API getStreamBufferSize (unsigned int *filebuffersize, FMOD_TIMEUNIT *filebuffersizetype);
|
||||||
|
|
||||||
|
// System information functions.
|
||||||
|
FMOD_RESULT F_API getVersion (unsigned int *version);
|
||||||
|
FMOD_RESULT F_API getOutputHandle (void **handle);
|
||||||
|
FMOD_RESULT F_API getChannelsPlaying (int *channels);
|
||||||
|
FMOD_RESULT F_API getHardwareChannels (int *numhardwarechannels);
|
||||||
|
FMOD_RESULT F_API getCPUUsage (float *dsp, float *stream, float *geometry, float *update, float *total);
|
||||||
|
FMOD_RESULT F_API getSoundRAM (int *currentalloced, int *maxalloced, int *total);
|
||||||
|
FMOD_RESULT F_API getNumCDROMDrives (int *numdrives);
|
||||||
|
FMOD_RESULT F_API getCDROMDriveName (int drive, char *drivename, int drivenamelen, char *scsiname, int scsinamelen, char *devicename, int devicenamelen);
|
||||||
|
FMOD_RESULT F_API getSpectrum (float *spectrumarray, int numvalues, int channeloffset, FMOD_DSP_FFT_WINDOW windowtype);
|
||||||
|
FMOD_RESULT F_API getWaveData (float *wavearray, int numvalues, int channeloffset);
|
||||||
|
|
||||||
|
// Sound/DSP/Channel/FX creation and retrieval.
|
||||||
|
FMOD_RESULT F_API createSound (const char *name_or_data, FMOD_MODE mode, FMOD_CREATESOUNDEXINFO *exinfo, Sound **sound);
|
||||||
|
FMOD_RESULT F_API createStream (const char *name_or_data, FMOD_MODE mode, FMOD_CREATESOUNDEXINFO *exinfo, Sound **sound);
|
||||||
|
FMOD_RESULT F_API createDSP (FMOD_DSP_DESCRIPTION *description, DSP **dsp);
|
||||||
|
FMOD_RESULT F_API createDSPByType (FMOD_DSP_TYPE type, DSP **dsp);
|
||||||
|
FMOD_RESULT F_API createChannelGroup (const char *name, ChannelGroup **channelgroup);
|
||||||
|
FMOD_RESULT F_API createSoundGroup (const char *name, SoundGroup **soundgroup);
|
||||||
|
FMOD_RESULT F_API createReverb (Reverb **reverb);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API playSound (FMOD_CHANNELINDEX channelid, Sound *sound, bool paused, Channel **channel);
|
||||||
|
FMOD_RESULT F_API playDSP (FMOD_CHANNELINDEX channelid, DSP *dsp, bool paused, Channel **channel);
|
||||||
|
FMOD_RESULT F_API getChannel (int channelid, Channel **channel);
|
||||||
|
FMOD_RESULT F_API getMasterChannelGroup (ChannelGroup **channelgroup);
|
||||||
|
FMOD_RESULT F_API getMasterSoundGroup (SoundGroup **soundgroup);
|
||||||
|
|
||||||
|
// Reverb API
|
||||||
|
FMOD_RESULT F_API setReverbProperties (const FMOD_REVERB_PROPERTIES *prop);
|
||||||
|
FMOD_RESULT F_API getReverbProperties (FMOD_REVERB_PROPERTIES *prop);
|
||||||
|
FMOD_RESULT F_API setReverbAmbientProperties(FMOD_REVERB_PROPERTIES *prop);
|
||||||
|
FMOD_RESULT F_API getReverbAmbientProperties(FMOD_REVERB_PROPERTIES *prop);
|
||||||
|
|
||||||
|
// System level DSP access.
|
||||||
|
FMOD_RESULT F_API getDSPHead (DSP **dsp);
|
||||||
|
FMOD_RESULT F_API addDSP (DSP *dsp, DSPConnection **connection);
|
||||||
|
FMOD_RESULT F_API lockDSP ();
|
||||||
|
FMOD_RESULT F_API unlockDSP ();
|
||||||
|
FMOD_RESULT F_API getDSPClock (unsigned int *hi, unsigned int *lo);
|
||||||
|
|
||||||
|
// Recording API.
|
||||||
|
FMOD_RESULT F_API getRecordNumDrivers (int *numdrivers);
|
||||||
|
FMOD_RESULT F_API getRecordDriverInfo (int id, char *name, int namelen, FMOD_GUID *guid);
|
||||||
|
FMOD_RESULT F_API getRecordDriverInfoW (int id, short *name, int namelen, FMOD_GUID *guid);
|
||||||
|
FMOD_RESULT F_API getRecordDriverCaps (int id, FMOD_CAPS *caps, int *minfrequency, int *maxfrequency);
|
||||||
|
FMOD_RESULT F_API getRecordPosition (int id, unsigned int *position);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API recordStart (int id, Sound *sound, bool loop);
|
||||||
|
FMOD_RESULT F_API recordStop (int id);
|
||||||
|
FMOD_RESULT F_API isRecording (int id, bool *recording);
|
||||||
|
|
||||||
|
// Geometry API.
|
||||||
|
FMOD_RESULT F_API createGeometry (int maxpolygons, int maxvertices, Geometry **geometry);
|
||||||
|
FMOD_RESULT F_API setGeometrySettings (float maxworldsize);
|
||||||
|
FMOD_RESULT F_API getGeometrySettings (float *maxworldsize);
|
||||||
|
FMOD_RESULT F_API loadGeometry (const void *data, int datasize, Geometry **geometry);
|
||||||
|
FMOD_RESULT F_API getGeometryOcclusion (const FMOD_VECTOR *listener, const FMOD_VECTOR *source, float *direct, float *reverb);
|
||||||
|
|
||||||
|
// Network functions.
|
||||||
|
FMOD_RESULT F_API setNetworkProxy (const char *proxy);
|
||||||
|
FMOD_RESULT F_API getNetworkProxy (char *proxy, int proxylen);
|
||||||
|
FMOD_RESULT F_API setNetworkTimeout (int timeout);
|
||||||
|
FMOD_RESULT F_API getNetworkTimeout (int *timeout);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
'Sound' API
|
||||||
|
*/
|
||||||
|
class Sound
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
Sound(); /* Constructor made private so user cannot statically instance a Sound class.
|
||||||
|
Appropriate Sound creation or retrieval function must be used. */
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
FMOD_RESULT F_API getSystemObject (System **system);
|
||||||
|
|
||||||
|
// Standard sound manipulation functions.
|
||||||
|
FMOD_RESULT F_API lock (unsigned int offset, unsigned int length, void **ptr1, void **ptr2, unsigned int *len1, unsigned int *len2);
|
||||||
|
FMOD_RESULT F_API unlock (void *ptr1, void *ptr2, unsigned int len1, unsigned int len2);
|
||||||
|
FMOD_RESULT F_API setDefaults (float frequency, float volume, float pan, int priority);
|
||||||
|
FMOD_RESULT F_API getDefaults (float *frequency, float *volume, float *pan, int *priority);
|
||||||
|
FMOD_RESULT F_API setVariations (float frequencyvar, float volumevar, float panvar);
|
||||||
|
FMOD_RESULT F_API getVariations (float *frequencyvar, float *volumevar, float *panvar);
|
||||||
|
FMOD_RESULT F_API set3DMinMaxDistance (float min, float max);
|
||||||
|
FMOD_RESULT F_API get3DMinMaxDistance (float *min, float *max);
|
||||||
|
FMOD_RESULT F_API set3DConeSettings (float insideconeangle, float outsideconeangle, float outsidevolume);
|
||||||
|
FMOD_RESULT F_API get3DConeSettings (float *insideconeangle, float *outsideconeangle, float *outsidevolume);
|
||||||
|
FMOD_RESULT F_API set3DCustomRolloff (FMOD_VECTOR *points, int numpoints);
|
||||||
|
FMOD_RESULT F_API get3DCustomRolloff (FMOD_VECTOR **points, int *numpoints);
|
||||||
|
FMOD_RESULT F_API setSubSound (int index, Sound *subsound);
|
||||||
|
FMOD_RESULT F_API getSubSound (int index, Sound **subsound);
|
||||||
|
FMOD_RESULT F_API getSubSoundParent (Sound **parentsound);
|
||||||
|
FMOD_RESULT F_API setSubSoundSentence (int *subsoundlist, int numsubsounds);
|
||||||
|
FMOD_RESULT F_API getName (char *name, int namelen);
|
||||||
|
FMOD_RESULT F_API getLength (unsigned int *length, FMOD_TIMEUNIT lengthtype);
|
||||||
|
FMOD_RESULT F_API getFormat (FMOD_SOUND_TYPE *type, FMOD_SOUND_FORMAT *format, int *channels, int *bits);
|
||||||
|
FMOD_RESULT F_API getNumSubSounds (int *numsubsounds);
|
||||||
|
FMOD_RESULT F_API getNumTags (int *numtags, int *numtagsupdated);
|
||||||
|
FMOD_RESULT F_API getTag (const char *name, int index, FMOD_TAG *tag);
|
||||||
|
FMOD_RESULT F_API getOpenState (FMOD_OPENSTATE *openstate, unsigned int *percentbuffered, bool *starving, bool *diskbusy);
|
||||||
|
FMOD_RESULT F_API readData (void *buffer, unsigned int lenbytes, unsigned int *read);
|
||||||
|
FMOD_RESULT F_API seekData (unsigned int pcm);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API setSoundGroup (SoundGroup *soundgroup);
|
||||||
|
FMOD_RESULT F_API getSoundGroup (SoundGroup **soundgroup);
|
||||||
|
|
||||||
|
// Synchronization point API. These points can come from markers embedded in wav files, and can also generate channel callbacks.
|
||||||
|
FMOD_RESULT F_API getNumSyncPoints (int *numsyncpoints);
|
||||||
|
FMOD_RESULT F_API getSyncPoint (int index, FMOD_SYNCPOINT **point);
|
||||||
|
FMOD_RESULT F_API getSyncPointInfo (FMOD_SYNCPOINT *point, char *name, int namelen, unsigned int *offset, FMOD_TIMEUNIT offsettype);
|
||||||
|
FMOD_RESULT F_API addSyncPoint (unsigned int offset, FMOD_TIMEUNIT offsettype, const char *name, FMOD_SYNCPOINT **point);
|
||||||
|
FMOD_RESULT F_API deleteSyncPoint (FMOD_SYNCPOINT *point);
|
||||||
|
|
||||||
|
// Functions also in Channel class but here they are the 'default' to save having to change it in Channel all the time.
|
||||||
|
FMOD_RESULT F_API setMode (FMOD_MODE mode);
|
||||||
|
FMOD_RESULT F_API getMode (FMOD_MODE *mode);
|
||||||
|
FMOD_RESULT F_API setLoopCount (int loopcount);
|
||||||
|
FMOD_RESULT F_API getLoopCount (int *loopcount);
|
||||||
|
FMOD_RESULT F_API setLoopPoints (unsigned int loopstart, FMOD_TIMEUNIT loopstarttype, unsigned int loopend, FMOD_TIMEUNIT loopendtype);
|
||||||
|
FMOD_RESULT F_API getLoopPoints (unsigned int *loopstart, FMOD_TIMEUNIT loopstarttype, unsigned int *loopend, FMOD_TIMEUNIT loopendtype);
|
||||||
|
|
||||||
|
// For MOD/S3M/XM/IT/MID sequenced formats only.
|
||||||
|
FMOD_RESULT F_API getMusicNumChannels (int *numchannels);
|
||||||
|
FMOD_RESULT F_API setMusicChannelVolume (int channel, float volume);
|
||||||
|
FMOD_RESULT F_API getMusicChannelVolume (int channel, float *volume);
|
||||||
|
FMOD_RESULT F_API setMusicSpeed (float speed);
|
||||||
|
FMOD_RESULT F_API getMusicSpeed (float *speed);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
'Channel' API.
|
||||||
|
*/
|
||||||
|
class Channel
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
Channel(); /* Constructor made private so user cannot statically instance a Channel class.
|
||||||
|
Appropriate Channel creation or retrieval function must be used. */
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getSystemObject (System **system);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API stop ();
|
||||||
|
FMOD_RESULT F_API setPaused (bool paused);
|
||||||
|
FMOD_RESULT F_API getPaused (bool *paused);
|
||||||
|
FMOD_RESULT F_API setVolume (float volume);
|
||||||
|
FMOD_RESULT F_API getVolume (float *volume);
|
||||||
|
FMOD_RESULT F_API setFrequency (float frequency);
|
||||||
|
FMOD_RESULT F_API getFrequency (float *frequency);
|
||||||
|
FMOD_RESULT F_API setPan (float pan);
|
||||||
|
FMOD_RESULT F_API getPan (float *pan);
|
||||||
|
FMOD_RESULT F_API setDelay (FMOD_DELAYTYPE delaytype, unsigned int delayhi, unsigned int delaylo);
|
||||||
|
FMOD_RESULT F_API getDelay (FMOD_DELAYTYPE delaytype, unsigned int *delayhi, unsigned int *delaylo);
|
||||||
|
FMOD_RESULT F_API setSpeakerMix (float frontleft, float frontright, float center, float lfe, float backleft, float backright, float sideleft, float sideright);
|
||||||
|
FMOD_RESULT F_API getSpeakerMix (float *frontleft, float *frontright, float *center, float *lfe, float *backleft, float *backright, float *sideleft, float *sideright);
|
||||||
|
FMOD_RESULT F_API setSpeakerLevels (FMOD_SPEAKER speaker, float *levels, int numlevels);
|
||||||
|
FMOD_RESULT F_API getSpeakerLevels (FMOD_SPEAKER speaker, float *levels, int numlevels);
|
||||||
|
FMOD_RESULT F_API setInputChannelMix (float *levels, int numlevels);
|
||||||
|
FMOD_RESULT F_API getInputChannelMix (float *levels, int numlevels);
|
||||||
|
FMOD_RESULT F_API setMute (bool mute);
|
||||||
|
FMOD_RESULT F_API getMute (bool *mute);
|
||||||
|
FMOD_RESULT F_API setPriority (int priority);
|
||||||
|
FMOD_RESULT F_API getPriority (int *priority);
|
||||||
|
FMOD_RESULT F_API setPosition (unsigned int position, FMOD_TIMEUNIT postype);
|
||||||
|
FMOD_RESULT F_API getPosition (unsigned int *position, FMOD_TIMEUNIT postype);
|
||||||
|
FMOD_RESULT F_API setReverbProperties (const FMOD_REVERB_CHANNELPROPERTIES *prop);
|
||||||
|
FMOD_RESULT F_API getReverbProperties (FMOD_REVERB_CHANNELPROPERTIES *prop);
|
||||||
|
FMOD_RESULT F_API setLowPassGain (float gain);
|
||||||
|
FMOD_RESULT F_API getLowPassGain (float *gain);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API setChannelGroup (ChannelGroup *channelgroup);
|
||||||
|
FMOD_RESULT F_API getChannelGroup (ChannelGroup **channelgroup);
|
||||||
|
FMOD_RESULT F_API setCallback (FMOD_CHANNEL_CALLBACK callback);
|
||||||
|
|
||||||
|
// 3D functionality.
|
||||||
|
FMOD_RESULT F_API set3DAttributes (const FMOD_VECTOR *pos, const FMOD_VECTOR *vel);
|
||||||
|
FMOD_RESULT F_API get3DAttributes (FMOD_VECTOR *pos, FMOD_VECTOR *vel);
|
||||||
|
FMOD_RESULT F_API set3DMinMaxDistance (float mindistance, float maxdistance);
|
||||||
|
FMOD_RESULT F_API get3DMinMaxDistance (float *mindistance, float *maxdistance);
|
||||||
|
FMOD_RESULT F_API set3DConeSettings (float insideconeangle, float outsideconeangle, float outsidevolume);
|
||||||
|
FMOD_RESULT F_API get3DConeSettings (float *insideconeangle, float *outsideconeangle, float *outsidevolume);
|
||||||
|
FMOD_RESULT F_API set3DConeOrientation (FMOD_VECTOR *orientation);
|
||||||
|
FMOD_RESULT F_API get3DConeOrientation (FMOD_VECTOR *orientation);
|
||||||
|
FMOD_RESULT F_API set3DCustomRolloff (FMOD_VECTOR *points, int numpoints);
|
||||||
|
FMOD_RESULT F_API get3DCustomRolloff (FMOD_VECTOR **points, int *numpoints);
|
||||||
|
FMOD_RESULT F_API set3DOcclusion (float directocclusion, float reverbocclusion);
|
||||||
|
FMOD_RESULT F_API get3DOcclusion (float *directocclusion, float *reverbocclusion);
|
||||||
|
FMOD_RESULT F_API set3DSpread (float angle);
|
||||||
|
FMOD_RESULT F_API get3DSpread (float *angle);
|
||||||
|
FMOD_RESULT F_API set3DPanLevel (float level);
|
||||||
|
FMOD_RESULT F_API get3DPanLevel (float *level);
|
||||||
|
FMOD_RESULT F_API set3DDopplerLevel (float level);
|
||||||
|
FMOD_RESULT F_API get3DDopplerLevel (float *level);
|
||||||
|
FMOD_RESULT F_API set3DDistanceFilter (bool custom, float customLevel, float centerFreq);
|
||||||
|
FMOD_RESULT F_API get3DDistanceFilter (bool *custom, float *customLevel, float *centerFreq);
|
||||||
|
|
||||||
|
// DSP functionality only for channels playing sounds created with FMOD_SOFTWARE.
|
||||||
|
FMOD_RESULT F_API getDSPHead (DSP **dsp);
|
||||||
|
FMOD_RESULT F_API addDSP (DSP *dsp, DSPConnection **connection);
|
||||||
|
|
||||||
|
// Information only functions.
|
||||||
|
FMOD_RESULT F_API isPlaying (bool *isplaying);
|
||||||
|
FMOD_RESULT F_API isVirtual (bool *isvirtual);
|
||||||
|
FMOD_RESULT F_API getAudibility (float *audibility);
|
||||||
|
FMOD_RESULT F_API getCurrentSound (Sound **sound);
|
||||||
|
FMOD_RESULT F_API getSpectrum (float *spectrumarray, int numvalues, int channeloffset, FMOD_DSP_FFT_WINDOW windowtype);
|
||||||
|
FMOD_RESULT F_API getWaveData (float *wavearray, int numvalues, int channeloffset);
|
||||||
|
FMOD_RESULT F_API getIndex (int *index);
|
||||||
|
|
||||||
|
// Functions also found in Sound class but here they can be set per channel.
|
||||||
|
FMOD_RESULT F_API setMode (FMOD_MODE mode);
|
||||||
|
FMOD_RESULT F_API getMode (FMOD_MODE *mode);
|
||||||
|
FMOD_RESULT F_API setLoopCount (int loopcount);
|
||||||
|
FMOD_RESULT F_API getLoopCount (int *loopcount);
|
||||||
|
FMOD_RESULT F_API setLoopPoints (unsigned int loopstart, FMOD_TIMEUNIT loopstarttype, unsigned int loopend, FMOD_TIMEUNIT loopendtype);
|
||||||
|
FMOD_RESULT F_API getLoopPoints (unsigned int *loopstart, FMOD_TIMEUNIT loopstarttype, unsigned int *loopend, FMOD_TIMEUNIT loopendtype);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
'ChannelGroup' API
|
||||||
|
*/
|
||||||
|
class ChannelGroup
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
ChannelGroup(); /* Constructor made private so user cannot statically instance a ChannelGroup class.
|
||||||
|
Appropriate ChannelGroup creation or retrieval function must be used. */
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
FMOD_RESULT F_API getSystemObject (System **system);
|
||||||
|
|
||||||
|
// Channelgroup scale values. (changes attributes relative to the channels, doesn't overwrite them)
|
||||||
|
FMOD_RESULT F_API setVolume (float volume);
|
||||||
|
FMOD_RESULT F_API getVolume (float *volume);
|
||||||
|
FMOD_RESULT F_API setPitch (float pitch);
|
||||||
|
FMOD_RESULT F_API getPitch (float *pitch);
|
||||||
|
FMOD_RESULT F_API set3DOcclusion (float directocclusion, float reverbocclusion);
|
||||||
|
FMOD_RESULT F_API get3DOcclusion (float *directocclusion, float *reverbocclusion);
|
||||||
|
FMOD_RESULT F_API setPaused (bool paused);
|
||||||
|
FMOD_RESULT F_API getPaused (bool *paused);
|
||||||
|
FMOD_RESULT F_API setMute (bool mute);
|
||||||
|
FMOD_RESULT F_API getMute (bool *mute);
|
||||||
|
|
||||||
|
// Channelgroup override values. (recursively overwrites whatever settings the channels had)
|
||||||
|
FMOD_RESULT F_API stop ();
|
||||||
|
FMOD_RESULT F_API overrideVolume (float volume);
|
||||||
|
FMOD_RESULT F_API overrideFrequency (float frequency);
|
||||||
|
FMOD_RESULT F_API overridePan (float pan);
|
||||||
|
FMOD_RESULT F_API overrideReverbProperties(const FMOD_REVERB_CHANNELPROPERTIES *prop);
|
||||||
|
FMOD_RESULT F_API override3DAttributes (const FMOD_VECTOR *pos, const FMOD_VECTOR *vel);
|
||||||
|
FMOD_RESULT F_API overrideSpeakerMix (float frontleft, float frontright, float center, float lfe, float backleft, float backright, float sideleft, float sideright);
|
||||||
|
|
||||||
|
// Nested channel groups.
|
||||||
|
FMOD_RESULT F_API addGroup (ChannelGroup *group);
|
||||||
|
FMOD_RESULT F_API getNumGroups (int *numgroups);
|
||||||
|
FMOD_RESULT F_API getGroup (int index, ChannelGroup **group);
|
||||||
|
FMOD_RESULT F_API getParentGroup (ChannelGroup **group);
|
||||||
|
|
||||||
|
// DSP functionality only for channel groups playing sounds created with FMOD_SOFTWARE.
|
||||||
|
FMOD_RESULT F_API getDSPHead (DSP **dsp);
|
||||||
|
FMOD_RESULT F_API addDSP (DSP *dsp, DSPConnection **connection);
|
||||||
|
|
||||||
|
// Information only functions.
|
||||||
|
FMOD_RESULT F_API getName (char *name, int namelen);
|
||||||
|
FMOD_RESULT F_API getNumChannels (int *numchannels);
|
||||||
|
FMOD_RESULT F_API getChannel (int index, Channel **channel);
|
||||||
|
FMOD_RESULT F_API getSpectrum (float *spectrumarray, int numvalues, int channeloffset, FMOD_DSP_FFT_WINDOW windowtype);
|
||||||
|
FMOD_RESULT F_API getWaveData (float *wavearray, int numvalues, int channeloffset);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
'SoundGroup' API
|
||||||
|
*/
|
||||||
|
class SoundGroup
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
SoundGroup(); /* Constructor made private so user cannot statically instance a SoundGroup class.
|
||||||
|
Appropriate SoundGroup creation or retrieval function must be used. */
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
FMOD_RESULT F_API getSystemObject (System **system);
|
||||||
|
|
||||||
|
// SoundGroup control functions.
|
||||||
|
FMOD_RESULT F_API setMaxAudible (int maxaudible);
|
||||||
|
FMOD_RESULT F_API getMaxAudible (int *maxaudible);
|
||||||
|
FMOD_RESULT F_API setMaxAudibleBehavior (FMOD_SOUNDGROUP_BEHAVIOR behavior);
|
||||||
|
FMOD_RESULT F_API getMaxAudibleBehavior (FMOD_SOUNDGROUP_BEHAVIOR *behavior);
|
||||||
|
FMOD_RESULT F_API setMuteFadeSpeed (float speed);
|
||||||
|
FMOD_RESULT F_API getMuteFadeSpeed (float *speed);
|
||||||
|
FMOD_RESULT F_API setVolume (float volume);
|
||||||
|
FMOD_RESULT F_API getVolume (float *volume);
|
||||||
|
FMOD_RESULT F_API stop ();
|
||||||
|
|
||||||
|
// Information only functions.
|
||||||
|
FMOD_RESULT F_API getName (char *name, int namelen);
|
||||||
|
FMOD_RESULT F_API getNumSounds (int *numsounds);
|
||||||
|
FMOD_RESULT F_API getSound (int index, Sound **sound);
|
||||||
|
FMOD_RESULT F_API getNumPlaying (int *numplaying);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
'DSP' API
|
||||||
|
*/
|
||||||
|
class DSP
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
DSP(); /* Constructor made private so user cannot statically instance a DSP class.
|
||||||
|
Appropriate DSP creation or retrieval function must be used. */
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
FMOD_RESULT F_API getSystemObject (System **system);
|
||||||
|
|
||||||
|
// Connection / disconnection / input and output enumeration.
|
||||||
|
FMOD_RESULT F_API addInput (DSP *target, DSPConnection **connection);
|
||||||
|
FMOD_RESULT F_API disconnectFrom (DSP *target);
|
||||||
|
FMOD_RESULT F_API disconnectAll (bool inputs, bool outputs);
|
||||||
|
FMOD_RESULT F_API remove ();
|
||||||
|
FMOD_RESULT F_API getNumInputs (int *numinputs);
|
||||||
|
FMOD_RESULT F_API getNumOutputs (int *numoutputs);
|
||||||
|
FMOD_RESULT F_API getInput (int index, DSP **input, DSPConnection **inputconnection);
|
||||||
|
FMOD_RESULT F_API getOutput (int index, DSP **output, DSPConnection **outputconnection);
|
||||||
|
|
||||||
|
// DSP unit control.
|
||||||
|
FMOD_RESULT F_API setActive (bool active);
|
||||||
|
FMOD_RESULT F_API getActive (bool *active);
|
||||||
|
FMOD_RESULT F_API setBypass (bool bypass);
|
||||||
|
FMOD_RESULT F_API getBypass (bool *bypass);
|
||||||
|
FMOD_RESULT F_API setSpeakerActive (FMOD_SPEAKER speaker, bool active);
|
||||||
|
FMOD_RESULT F_API getSpeakerActive (FMOD_SPEAKER speaker, bool *active);
|
||||||
|
FMOD_RESULT F_API reset ();
|
||||||
|
|
||||||
|
|
||||||
|
// DSP parameter control.
|
||||||
|
FMOD_RESULT F_API setParameter (int index, float value);
|
||||||
|
FMOD_RESULT F_API getParameter (int index, float *value, char *valuestr, int valuestrlen);
|
||||||
|
FMOD_RESULT F_API getNumParameters (int *numparams);
|
||||||
|
FMOD_RESULT F_API getParameterInfo (int index, char *name, char *label, char *description, int descriptionlen, float *min, float *max);
|
||||||
|
FMOD_RESULT F_API showConfigDialog (void *hwnd, bool show);
|
||||||
|
|
||||||
|
// DSP attributes.
|
||||||
|
FMOD_RESULT F_API getInfo (char *name, unsigned int *version, int *channels, int *configwidth, int *configheight);
|
||||||
|
FMOD_RESULT F_API getType (FMOD_DSP_TYPE *type);
|
||||||
|
FMOD_RESULT F_API setDefaults (float frequency, float volume, float pan, int priority);
|
||||||
|
FMOD_RESULT F_API getDefaults (float *frequency, float *volume, float *pan, int *priority);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
'DSPConnection' API
|
||||||
|
*/
|
||||||
|
class DSPConnection
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
DSPConnection(); /* Constructor made private so user cannot statically instance a DSPConnection class.
|
||||||
|
Appropriate DSPConnection creation or retrieval function must be used. */
|
||||||
|
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getInput (DSP **input);
|
||||||
|
FMOD_RESULT F_API getOutput (DSP **output);
|
||||||
|
FMOD_RESULT F_API setMix (float volume);
|
||||||
|
FMOD_RESULT F_API getMix (float *volume);
|
||||||
|
FMOD_RESULT F_API setLevels (FMOD_SPEAKER speaker, float *levels, int numlevels);
|
||||||
|
FMOD_RESULT F_API getLevels (FMOD_SPEAKER speaker, float *levels, int numlevels);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
'Geometry' API
|
||||||
|
*/
|
||||||
|
class Geometry
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
Geometry(); /* Constructor made private so user cannot statically instance a Geometry class.
|
||||||
|
Appropriate Geometry creation or retrieval function must be used. */
|
||||||
|
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
|
||||||
|
// Polygon manipulation.
|
||||||
|
FMOD_RESULT F_API addPolygon (float directocclusion, float reverbocclusion, bool doublesided, int numvertices, const FMOD_VECTOR *vertices, int *polygonindex);
|
||||||
|
FMOD_RESULT F_API getNumPolygons (int *numpolygons);
|
||||||
|
FMOD_RESULT F_API getMaxPolygons (int *maxpolygons, int *maxvertices);
|
||||||
|
FMOD_RESULT F_API getPolygonNumVertices (int index, int *numvertices);
|
||||||
|
FMOD_RESULT F_API setPolygonVertex (int index, int vertexindex, const FMOD_VECTOR *vertex);
|
||||||
|
FMOD_RESULT F_API getPolygonVertex (int index, int vertexindex, FMOD_VECTOR *vertex);
|
||||||
|
FMOD_RESULT F_API setPolygonAttributes (int index, float directocclusion, float reverbocclusion, bool doublesided);
|
||||||
|
FMOD_RESULT F_API getPolygonAttributes (int index, float *directocclusion, float *reverbocclusion, bool *doublesided);
|
||||||
|
|
||||||
|
// Object manipulation.
|
||||||
|
FMOD_RESULT F_API setActive (bool active);
|
||||||
|
FMOD_RESULT F_API getActive (bool *active);
|
||||||
|
FMOD_RESULT F_API setRotation (const FMOD_VECTOR *forward, const FMOD_VECTOR *up);
|
||||||
|
FMOD_RESULT F_API getRotation (FMOD_VECTOR *forward, FMOD_VECTOR *up);
|
||||||
|
FMOD_RESULT F_API setPosition (const FMOD_VECTOR *position);
|
||||||
|
FMOD_RESULT F_API getPosition (FMOD_VECTOR *position);
|
||||||
|
FMOD_RESULT F_API setScale (const FMOD_VECTOR *scale);
|
||||||
|
FMOD_RESULT F_API getScale (FMOD_VECTOR *scale);
|
||||||
|
FMOD_RESULT F_API save (void *data, int *datasize);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
'Reverb' API
|
||||||
|
*/
|
||||||
|
class Reverb
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
|
||||||
|
Reverb(); /* Constructor made private so user cannot statically instance a Reverb class.
|
||||||
|
Appropriate Reverb creation or retrieval function must be used. */
|
||||||
|
|
||||||
|
public:
|
||||||
|
|
||||||
|
FMOD_RESULT F_API release ();
|
||||||
|
|
||||||
|
// Reverb manipulation.
|
||||||
|
FMOD_RESULT F_API set3DAttributes (const FMOD_VECTOR *position, float mindistance, float maxdistance);
|
||||||
|
FMOD_RESULT F_API get3DAttributes (FMOD_VECTOR *position, float *mindistance,float *maxdistance);
|
||||||
|
FMOD_RESULT F_API setProperties (const FMOD_REVERB_PROPERTIES *properties);
|
||||||
|
FMOD_RESULT F_API getProperties (FMOD_REVERB_PROPERTIES *properties);
|
||||||
|
FMOD_RESULT F_API setActive (bool active);
|
||||||
|
FMOD_RESULT F_API getActive (bool *active);
|
||||||
|
|
||||||
|
// Userdata set/get.
|
||||||
|
FMOD_RESULT F_API setUserData (void *userdata);
|
||||||
|
FMOD_RESULT F_API getUserData (void **userdata);
|
||||||
|
|
||||||
|
FMOD_RESULT F_API getMemoryInfo (unsigned int memorybits, unsigned int event_memorybits, unsigned int *memoryused, FMOD_MEMORY_USAGE_DETAILS *memoryused_details);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
159
fmodex/inc/fmod_codec.h
Normal file
159
fmodex/inc/fmod_codec.h
Normal file
|
@ -0,0 +1,159 @@
|
||||||
|
/* ==================================================================================================== */
|
||||||
|
/* FMOD Ex - codec development header file. Copyright (c), Firelight Technologies Pty, Ltd. 2004-2016. */
|
||||||
|
/* */
|
||||||
|
/* Use this header if you are wanting to develop your own file format plugin to use with */
|
||||||
|
/* FMOD's codec system. With this header you can make your own fileformat plugin that FMOD */
|
||||||
|
/* can register and use. See the documentation and examples on how to make a working plugin. */
|
||||||
|
/* */
|
||||||
|
/* ==================================================================================================== */
|
||||||
|
|
||||||
|
#ifndef _FMOD_CODEC_H
|
||||||
|
#define _FMOD_CODEC_H
|
||||||
|
|
||||||
|
typedef struct FMOD_CODEC_STATE FMOD_CODEC_STATE;
|
||||||
|
typedef struct FMOD_CODEC_WAVEFORMAT FMOD_CODEC_WAVEFORMAT;
|
||||||
|
|
||||||
|
/*
|
||||||
|
Codec callbacks
|
||||||
|
*/
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_OPENCALLBACK) (FMOD_CODEC_STATE *codec_state, FMOD_MODE usermode, FMOD_CREATESOUNDEXINFO *userexinfo);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_CLOSECALLBACK) (FMOD_CODEC_STATE *codec_state);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_READCALLBACK) (FMOD_CODEC_STATE *codec_state, void *buffer, unsigned int sizebytes, unsigned int *bytesread);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_GETLENGTHCALLBACK) (FMOD_CODEC_STATE *codec_state, unsigned int *length, FMOD_TIMEUNIT lengthtype);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_SETPOSITIONCALLBACK) (FMOD_CODEC_STATE *codec_state, int subsound, unsigned int position, FMOD_TIMEUNIT postype);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_GETPOSITIONCALLBACK) (FMOD_CODEC_STATE *codec_state, unsigned int *position, FMOD_TIMEUNIT postype);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_SOUNDCREATECALLBACK) (FMOD_CODEC_STATE *codec_state, int subsound, FMOD_SOUND *sound);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_METADATACALLBACK) (FMOD_CODEC_STATE *codec_state, FMOD_TAGTYPE tagtype, char *name, void *data, unsigned int datalen, FMOD_TAGDATATYPE datatype, int unique);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_CODEC_GETWAVEFORMAT) (FMOD_CODEC_STATE *codec_state, int index, FMOD_CODEC_WAVEFORMAT *waveformat);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
When creating a codec, declare one of these and provide the relevant callbacks and name for FMOD to use when it opens and reads a file.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [in] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
Members marked with [out] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_CODEC_STATE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef struct FMOD_CODEC_DESCRIPTION
|
||||||
|
{
|
||||||
|
const char *name; /* [in] Name of the codec. */
|
||||||
|
unsigned int version; /* [in] Plugin writer's version number. */
|
||||||
|
int defaultasstream; /* [in] Tells FMOD to open the file as a stream when calling System::createSound, and not a static sample. Should normally be 0 (FALSE), because generally the user wants to decode the file into memory when using System::createSound. Mainly used for formats that decode for a very long time, or could use large amounts of memory when decoded. Usually sequenced formats such as mod/s3m/xm/it/midi fall into this category. It is mainly to stop users that don't know what they're doing from getting FMOD_ERR_MEMORY returned from createSound when they should have in fact called System::createStream or used FMOD_CREATESTREAM in System::createSound. */
|
||||||
|
FMOD_TIMEUNIT timeunits; /* [in] When setposition codec is called, only these time formats will be passed to the codec. Use bitwise OR to accumulate different types. */
|
||||||
|
FMOD_CODEC_OPENCALLBACK open; /* [in] Open callback for the codec for when FMOD tries to open a sound using this codec. */
|
||||||
|
FMOD_CODEC_CLOSECALLBACK close; /* [in] Close callback for the codec for when FMOD tries to close a sound using this codec. */
|
||||||
|
FMOD_CODEC_READCALLBACK read; /* [in] Read callback for the codec for when FMOD tries to read some data from the file to the destination format (specified in the open callback). */
|
||||||
|
FMOD_CODEC_GETLENGTHCALLBACK getlength; /* [in] Callback to return the length of the song in whatever format required when Sound::getLength is called. */
|
||||||
|
FMOD_CODEC_SETPOSITIONCALLBACK setposition; /* [in] Seek callback for the codec for when FMOD tries to seek within the file with Channel::setPosition. */
|
||||||
|
FMOD_CODEC_GETPOSITIONCALLBACK getposition; /* [in] Tell callback for the codec for when FMOD tries to get the current position within the with Channel::getPosition. */
|
||||||
|
FMOD_CODEC_SOUNDCREATECALLBACK soundcreate; /* [in] Sound creation callback for the codec when FMOD finishes creating the sound. (So the codec can set more parameters for the related created sound, ie loop points/mode or 3D attributes etc). */
|
||||||
|
FMOD_CODEC_GETWAVEFORMAT getwaveformat; /* [in] Callback to tell FMOD about the waveformat of a particular subsound. This is to save memory, rather than saving 1000 FMOD_CODEC_WAVEFORMAT structures in the codec, the codec might have a more optimal way of storing this information. */
|
||||||
|
} FMOD_CODEC_DESCRIPTION;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Set these values marked 'in' to tell fmod what sort of sound to create.<br>
|
||||||
|
The format, channels and frequency tell FMOD what sort of hardware buffer to create when you initialize your code. So if you wrote an MP3 codec that decoded to stereo 16bit integer PCM, you would specify FMOD_SOUND_FORMAT_PCM16, and channels would be equal to 2.<br>
|
||||||
|
Members marked as 'out' are set by fmod. Do not modify these. Simply specify 0 for these values when declaring the structure, FMOD will fill in the values for you after creation with the correct function pointers.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [in] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
Members marked with [out] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
<br>
|
||||||
|
An FMOD file might be from disk, memory or network, however the file may be opened by the user.<br>
|
||||||
|
<br>
|
||||||
|
'numsubsounds' should be 0 if the file is a normal single sound stream or sound. Examples of this would be .WAV, .WMA, .MP3, .AIFF.<br>
|
||||||
|
'numsubsounds' should be 1+ if the file is a container format, and does not contain wav data itself. Examples of these types would be CDDA (multiple CD tracks), FSB (contains multiple sounds), MIDI/MOD/S3M/XM/IT (contain instruments).<br>
|
||||||
|
The arrays of format, channel, frequency, length and blockalign should point to arrays of information based on how many subsounds are in the format. If the number of subsounds is 0 then it should point to 1 of each attribute, the same as if the number of subsounds was 1. If subsounds was 100 for example, each pointer should point to an array of 100 of each attribute.<br>
|
||||||
|
When a sound has 1 or more subsounds, you must play the individual sounds specified by first obtaining the subsound with Sound::getSubSound.
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_SOUND_FORMAT
|
||||||
|
FMOD_FILE_READCALLBACK
|
||||||
|
FMOD_FILE_SEEKCALLBACK
|
||||||
|
FMOD_CODEC_METADATACALLBACK
|
||||||
|
Sound::getSubSound
|
||||||
|
Sound::getNumSubSounds
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
struct FMOD_CODEC_WAVEFORMAT
|
||||||
|
{
|
||||||
|
char name[256]; /* [in] Name of sound.*/
|
||||||
|
FMOD_SOUND_FORMAT format; /* [in] Format for (decompressed) codec output, ie FMOD_SOUND_FORMAT_PCM8, FMOD_SOUND_FORMAT_PCM16.*/
|
||||||
|
int channels; /* [in] Number of channels used by codec, ie mono = 1, stereo = 2. */
|
||||||
|
int frequency; /* [in] Default frequency in hz of the codec, ie 44100. */
|
||||||
|
unsigned int lengthbytes; /* [in] Length in bytes of the source data. */
|
||||||
|
unsigned int lengthpcm; /* [in] Length in decompressed, PCM samples of the file, ie length in seconds * frequency. Used for Sound::getLength and for memory allocation of static decompressed sample data. */
|
||||||
|
int blockalign; /* [in] Blockalign in decompressed, PCM samples of the optimal decode chunk size for this format. The codec read callback will be called in multiples of this value. */
|
||||||
|
int loopstart; /* [in] Loopstart in decompressed, PCM samples of file. */
|
||||||
|
int loopend; /* [in] Loopend in decompressed, PCM samples of file. */
|
||||||
|
FMOD_MODE mode; /* [in] Mode to determine whether the sound should by default load as looping, non looping, 2d or 3d. */
|
||||||
|
unsigned int channelmask; /* [in] Microsoft speaker channel mask, as defined for WAVEFORMATEXTENSIBLE and is found in ksmedia.h. Leave at 0 to play in natural speaker order. */
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Codec plugin structure that is passed into each callback.<br>
|
||||||
|
<br>
|
||||||
|
Set these numsubsounds and waveformat members when called in FMOD_CODEC_OPENCALLBACK to tell fmod what sort of sound to create.<br>
|
||||||
|
<br>
|
||||||
|
The format, channels and frequency tell FMOD what sort of hardware buffer to create when you initialize your code. So if you wrote an MP3 codec that decoded to stereo 16bit integer PCM, you would specify FMOD_SOUND_FORMAT_PCM16, and channels would be equal to 2.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [in] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
Members marked with [out] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
<br>
|
||||||
|
An FMOD file might be from disk, memory or internet, however the file may be opened by the user.<br>
|
||||||
|
<br>
|
||||||
|
'numsubsounds' should be 0 if the file is a normal single sound stream or sound. Examples of this would be .WAV, .WMA, .MP3, .AIFF.<br>
|
||||||
|
'numsubsounds' should be 1+ if the file is a container format, and does not contain wav data itself. Examples of these types would be CDDA (multiple CD tracks), FSB (contains multiple sounds), DLS (contain instruments).<br>
|
||||||
|
The arrays of format, channel, frequency, length and blockalign should point to arrays of information based on how many subsounds are in the format. If the number of subsounds is 0 then it should point to 1 of each attribute, the same as if the number of subsounds was 1. If subsounds was 100 for example, each pointer should point to an array of 100 of each attribute.<br>
|
||||||
|
When a sound has 1 or more subsounds, you must play the individual sounds specified by first obtaining the subsound with Sound::getSubSound.
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_SOUND_FORMAT
|
||||||
|
FMOD_FILE_READCALLBACK
|
||||||
|
FMOD_FILE_SEEKCALLBACK
|
||||||
|
FMOD_CODEC_METADATACALLBACK
|
||||||
|
Sound::getSubSound
|
||||||
|
Sound::getNumSubSounds
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
struct FMOD_CODEC_STATE
|
||||||
|
{
|
||||||
|
int numsubsounds; /* [in] Number of 'subsounds' in this sound. Anything other than 0 makes it a 'container' format (ie CDDA/DLS/FSB etc which contain 1 or more su bsounds). For most normal, single sound codec such as WAV/AIFF/MP3, this should be 0 as they are not a container for subsounds, they are the sound by itself. */
|
||||||
|
FMOD_CODEC_WAVEFORMAT *waveformat; /* [in] Pointer to an array of format structures containing information about each sample. Can be 0 or NULL if FMOD_CODEC_GETWAVEFORMAT callback is preferred. The number of entries here must equal the number of subsounds defined in the subsound parameter. If numsubsounds = 0 then there should be 1 instance of this structure. */
|
||||||
|
void *plugindata; /* [in] Plugin writer created data the codec author wants to attach to this object. */
|
||||||
|
|
||||||
|
void *filehandle; /* [out] This will return an internal FMOD file handle to use with the callbacks provided. */
|
||||||
|
unsigned int filesize; /* [out] This will contain the size of the file in bytes. */
|
||||||
|
FMOD_FILE_READCALLBACK fileread; /* [out] This will return a callable FMOD file function to use from codec. */
|
||||||
|
FMOD_FILE_SEEKCALLBACK fileseek; /* [out] This will return a callable FMOD file function to use from codec. */
|
||||||
|
FMOD_CODEC_METADATACALLBACK metadata; /* [out] This will return a callable FMOD metadata function to use from codec. */
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
746
fmodex/inc/fmod_dsp.h
Normal file
746
fmodex/inc/fmod_dsp.h
Normal file
|
@ -0,0 +1,746 @@
|
||||||
|
/* ========================================================================================== */
|
||||||
|
/* FMOD Ex - DSP header file. Copyright (c), Firelight Technologies Pty, Ltd. 2004-2016. */
|
||||||
|
/* */
|
||||||
|
/* Use this header if you are interested in delving deeper into the FMOD software mixing / */
|
||||||
|
/* DSP engine. In this header you can find parameter structures for FMOD system reigstered */
|
||||||
|
/* DSP effects and generators. */
|
||||||
|
/* Also use this header if you are wanting to develop your own DSP plugin to use with FMOD's */
|
||||||
|
/* dsp system. With this header you can make your own DSP plugin that FMOD can */
|
||||||
|
/* register and use. See the documentation and examples on how to make a working plugin. */
|
||||||
|
/* */
|
||||||
|
/* ========================================================================================== */
|
||||||
|
|
||||||
|
#ifndef _FMOD_DSP_H
|
||||||
|
#define _FMOD_DSP_H
|
||||||
|
|
||||||
|
typedef struct FMOD_DSP_STATE FMOD_DSP_STATE;
|
||||||
|
|
||||||
|
/*
|
||||||
|
DSP callbacks
|
||||||
|
*/
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_CREATECALLBACK) (FMOD_DSP_STATE *dsp_state);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_RELEASECALLBACK) (FMOD_DSP_STATE *dsp_state);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_RESETCALLBACK) (FMOD_DSP_STATE *dsp_state);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_READCALLBACK) (FMOD_DSP_STATE *dsp_state, float *inbuffer, float *outbuffer, unsigned int length, int inchannels, int outchannels);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_SETPOSITIONCALLBACK)(FMOD_DSP_STATE *dsp_state, unsigned int pos);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_SETPARAMCALLBACK) (FMOD_DSP_STATE *dsp_state, int index, float value);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_GETPARAMCALLBACK) (FMOD_DSP_STATE *dsp_state, int index, float *value, char *valuestr);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_DSP_DIALOGCALLBACK) (FMOD_DSP_STATE *dsp_state, void *hwnd, int show);
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
These definitions can be used for creating FMOD defined special effects or DSP units.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
To get them to be active, first create the unit, then add it somewhere into the DSP network, either at the front of the network near the soundcard unit to affect the global output (by using System::getDSPHead), or on a single channel (using Channel::getDSPHead).
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
System::createDSPByType
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_TYPE_UNKNOWN, /* This unit was created via a non FMOD plugin so has an unknown purpose. */
|
||||||
|
FMOD_DSP_TYPE_MIXER, /* This unit does nothing but take inputs and mix them together then feed the result to the soundcard unit. */
|
||||||
|
FMOD_DSP_TYPE_OSCILLATOR, /* This unit generates sine/square/saw/triangle or noise tones. */
|
||||||
|
FMOD_DSP_TYPE_LOWPASS, /* This unit filters sound using a high quality, resonant lowpass filter algorithm but consumes more CPU time. */
|
||||||
|
FMOD_DSP_TYPE_ITLOWPASS, /* This unit filters sound using a resonant lowpass filter algorithm that is used in Impulse Tracker, but with limited cutoff range (0 to 8060hz). */
|
||||||
|
FMOD_DSP_TYPE_HIGHPASS, /* This unit filters sound using a resonant highpass filter algorithm. */
|
||||||
|
FMOD_DSP_TYPE_ECHO, /* This unit produces an echo on the sound and fades out at the desired rate. */
|
||||||
|
FMOD_DSP_TYPE_FLANGE, /* This unit produces a flange effect on the sound. */
|
||||||
|
FMOD_DSP_TYPE_DISTORTION, /* This unit distorts the sound. */
|
||||||
|
FMOD_DSP_TYPE_NORMALIZE, /* This unit normalizes or amplifies the sound to a certain level. */
|
||||||
|
FMOD_DSP_TYPE_PARAMEQ, /* This unit attenuates or amplifies a selected frequency range. */
|
||||||
|
FMOD_DSP_TYPE_PITCHSHIFT, /* This unit bends the pitch of a sound without changing the speed of playback. */
|
||||||
|
FMOD_DSP_TYPE_CHORUS, /* This unit produces a chorus effect on the sound. */
|
||||||
|
FMOD_DSP_TYPE_VSTPLUGIN, /* This unit allows the use of Steinberg VST plugins */
|
||||||
|
FMOD_DSP_TYPE_WINAMPPLUGIN, /* This unit allows the use of Nullsoft Winamp plugins */
|
||||||
|
FMOD_DSP_TYPE_ITECHO, /* This unit produces an echo on the sound and fades out at the desired rate as is used in Impulse Tracker. */
|
||||||
|
FMOD_DSP_TYPE_COMPRESSOR, /* This unit implements dynamic compression (linked multichannel, wideband) */
|
||||||
|
FMOD_DSP_TYPE_SFXREVERB, /* This unit implements SFX reverb */
|
||||||
|
FMOD_DSP_TYPE_LOWPASS_SIMPLE, /* This unit filters sound using a simple lowpass with no resonance, but has flexible cutoff and is fast. */
|
||||||
|
FMOD_DSP_TYPE_DELAY, /* This unit produces different delays on individual channels of the sound. */
|
||||||
|
FMOD_DSP_TYPE_TREMOLO, /* This unit produces a tremolo / chopper effect on the sound. */
|
||||||
|
FMOD_DSP_TYPE_LADSPAPLUGIN, /* This unit allows the use of LADSPA standard plugins. */
|
||||||
|
FMOD_DSP_TYPE_HIGHPASS_SIMPLE, /* This unit filters sound using a simple highpass with no resonance, but has flexible cutoff and is fast. */
|
||||||
|
FMOD_DSP_TYPE_HARDWARE = 1000, /* Offset that platform specific FMOD_HARDWARE DSPs will start at. */
|
||||||
|
FMOD_DSP_TYPE_FORCEINT = 65536 /* Makes sure this enum is signed 32bit. */
|
||||||
|
} FMOD_DSP_TYPE;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Structure to define a parameter for a DSP unit.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [r] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
Members marked with [w] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
System::createDSP
|
||||||
|
DSP::setParameter
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef struct FMOD_DSP_PARAMETERDESC
|
||||||
|
{
|
||||||
|
float min; /* [w] Minimum value of the parameter (ie 100.0). */
|
||||||
|
float max; /* [w] Maximum value of the parameter (ie 22050.0). */
|
||||||
|
float defaultval; /* [w] Default value of parameter. */
|
||||||
|
char name[16]; /* [w] Name of the parameter to be displayed (ie "Cutoff frequency"). */
|
||||||
|
char label[16]; /* [w] Short string to be put next to value to denote the unit type (ie "hz"). */
|
||||||
|
const char *description; /* [w] Description of the parameter to be displayed as a help item / tooltip for this parameter. */
|
||||||
|
} FMOD_DSP_PARAMETERDESC;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
When creating a DSP unit, declare one of these and provide the relevant callbacks and name for FMOD to use when it creates and uses a DSP unit of this type.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
<br>
|
||||||
|
Members marked with [r] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
Members marked with [w] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
<br>
|
||||||
|
IMPORTANT: The 'paramdesc' member should point to static memory, as FMOD references the data internally using the pointer provided. Do not store these parameter description structures on the stack, or in heap memory that is freed while FMOD is using it.<br>
|
||||||
|
<br>
|
||||||
|
There are 2 different ways to change a parameter in this architecture.<br>
|
||||||
|
One is to use DSP::setParameter / DSP::getParameter. This is platform independant and is dynamic, so new unknown plugins can have their parameters enumerated and used.<br>
|
||||||
|
The other is to use DSP::showConfigDialog. This is platform specific and requires a GUI, and will display a dialog box to configure the plugin.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
System::createDSP
|
||||||
|
FMOD_DSP_STATE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef struct FMOD_DSP_DESCRIPTION
|
||||||
|
{
|
||||||
|
char name[32]; /* [w] Name of the unit to be displayed in the network. */
|
||||||
|
unsigned int version; /* [w] Plugin writer's version number. */
|
||||||
|
int channels; /* [w] Number of channels. Use 0 to process whatever number of channels is currently in the network. >0 would be mostly used if the unit is a unit that only generates sound. */
|
||||||
|
FMOD_DSP_CREATECALLBACK create; /* [w] Create callback. This is called when DSP unit is created. Can be null. */
|
||||||
|
FMOD_DSP_RELEASECALLBACK release; /* [w] Release callback. This is called just before the unit is freed so the user can do any cleanup needed for the unit. Can be null. */
|
||||||
|
FMOD_DSP_RESETCALLBACK reset; /* [w] Reset callback. This is called by the user to reset any history buffers that may need resetting for a filter, when it is to be used or re-used for the first time to its initial clean state. Use to avoid clicks or artifacts. */
|
||||||
|
FMOD_DSP_READCALLBACK read; /* [w] Read callback. Processing is done here. Can be null. */
|
||||||
|
FMOD_DSP_SETPOSITIONCALLBACK setposition; /* [w] Set position callback. This is called if the unit wants to update its position info but not process data, or reset a cursor position internally if it is reading data from a certain source. Can be null. */
|
||||||
|
|
||||||
|
int numparameters; /* [w] Number of parameters used in this filter. The user finds this with DSP::getNumParameters */
|
||||||
|
FMOD_DSP_PARAMETERDESC *paramdesc; /* [w] Variable number of parameter structures. */
|
||||||
|
FMOD_DSP_SETPARAMCALLBACK setparameter; /* [w] This is called when the user calls DSP::setParameter. Can be null. */
|
||||||
|
FMOD_DSP_GETPARAMCALLBACK getparameter; /* [w] This is called when the user calls DSP::getParameter. Can be null. */
|
||||||
|
FMOD_DSP_DIALOGCALLBACK config; /* [w] This is called when the user calls DSP::showConfigDialog. Can be used to display a dialog to configure the filter. Can be null. */
|
||||||
|
int configwidth; /* [w] Width of config dialog graphic if there is one. 0 otherwise.*/
|
||||||
|
int configheight; /* [w] Height of config dialog graphic if there is one. 0 otherwise.*/
|
||||||
|
void *userdata; /* [w] Optional. Specify 0 to ignore. This is user data to be attached to the DSP unit during creation. Access via DSP::getUserData. */
|
||||||
|
} FMOD_DSP_DESCRIPTION;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
DSP plugin structure that is passed into each callback.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [r] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
Members marked with [w] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_DSP_DESCRIPTION
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
struct FMOD_DSP_STATE
|
||||||
|
{
|
||||||
|
FMOD_DSP *instance; /* [r] Handle to the DSP hand the user created. Not to be modified. C++ users cast to FMOD::DSP to use. */
|
||||||
|
void *plugindata; /* [w] Plugin writer created data the output author wants to attach to this object. */
|
||||||
|
unsigned short speakermask; /* [w] Specifies which speakers the DSP effect is active on */
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
===================================================================================================
|
||||||
|
|
||||||
|
FMOD built in effect parameters.
|
||||||
|
Use DSP::setParameter with these enums for the 'index' parameter.
|
||||||
|
|
||||||
|
===================================================================================================
|
||||||
|
*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_OSCILLATOR filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_OSCILLATOR_TYPE, /* Waveform type. 0 = sine. 1 = square. 2 = sawup. 3 = sawdown. 4 = triangle. 5 = noise. */
|
||||||
|
FMOD_DSP_OSCILLATOR_RATE /* Frequency of the sinewave in hz. 1.0 to 22000.0. Default = 220.0. */
|
||||||
|
} FMOD_DSP_OSCILLATOR;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_LOWPASS filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_LOWPASS_CUTOFF, /* Lowpass cutoff frequency in hz. 10.0 to 22000.0. Default = 5000.0. */
|
||||||
|
FMOD_DSP_LOWPASS_RESONANCE /* Lowpass resonance Q value. 1.0 to 10.0. Default = 1.0. */
|
||||||
|
} FMOD_DSP_LOWPASS;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_ITLOWPASS filter.<br>
|
||||||
|
This is different to the default FMOD_DSP_TYPE_ITLOWPASS filter in that it uses a different quality algorithm and is
|
||||||
|
the filter used to produce the correct sounding playback in .IT files.<br>
|
||||||
|
FMOD Ex's .IT playback uses this filter.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Note! This filter actually has a limited cutoff frequency below the specified maximum, due to its limited design,
|
||||||
|
so for a more open range filter use FMOD_DSP_LOWPASS or if you don't mind not having resonance,
|
||||||
|
FMOD_DSP_LOWPASS_SIMPLE.<br>
|
||||||
|
The effective maximum cutoff is about 8060hz.
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_ITLOWPASS_CUTOFF, /* Lowpass cutoff frequency in hz. 1.0 to 22000.0. Default = 5000.0/ */
|
||||||
|
FMOD_DSP_ITLOWPASS_RESONANCE /* Lowpass resonance Q value. 0.0 to 127.0. Default = 1.0. */
|
||||||
|
} FMOD_DSP_ITLOWPASS;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_HIGHPASS filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_HIGHPASS_CUTOFF, /* Highpass cutoff frequency in hz. 1.0 to output 22000.0. Default = 5000.0. */
|
||||||
|
FMOD_DSP_HIGHPASS_RESONANCE /* Highpass resonance Q value. 1.0 to 10.0. Default = 1.0. */
|
||||||
|
} FMOD_DSP_HIGHPASS;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_ECHO filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Note. Every time the delay is changed, the plugin re-allocates the echo buffer. This means the echo will dissapear at that time while it refills its new buffer.<br>
|
||||||
|
Larger echo delays result in larger amounts of memory allocated.<br>
|
||||||
|
<br>
|
||||||
|
'<i>maxchannels</i>' also dictates the amount of memory allocated. By default, the maxchannels value is 0. If FMOD is set to stereo, the echo unit will allocate enough memory for 2 channels. If it is 5.1, it will allocate enough memory for a 6 channel echo, etc.<br>
|
||||||
|
If the echo effect is only ever applied to the global mix (ie it was added with System::addDSP), then 0 is the value to set as it will be enough to handle all speaker modes.<br>
|
||||||
|
When the echo is added to a channel (ie Channel::addDSP) then the channel count that comes in could be anything from 1 to 8 possibly. It is only in this case where you might want to increase the channel count above the output's channel count.<br>
|
||||||
|
If a channel echo is set to a lower number than the sound's channel count that is coming in, it will not echo the sound.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_ECHO_DELAY, /* Echo delay in ms. 10 to 5000. Default = 500. */
|
||||||
|
FMOD_DSP_ECHO_DECAYRATIO, /* Echo decay per delay. 0 to 1. 1.0 = No decay, 0.0 = total decay (ie simple 1 line delay). Default = 0.5. */
|
||||||
|
FMOD_DSP_ECHO_MAXCHANNELS, /* Maximum channels supported. 0 to 16. 0 = same as fmod's default output polyphony, 1 = mono, 2 = stereo etc. See remarks for more. Default = 0. It is suggested to leave at 0! */
|
||||||
|
FMOD_DSP_ECHO_DRYMIX, /* Volume of original signal to pass to output. 0.0 to 1.0. Default = 1.0. */
|
||||||
|
FMOD_DSP_ECHO_WETMIX /* Volume of echo signal to pass to output. 0.0 to 1.0. Default = 1.0. */
|
||||||
|
} FMOD_DSP_ECHO;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_DELAY filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Note. Every time MaxDelay is changed, the plugin re-allocates the delay buffer. This means the delay will dissapear at that time while it refills its new buffer.<br>
|
||||||
|
A larger MaxDelay results in larger amounts of memory allocated.<br>
|
||||||
|
Channel delays above MaxDelay will be clipped to MaxDelay and the delay buffer will not be resized.<br>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_DELAY_CH0, /* Channel #0 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH1, /* Channel #1 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH2, /* Channel #2 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH3, /* Channel #3 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH4, /* Channel #4 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH5, /* Channel #5 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH6, /* Channel #6 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH7, /* Channel #7 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH8, /* Channel #8 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH9, /* Channel #9 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH10, /* Channel #10 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH11, /* Channel #11 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH12, /* Channel #12 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH13, /* Channel #13 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH14, /* Channel #14 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_CH15, /* Channel #15 Delay in ms. 0 to 10000. Default = 0. */
|
||||||
|
FMOD_DSP_DELAY_MAXDELAY /* Maximum delay in ms. 0 to 10000. Default = 10. */
|
||||||
|
} FMOD_DSP_DELAY;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_FLANGE filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Flange is an effect where the signal is played twice at the same time, and one copy slides back and forth creating a whooshing or flanging effect.<br>
|
||||||
|
As there are 2 copies of the same signal, by default each signal is given 50% mix, so that the total is not louder than the original unaffected signal.<br>
|
||||||
|
<br>
|
||||||
|
Flange depth is a percentage of a 10ms shift from the original signal. Anything above 10ms is not considered flange because to the ear it begins to 'echo' so 10ms is the highest value possible.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_FLANGE_DRYMIX, /* Volume of original signal to pass to output. 0.0 to 1.0. Default = 0.45. */
|
||||||
|
FMOD_DSP_FLANGE_WETMIX, /* Volume of flange signal to pass to output. 0.0 to 1.0. Default = 0.55. */
|
||||||
|
FMOD_DSP_FLANGE_DEPTH, /* Flange depth (percentage of 40ms delay). 0.01 to 1.0. Default = 1.0. */
|
||||||
|
FMOD_DSP_FLANGE_RATE /* Flange speed in hz. 0.0 to 20.0. Default = 0.1. */
|
||||||
|
} FMOD_DSP_FLANGE;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_TREMOLO filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
The tremolo effect varies the amplitude of a sound. Depending on the settings, this unit can produce a tremolo, chopper or auto-pan effect.<br>
|
||||||
|
<br>
|
||||||
|
The shape of the LFO (low freq. oscillator) can morphed between sine, triangle and sawtooth waves using the FMOD_DSP_TREMOLO_SHAPE and FMOD_DSP_TREMOLO_SKEW parameters.<br>
|
||||||
|
FMOD_DSP_TREMOLO_DUTY and FMOD_DSP_TREMOLO_SQUARE are useful for a chopper-type effect where the first controls the on-time duration and second controls the flatness of the envelope.<br>
|
||||||
|
FMOD_DSP_TREMOLO_SPREAD varies the LFO phase between channels to get an auto-pan effect. This works best with a sine shape LFO.<br>
|
||||||
|
The LFO can be synchronized using the FMOD_DSP_TREMOLO_PHASE parameter which sets its instantaneous phase.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_TREMOLO_FREQUENCY, /* LFO frequency in Hz. 0.1 to 20. Default = 4. */
|
||||||
|
FMOD_DSP_TREMOLO_DEPTH, /* Tremolo depth. 0 to 1. Default = 0. */
|
||||||
|
FMOD_DSP_TREMOLO_SHAPE, /* LFO shape morph between triangle and sine. 0 to 1. Default = 0. */
|
||||||
|
FMOD_DSP_TREMOLO_SKEW, /* Time-skewing of LFO cycle. -1 to 1. Default = 0. */
|
||||||
|
FMOD_DSP_TREMOLO_DUTY, /* LFO on-time. 0 to 1. Default = 0.5. */
|
||||||
|
FMOD_DSP_TREMOLO_SQUARE, /* Flatness of the LFO shape. 0 to 1. Default = 0. */
|
||||||
|
FMOD_DSP_TREMOLO_PHASE, /* Instantaneous LFO phase. 0 to 1. Default = 0. */
|
||||||
|
FMOD_DSP_TREMOLO_SPREAD /* Rotation / auto-pan effect. -1 to 1. Default = 0. */
|
||||||
|
} FMOD_DSP_TREMOLO;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_DISTORTION filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_DISTORTION_LEVEL /* Distortion value. 0.0 to 1.0. Default = 0.5. */
|
||||||
|
} FMOD_DSP_DISTORTION;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_NORMALIZE filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Normalize amplifies the sound based on the maximum peaks within the signal.<br>
|
||||||
|
For example if the maximum peaks in the signal were 50% of the bandwidth, it would scale the whole sound by 2.<br>
|
||||||
|
The lower threshold value makes the normalizer ignores peaks below a certain point, to avoid over-amplification if a loud signal suddenly came in, and also to avoid amplifying to maximum things like background hiss.<br>
|
||||||
|
<br>
|
||||||
|
Because FMOD is a realtime audio processor, it doesn't have the luxury of knowing the peak for the whole sound (ie it can't see into the future), so it has to process data as it comes in.<br>
|
||||||
|
To avoid very sudden changes in volume level based on small samples of new data, fmod fades towards the desired amplification which makes for smooth gain control. The fadetime parameter can control this.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_NORMALIZE_FADETIME, /* Time to ramp the silence to full in ms. 0.0 to 20000.0. Default = 5000.0. */
|
||||||
|
FMOD_DSP_NORMALIZE_THRESHHOLD, /* Lower volume range threshold to ignore. 0.0 to 1.0. Default = 0.1. Raise higher to stop amplification of very quiet signals. */
|
||||||
|
FMOD_DSP_NORMALIZE_MAXAMP /* Maximum amplification allowed. 1.0 to 100000.0. Default = 20.0. 1.0 = no amplifaction, higher values allow more boost. */
|
||||||
|
} FMOD_DSP_NORMALIZE;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_PARAMEQ filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Parametric EQ is a bandpass filter that attenuates or amplifies a selected frequency and its neighbouring frequencies.<br>
|
||||||
|
<br>
|
||||||
|
To create a multi-band EQ create multiple FMOD_DSP_TYPE_PARAMEQ units and set each unit to different frequencies, for example 1000hz, 2000hz, 4000hz, 8000hz, 16000hz with a range of 1 octave each.<br>
|
||||||
|
<br>
|
||||||
|
When a frequency has its gain set to 1.0, the sound will be unaffected and represents the original signal exactly.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_PARAMEQ_CENTER, /* Frequency center. 20.0 to 22000.0. Default = 8000.0. */
|
||||||
|
FMOD_DSP_PARAMEQ_BANDWIDTH, /* Octave range around the center frequency to filter. 0.2 to 5.0. Default = 1.0. */
|
||||||
|
FMOD_DSP_PARAMEQ_GAIN /* Frequency Gain. 0.05 to 3.0. Default = 1.0. */
|
||||||
|
} FMOD_DSP_PARAMEQ;
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_PITCHSHIFT filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
This pitch shifting unit can be used to change the pitch of a sound without speeding it up or slowing it down.<br>
|
||||||
|
It can also be used for time stretching or scaling, for example if the pitch was doubled, and the frequency of the sound was halved, the pitch of the sound would sound correct but it would be twice as slow.<br>
|
||||||
|
<br>
|
||||||
|
<b>Warning!</b> This filter is very computationally expensive! Similar to a vocoder, it requires several overlapping FFT and IFFT's to produce smooth output, and can require around 440mhz for 1 stereo 48khz signal using the default settings.<br>
|
||||||
|
Reducing the signal to mono will half the cpu usage.<br>
|
||||||
|
Reducing this will lower audio quality, but what settings to use are largely dependant on the sound being played. A noisy polyphonic signal will need higher fft size compared to a speaking voice for example.<br>
|
||||||
|
<br>
|
||||||
|
This pitch shifter is based on the pitch shifter code at http://www.dspdimension.com, written by Stephan M. Bernsee.<br>
|
||||||
|
The original code is COPYRIGHT 1999-2003 Stephan M. Bernsee <smb@dspdimension.com>.<br>
|
||||||
|
<br>
|
||||||
|
'<i>maxchannels</i>' dictates the amount of memory allocated. By default, the maxchannels value is 0. If FMOD is set to stereo, the pitch shift unit will allocate enough memory for 2 channels. If it is 5.1, it will allocate enough memory for a 6 channel pitch shift, etc.<br>
|
||||||
|
If the pitch shift effect is only ever applied to the global mix (ie it was added with System::addDSP), then 0 is the value to set as it will be enough to handle all speaker modes.<br>
|
||||||
|
When the pitch shift is added to a channel (ie Channel::addDSP) then the channel count that comes in could be anything from 1 to 8 possibly. It is only in this case where you might want to increase the channel count above the output's channel count.<br>
|
||||||
|
If a channel pitch shift is set to a lower number than the sound's channel count that is coming in, it will not pitch shift the sound.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_PITCHSHIFT_PITCH, /* Pitch value. 0.5 to 2.0. Default = 1.0. 0.5 = one octave down, 2.0 = one octave up. 1.0 does not change the pitch. */
|
||||||
|
FMOD_DSP_PITCHSHIFT_FFTSIZE, /* FFT window size. 256, 512, 1024, 2048, 4096. Default = 1024. Increase this to reduce 'smearing'. This effect is a warbling sound similar to when an mp3 is encoded at very low bitrates. */
|
||||||
|
FMOD_DSP_PITCHSHIFT_OVERLAP, /* Removed. Do not use. FMOD now uses 4 overlaps and cannot be changed. */
|
||||||
|
FMOD_DSP_PITCHSHIFT_MAXCHANNELS /* Maximum channels supported. 0 to 16. 0 = same as fmod's default output polyphony, 1 = mono, 2 = stereo etc. See remarks for more. Default = 0. It is suggested to leave at 0! */
|
||||||
|
} FMOD_DSP_PITCHSHIFT;
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_CHORUS filter.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Chrous is an effect where the sound is more 'spacious' due to 1 to 3 versions of the sound being played along side the original signal but with the pitch of each copy modulating on a sine wave.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_CHORUS_DRYMIX, /* Volume of original signal to pass to output. 0.0 to 1.0. Default = 0.5. */
|
||||||
|
FMOD_DSP_CHORUS_WETMIX1, /* Volume of 1st chorus tap. 0.0 to 1.0. Default = 0.5. */
|
||||||
|
FMOD_DSP_CHORUS_WETMIX2, /* Volume of 2nd chorus tap. This tap is 90 degrees out of phase of the first tap. 0.0 to 1.0. Default = 0.5. */
|
||||||
|
FMOD_DSP_CHORUS_WETMIX3, /* Volume of 3rd chorus tap. This tap is 90 degrees out of phase of the second tap. 0.0 to 1.0. Default = 0.5. */
|
||||||
|
FMOD_DSP_CHORUS_DELAY, /* Chorus delay in ms. 0.1 to 100.0. Default = 40.0 ms. */
|
||||||
|
FMOD_DSP_CHORUS_RATE, /* Chorus modulation rate in hz. 0.0 to 20.0. Default = 0.8 hz. */
|
||||||
|
FMOD_DSP_CHORUS_DEPTH /* Chorus modulation depth. 0.0 to 1.0. Default = 0.03. */
|
||||||
|
} FMOD_DSP_CHORUS;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_ITECHO filter.<br>
|
||||||
|
This is effectively a software based echo filter that emulates the DirectX DMO echo effect. Impulse tracker files can support this, and FMOD will produce the effect on ANY platform, not just those that support DirectX effects!<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Note. Every time the delay is changed, the plugin re-allocates the echo buffer. This means the echo will dissapear at that time while it refills its new buffer.<br>
|
||||||
|
Larger echo delays result in larger amounts of memory allocated.<br>
|
||||||
|
<br>
|
||||||
|
As this is a stereo filter made mainly for IT playback, it is targeted for stereo signals.<br>
|
||||||
|
With mono signals only the FMOD_DSP_ITECHO_LEFTDELAY is used.<br>
|
||||||
|
For multichannel signals (>2) there will be no echo on those channels.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::SetParameter
|
||||||
|
DSP::GetParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
System::addDSP
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_ITECHO_WETDRYMIX, /* Ratio of wet (processed) signal to dry (unprocessed) signal. Must be in the range from 0.0 through 100.0 (all wet). The default value is 50. */
|
||||||
|
FMOD_DSP_ITECHO_FEEDBACK, /* Percentage of output fed back into input, in the range from 0.0 through 100.0. The default value is 50. */
|
||||||
|
FMOD_DSP_ITECHO_LEFTDELAY, /* Delay for left channel, in milliseconds, in the range from 1.0 through 2000.0. The default value is 500 ms. */
|
||||||
|
FMOD_DSP_ITECHO_RIGHTDELAY, /* Delay for right channel, in milliseconds, in the range from 1.0 through 2000.0. The default value is 500 ms. */
|
||||||
|
FMOD_DSP_ITECHO_PANDELAY /* Value that specifies whether to swap left and right delays with each successive echo. The default value is zero, meaning no swap. Possible values are defined as 0.0 (equivalent to FALSE) and 1.0 (equivalent to TRUE). CURRENTLY NOT SUPPORTED. */
|
||||||
|
} FMOD_DSP_ITECHO;
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_COMPRESSOR unit.
|
||||||
|
This is a simple linked multichannel software limiter that is uniform across the whole spectrum.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
The limiter is not guaranteed to catch every peak above the threshold level,
|
||||||
|
because it cannot apply gain reduction instantaneously - the time delay is
|
||||||
|
determined by the attack time. However setting the attack time too short will
|
||||||
|
distort the sound, so it is a compromise. High level peaks can be avoided by
|
||||||
|
using a short attack time - but not too short, and setting the threshold a few
|
||||||
|
decibels below the critical level.
|
||||||
|
<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::SetParameter
|
||||||
|
DSP::GetParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
System::addDSP
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_COMPRESSOR_THRESHOLD, /* Threshold level (dB) in the range from -60 through 0. The default value is 0. */
|
||||||
|
FMOD_DSP_COMPRESSOR_ATTACK, /* Gain reduction attack time (milliseconds), in the range from 10 through 200. The default value is 50. */
|
||||||
|
FMOD_DSP_COMPRESSOR_RELEASE, /* Gain reduction release time (milliseconds), in the range from 20 through 1000. The default value is 50. */
|
||||||
|
FMOD_DSP_COMPRESSOR_GAINMAKEUP /* Make-up gain (dB) applied after limiting, in the range from 0 through 30. The default value is 0. */
|
||||||
|
} FMOD_DSP_COMPRESSOR;
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_SFXREVERB unit.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
This is a high quality I3DL2 based reverb.<br>
|
||||||
|
On top of the I3DL2 property set, "Dry Level" is also included to allow the dry mix to be changed.<br>
|
||||||
|
<br>
|
||||||
|
These properties can be set with presets in FMOD_REVERB_PRESETS.
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::SetParameter
|
||||||
|
DSP::GetParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
System::addDSP
|
||||||
|
FMOD_REVERB_PRESETS
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_SFXREVERB_DRYLEVEL, /* Dry Level : Mix level of dry signal in output in mB. Ranges from -10000.0 to 0.0. Default is 0. */
|
||||||
|
FMOD_DSP_SFXREVERB_ROOM, /* Room : Room effect level at low frequencies in mB. Ranges from -10000.0 to 0.0. Default is -10000.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_ROOMHF, /* Room HF : Room effect high-frequency level re. low frequency level in mB. Ranges from -10000.0 to 0.0. Default is 0.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_DECAYTIME, /* Decay Time : Reverberation decay time at low-frequencies in seconds. Ranges from 0.1 to 20.0. Default is 1.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_DECAYHFRATIO, /* Decay HF Ratio : High-frequency to low-frequency decay time ratio. Ranges from 0.1 to 2.0. Default is 0.5. */
|
||||||
|
FMOD_DSP_SFXREVERB_REFLECTIONSLEVEL, /* Reflections : Early reflections level relative to room effect in mB. Ranges from -10000.0 to 1000.0. Default is -10000.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_REFLECTIONSDELAY, /* Reflect Delay : Delay time of first reflection in seconds. Ranges from 0.0 to 0.3. Default is 0.02. */
|
||||||
|
FMOD_DSP_SFXREVERB_REVERBLEVEL, /* Reverb : Late reverberation level relative to room effect in mB. Ranges from -10000.0 to 2000.0. Default is 0.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_REVERBDELAY, /* Reverb Delay : Late reverberation delay time relative to first reflection in seconds. Ranges from 0.0 to 0.1. Default is 0.04. */
|
||||||
|
FMOD_DSP_SFXREVERB_DIFFUSION, /* Diffusion : Reverberation diffusion (echo density) in percent. Ranges from 0.0 to 100.0. Default is 100.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_DENSITY, /* Density : Reverberation density (modal density) in percent. Ranges from 0.0 to 100.0. Default is 100.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_HFREFERENCE, /* HF Reference : Reference high frequency in Hz. Ranges from 20.0 to 20000.0. Default is 5000.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_ROOMLF, /* Room LF : Room effect low-frequency level in mB. Ranges from -10000.0 to 0.0. Default is 0.0. */
|
||||||
|
FMOD_DSP_SFXREVERB_LFREFERENCE /* LF Reference : Reference low-frequency in Hz. Ranges from 20.0 to 1000.0. Default is 250.0. */
|
||||||
|
} FMOD_DSP_SFXREVERB;
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_LOWPASS_SIMPLE filter.<br>
|
||||||
|
This is a very simple low pass filter, based on two single-pole RC time-constant modules.
|
||||||
|
The emphasis is on speed rather than accuracy, so this should not be used for task requiring critical filtering.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_LOWPASS_SIMPLE_CUTOFF /* Lowpass cutoff frequency in hz. 10.0 to 22000.0. Default = 5000.0 */
|
||||||
|
} FMOD_DSP_LOWPASS_SIMPLE;
|
||||||
|
|
||||||
|
/*
|
||||||
|
[ENUM]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Parameter types for the FMOD_DSP_TYPE_HIGHPASS_SIMPLE filter.<br>
|
||||||
|
This is a very simple single-order high pass filter.
|
||||||
|
The emphasis is on speed rather than accuracy, so this should not be used for task requiring critical filtering.<br>
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
DSP::setParameter
|
||||||
|
DSP::getParameter
|
||||||
|
FMOD_DSP_TYPE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef enum
|
||||||
|
{
|
||||||
|
FMOD_DSP_HIGHPASS_SIMPLE_CUTOFF /* Highpass cutoff frequency in hz. 10.0 to 22000.0. Default = 1000.0 */
|
||||||
|
} FMOD_DSP_HIGHPASS_SIMPLE;
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
127
fmodex/inc/fmod_errors.h
Normal file
127
fmodex/inc/fmod_errors.h
Normal file
|
@ -0,0 +1,127 @@
|
||||||
|
/*$ preserve start $*/
|
||||||
|
|
||||||
|
/* ============================================================================================== */
|
||||||
|
/* FMOD Ex - Error string header file. Copyright (c), Firelight Technologies Pty, Ltd. 2004-2016. */
|
||||||
|
/* */
|
||||||
|
/* Use this header if you want to store or display a string version / english explanation of */
|
||||||
|
/* the FMOD error codes. */
|
||||||
|
/* */
|
||||||
|
/* ============================================================================================== */
|
||||||
|
|
||||||
|
#ifndef _FMOD_ERRORS_H
|
||||||
|
#define _FMOD_ERRORS_H
|
||||||
|
|
||||||
|
#include "fmod.h"
|
||||||
|
|
||||||
|
#ifdef __GNUC__
|
||||||
|
static const char *FMOD_ErrorString(FMOD_RESULT errcode) __attribute__((unused));
|
||||||
|
#endif
|
||||||
|
|
||||||
|
static const char *FMOD_ErrorString(FMOD_RESULT errcode)
|
||||||
|
{
|
||||||
|
switch (errcode)
|
||||||
|
{
|
||||||
|
/*$ preserve end $*/
|
||||||
|
case FMOD_ERR_ALREADYLOCKED: return "Tried to call lock a second time before unlock was called. ";
|
||||||
|
case FMOD_ERR_BADCOMMAND: return "Tried to call a function on a data type that does not allow this type of functionality (ie calling Sound::lock on a streaming sound). ";
|
||||||
|
case FMOD_ERR_CDDA_DRIVERS: return "Neither NTSCSI nor ASPI could be initialised. ";
|
||||||
|
case FMOD_ERR_CDDA_INIT: return "An error occurred while initialising the CDDA subsystem. ";
|
||||||
|
case FMOD_ERR_CDDA_INVALID_DEVICE: return "Couldn't find the specified device. ";
|
||||||
|
case FMOD_ERR_CDDA_NOAUDIO: return "No audio tracks on the specified disc. ";
|
||||||
|
case FMOD_ERR_CDDA_NODEVICES: return "No CD/DVD devices were found. ";
|
||||||
|
case FMOD_ERR_CDDA_NODISC: return "No disc present in the specified drive. ";
|
||||||
|
case FMOD_ERR_CDDA_READ: return "A CDDA read error occurred. ";
|
||||||
|
case FMOD_ERR_CHANNEL_ALLOC: return "Error trying to allocate a channel. ";
|
||||||
|
case FMOD_ERR_CHANNEL_STOLEN: return "The specified channel has been reused to play another sound. ";
|
||||||
|
case FMOD_ERR_COM: return "A Win32 COM related error occured. COM failed to initialize or a QueryInterface failed meaning a Windows codec or driver was not installed properly. ";
|
||||||
|
case FMOD_ERR_DMA: return "DMA Failure. See debug output for more information. ";
|
||||||
|
case FMOD_ERR_DSP_CONNECTION: return "DSP connection error. Connection possibly caused a cyclic dependancy. Or tried to connect a tree too many units deep (more than 128). ";
|
||||||
|
case FMOD_ERR_DSP_FORMAT: return "DSP Format error. A DSP unit may have attempted to connect to this network with the wrong format. ";
|
||||||
|
case FMOD_ERR_DSP_NOTFOUND: return "DSP connection error. Couldn't find the DSP unit specified. ";
|
||||||
|
case FMOD_ERR_DSP_RUNNING: return "DSP error. Cannot perform this operation while the network is in the middle of running. This will most likely happen if a connection or disconnection is attempted in a DSP callback. ";
|
||||||
|
case FMOD_ERR_DSP_TOOMANYCONNECTIONS: return "DSP connection error. The unit being connected to or disconnected should only have 1 input or output. ";
|
||||||
|
case FMOD_ERR_EVENT_ALREADY_LOADED: return "The specified project or bank has already been loaded. Having multiple copies of the same project loaded simultaneously is forbidden. ";
|
||||||
|
case FMOD_ERR_EVENT_FAILED: return "An Event failed to be retrieved, most likely due to 'just fail' being specified as the max playbacks behavior. ";
|
||||||
|
case FMOD_ERR_EVENT_GUIDCONFLICT: return "An event with the same GUID already exists. ";
|
||||||
|
case FMOD_ERR_EVENT_INFOONLY: return "Can't execute this command on an EVENT_INFOONLY event. ";
|
||||||
|
case FMOD_ERR_EVENT_INTERNAL: return "An error occured that wasn't supposed to. See debug log for reason. ";
|
||||||
|
case FMOD_ERR_EVENT_MAXSTREAMS: return "Event failed because 'Max streams' was hit when FMOD_EVENT_INIT_FAIL_ON_MAXSTREAMS was specified. ";
|
||||||
|
case FMOD_ERR_EVENT_MISMATCH: return "FSB mismatches the FEV it was compiled with, the stream/sample mode it was meant to be created with was different, or the FEV was built for a different platform. ";
|
||||||
|
case FMOD_ERR_EVENT_NAMECONFLICT: return "A category with the same name already exists. ";
|
||||||
|
case FMOD_ERR_EVENT_NEEDSSIMPLE: return "Tried to call a function on a complex event that's only supported by simple events. ";
|
||||||
|
case FMOD_ERR_EVENT_NOTFOUND: return "The requested event, event group, event category or event property could not be found. ";
|
||||||
|
case FMOD_ERR_FILE_BAD: return "Error loading file. ";
|
||||||
|
case FMOD_ERR_FILE_COULDNOTSEEK: return "Couldn't perform seek operation. This is a limitation of the medium (ie netstreams) or the file format. ";
|
||||||
|
case FMOD_ERR_FILE_DISKEJECTED: return "Media was ejected while reading. ";
|
||||||
|
case FMOD_ERR_FILE_EOF: return "End of file unexpectedly reached while trying to read essential data (truncated data?). ";
|
||||||
|
case FMOD_ERR_FILE_NOTFOUND: return "File not found. ";
|
||||||
|
case FMOD_ERR_FILE_UNWANTED: return "Unwanted file access occured. ";
|
||||||
|
case FMOD_ERR_FORMAT: return "Unsupported file or audio format. ";
|
||||||
|
case FMOD_ERR_HTTP: return "A HTTP error occurred. This is a catch-all for HTTP errors not listed elsewhere. ";
|
||||||
|
case FMOD_ERR_HTTP_ACCESS: return "The specified resource requires authentication or is forbidden. ";
|
||||||
|
case FMOD_ERR_HTTP_PROXY_AUTH: return "Proxy authentication is required to access the specified resource. ";
|
||||||
|
case FMOD_ERR_HTTP_SERVER_ERROR: return "A HTTP server error occurred. ";
|
||||||
|
case FMOD_ERR_HTTP_TIMEOUT: return "The HTTP request timed out. ";
|
||||||
|
case FMOD_ERR_INITIALIZATION: return "FMOD was not initialized correctly to support this function. ";
|
||||||
|
case FMOD_ERR_INITIALIZED: return "Cannot call this command after System::init. ";
|
||||||
|
case FMOD_ERR_INTERNAL: return "An error occured that wasn't supposed to. Contact support. ";
|
||||||
|
case FMOD_ERR_INVALID_ADDRESS: return "On Xbox 360, this memory address passed to FMOD must be physical, (ie allocated with XPhysicalAlloc.) ";
|
||||||
|
case FMOD_ERR_INVALID_FLOAT: return "Value passed in was a NaN, Inf or denormalized float. ";
|
||||||
|
case FMOD_ERR_INVALID_HANDLE: return "An invalid object handle was used. ";
|
||||||
|
case FMOD_ERR_INVALID_PARAM: return "An invalid parameter was passed to this function. ";
|
||||||
|
case FMOD_ERR_INVALID_POSITION: return "An invalid seek position was passed to this function. ";
|
||||||
|
case FMOD_ERR_INVALID_SPEAKER: return "An invalid speaker was passed to this function based on the current speaker mode. ";
|
||||||
|
case FMOD_ERR_INVALID_SYNCPOINT: return "The syncpoint did not come from this sound handle. ";
|
||||||
|
case FMOD_ERR_INVALID_VECTOR: return "The vectors passed in are not unit length, or perpendicular. ";
|
||||||
|
case FMOD_ERR_MAXAUDIBLE: return "Reached maximum audible playback count for this sound's soundgroup. ";
|
||||||
|
case FMOD_ERR_MEMORY: return "Not enough memory or resources. ";
|
||||||
|
case FMOD_ERR_MEMORY_CANTPOINT: return "Can't use FMOD_OPENMEMORY_POINT on non PCM source data, or non mp3/xma/adpcm data if FMOD_CREATECOMPRESSEDSAMPLE was used. ";
|
||||||
|
case FMOD_ERR_MEMORY_SRAM: return "Not enough memory or resources on console sound ram. ";
|
||||||
|
case FMOD_ERR_MUSIC_NOCALLBACK: return "The music callback is required, but it has not been set. ";
|
||||||
|
case FMOD_ERR_MUSIC_NOTFOUND: return "The requested music entity could not be found. ";
|
||||||
|
case FMOD_ERR_MUSIC_UNINITIALIZED: return "Music system is not initialized probably because no music data is loaded. ";
|
||||||
|
case FMOD_ERR_NEEDS2D: return "Tried to call a command on a 3d sound when the command was meant for 2d sound. ";
|
||||||
|
case FMOD_ERR_NEEDS3D: return "Tried to call a command on a 2d sound when the command was meant for 3d sound. ";
|
||||||
|
case FMOD_ERR_NEEDSHARDWARE: return "Tried to use a feature that requires hardware support. (ie trying to play a GCADPCM compressed sound in software on Wii). ";
|
||||||
|
case FMOD_ERR_NEEDSSOFTWARE: return "Tried to use a feature that requires the software engine. Software engine has either been turned off, or command was executed on a hardware channel which does not support this feature. ";
|
||||||
|
case FMOD_ERR_NET_CONNECT: return "Couldn't connect to the specified host. ";
|
||||||
|
case FMOD_ERR_NET_SOCKET_ERROR: return "A socket error occurred. This is a catch-all for socket-related errors not listed elsewhere. ";
|
||||||
|
case FMOD_ERR_NET_URL: return "The specified URL couldn't be resolved. ";
|
||||||
|
case FMOD_ERR_NET_WOULD_BLOCK: return "Operation on a non-blocking socket could not complete immediately. ";
|
||||||
|
case FMOD_ERR_NOTREADY: return "Operation could not be performed because specified sound/DSP connection is not ready. ";
|
||||||
|
case FMOD_ERR_OUTPUT_ALLOCATED: return "Error initializing output device, but more specifically, the output device is already in use and cannot be reused. ";
|
||||||
|
case FMOD_ERR_OUTPUT_CREATEBUFFER: return "Error creating hardware sound buffer. ";
|
||||||
|
case FMOD_ERR_OUTPUT_DRIVERCALL: return "A call to a standard soundcard driver failed, which could possibly mean a bug in the driver or resources were missing or exhausted. ";
|
||||||
|
case FMOD_ERR_OUTPUT_ENUMERATION: return "Error enumerating the available driver list. List may be inconsistent due to a recent device addition or removal. ";
|
||||||
|
case FMOD_ERR_OUTPUT_FORMAT: return "Soundcard does not support the minimum features needed for this soundsystem (16bit stereo output). ";
|
||||||
|
case FMOD_ERR_OUTPUT_INIT: return "Error initializing output device. ";
|
||||||
|
case FMOD_ERR_OUTPUT_NOHARDWARE: return "FMOD_HARDWARE was specified but the sound card does not have the resources necessary to play it. ";
|
||||||
|
case FMOD_ERR_OUTPUT_NOSOFTWARE: return "Attempted to create a software sound but no software channels were specified in System::init. ";
|
||||||
|
case FMOD_ERR_PAN: return "Panning only works with mono or stereo sound sources. ";
|
||||||
|
case FMOD_ERR_PLUGIN: return "An unspecified error has been returned from a 3rd party plugin. ";
|
||||||
|
case FMOD_ERR_PLUGIN_INSTANCES: return "The number of allowed instances of a plugin has been exceeded. ";
|
||||||
|
case FMOD_ERR_PLUGIN_MISSING: return "A requested output, dsp unit type or codec was not available. ";
|
||||||
|
case FMOD_ERR_PLUGIN_RESOURCE: return "A resource that the plugin requires cannot be found. (ie the DLS file for MIDI playback or other DLLs that it needs to load) ";
|
||||||
|
case FMOD_ERR_PRELOADED: return "The specified sound is still in use by the event system, call EventSystem::unloadFSB before trying to release it. ";
|
||||||
|
case FMOD_ERR_PROGRAMMERSOUND: return "The specified sound is still in use by the event system, wait for the event which is using it finish with it. ";
|
||||||
|
case FMOD_ERR_RECORD: return "An error occured trying to initialize the recording device. ";
|
||||||
|
case FMOD_ERR_REVERB_INSTANCE: return "Specified instance in FMOD_REVERB_PROPERTIES couldn't be set. Most likely because it is an invalid instance number or the reverb doesnt exist. ";
|
||||||
|
case FMOD_ERR_SUBSOUNDS: return "The error occured because the sound referenced contains subsounds when it shouldn't have, or it doesn't contain subsounds when it should have. The operation may also not be able to be performed on a parent sound, or a parent sound was played without setting up a sentence first. ";
|
||||||
|
case FMOD_ERR_SUBSOUND_ALLOCATED: return "This subsound is already being used by another sound, you cannot have more than one parent to a sound. Null out the other parent's entry first. ";
|
||||||
|
case FMOD_ERR_SUBSOUND_CANTMOVE: return "Shared subsounds cannot be replaced or moved from their parent stream, such as when the parent stream is an FSB file. ";
|
||||||
|
case FMOD_ERR_SUBSOUND_MODE: return "The subsound's mode bits do not match with the parent sound's mode bits. See documentation for function that it was called with. ";
|
||||||
|
case FMOD_ERR_TAGNOTFOUND: return "The specified tag could not be found or there are no tags. ";
|
||||||
|
case FMOD_ERR_TOOMANYCHANNELS: return "The sound created exceeds the allowable input channel count. This can be increased using the maxinputchannels parameter in System::setSoftwareFormat. ";
|
||||||
|
case FMOD_ERR_UNIMPLEMENTED: return "Something in FMOD hasn't been implemented when it should be! contact support! ";
|
||||||
|
case FMOD_ERR_UNINITIALIZED: return "This command failed because System::init or System::setDriver was not called. ";
|
||||||
|
case FMOD_ERR_UNSUPPORTED: return "A command issued was not supported by this object. Possibly a plugin without certain callbacks specified. ";
|
||||||
|
case FMOD_ERR_UPDATE: return "An error caused by System::update occured. ";
|
||||||
|
case FMOD_ERR_VERSION: return "The version number of this file format is not supported. ";
|
||||||
|
case FMOD_OK: return "No errors.";
|
||||||
|
default : return "Unknown error.";
|
||||||
|
/*$ preserve start $*/
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
||||||
|
/*$ preserve end $*/
|
201
fmodex/inc/fmod_memoryinfo.h
Normal file
201
fmodex/inc/fmod_memoryinfo.h
Normal file
|
@ -0,0 +1,201 @@
|
||||||
|
/* ============================================================================================= */
|
||||||
|
/* FMOD Ex - Memory info header file. Copyright (c), Firelight Technologies Pty, Ltd. 2008-2016. */
|
||||||
|
/* */
|
||||||
|
/* Use this header if you are interested in getting detailed information on FMOD's memory */
|
||||||
|
/* usage. See the documentation for more details. */
|
||||||
|
/* */
|
||||||
|
/* ============================================================================================= */
|
||||||
|
|
||||||
|
#ifndef _FMOD_MEMORYINFO_H
|
||||||
|
#define _FMOD_MEMORYINFO_H
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Structure to be filled with detailed memory usage information of an FMOD object
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Every public FMOD class has a getMemoryInfo function which can be used to get detailed information on what memory resources are associated with the object in question.
|
||||||
|
On return from getMemoryInfo, each member of this structure will hold the amount of memory used for its type in bytes.<br>
|
||||||
|
<br>
|
||||||
|
Members marked with [in] mean the user sets the value before passing it to the function.<br>
|
||||||
|
Members marked with [out] mean FMOD sets the value to be used after the function exits.<br>
|
||||||
|
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
System::getMemoryInfo
|
||||||
|
EventSystem::getMemoryInfo
|
||||||
|
FMOD_MEMBITS
|
||||||
|
FMOD_EVENT_MEMBITS
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef struct FMOD_MEMORY_USAGE_DETAILS
|
||||||
|
{
|
||||||
|
unsigned int other; /* [out] Memory not accounted for by other types */
|
||||||
|
unsigned int string; /* [out] String data */
|
||||||
|
unsigned int system; /* [out] System object and various internals */
|
||||||
|
unsigned int plugins; /* [out] Plugin objects and internals */
|
||||||
|
unsigned int output; /* [out] Output module object and internals */
|
||||||
|
unsigned int channel; /* [out] Channel related memory */
|
||||||
|
unsigned int channelgroup; /* [out] ChannelGroup objects and internals */
|
||||||
|
unsigned int codec; /* [out] Codecs allocated for streaming */
|
||||||
|
unsigned int file; /* [out] File buffers and structures */
|
||||||
|
unsigned int sound; /* [out] Sound objects and internals */
|
||||||
|
unsigned int secondaryram; /* [out] Sound data stored in secondary RAM */
|
||||||
|
unsigned int soundgroup; /* [out] SoundGroup objects and internals */
|
||||||
|
unsigned int streambuffer; /* [out] Stream buffer memory */
|
||||||
|
unsigned int dspconnection; /* [out] DSPConnection objects and internals */
|
||||||
|
unsigned int dsp; /* [out] DSP implementation objects */
|
||||||
|
unsigned int dspcodec; /* [out] Realtime file format decoding DSP objects */
|
||||||
|
unsigned int profile; /* [out] Profiler memory footprint. */
|
||||||
|
unsigned int recordbuffer; /* [out] Buffer used to store recorded data from microphone */
|
||||||
|
unsigned int reverb; /* [out] Reverb implementation objects */
|
||||||
|
unsigned int reverbchannelprops; /* [out] Reverb channel properties structs */
|
||||||
|
unsigned int geometry; /* [out] Geometry objects and internals */
|
||||||
|
unsigned int syncpoint; /* [out] Sync point memory. */
|
||||||
|
unsigned int eventsystem; /* [out] EventSystem and various internals */
|
||||||
|
unsigned int musicsystem; /* [out] MusicSystem and various internals */
|
||||||
|
unsigned int fev; /* [out] Definition of objects contained in all loaded projects e.g. events, groups, categories */
|
||||||
|
unsigned int memoryfsb; /* [out] Data loaded with preloadFSB */
|
||||||
|
unsigned int eventproject; /* [out] EventProject objects and internals */
|
||||||
|
unsigned int eventgroupi; /* [out] EventGroup objects and internals */
|
||||||
|
unsigned int soundbankclass; /* [out] Objects used to manage wave banks */
|
||||||
|
unsigned int soundbanklist; /* [out] Data used to manage lists of wave bank usage */
|
||||||
|
unsigned int streaminstance; /* [out] Stream objects and internals */
|
||||||
|
unsigned int sounddefclass; /* [out] Sound definition objects */
|
||||||
|
unsigned int sounddefdefclass; /* [out] Sound definition static data objects */
|
||||||
|
unsigned int sounddefpool; /* [out] Sound definition pool data */
|
||||||
|
unsigned int reverbdef; /* [out] Reverb definition objects */
|
||||||
|
unsigned int eventreverb; /* [out] Reverb objects */
|
||||||
|
unsigned int userproperty; /* [out] User property objects */
|
||||||
|
unsigned int eventinstance; /* [out] Event instance base objects */
|
||||||
|
unsigned int eventinstance_complex; /* [out] Complex event instance objects */
|
||||||
|
unsigned int eventinstance_simple; /* [out] Simple event instance objects */
|
||||||
|
unsigned int eventinstance_layer; /* [out] Event layer instance objects */
|
||||||
|
unsigned int eventinstance_sound; /* [out] Event sound instance objects */
|
||||||
|
unsigned int eventenvelope; /* [out] Event envelope objects */
|
||||||
|
unsigned int eventenvelopedef; /* [out] Event envelope definition objects */
|
||||||
|
unsigned int eventparameter; /* [out] Event parameter objects */
|
||||||
|
unsigned int eventcategory; /* [out] Event category objects */
|
||||||
|
unsigned int eventenvelopepoint; /* [out] Event envelope point objects */
|
||||||
|
unsigned int eventinstancepool; /* [out] Event instance pool memory */
|
||||||
|
} FMOD_MEMORY_USAGE_DETAILS;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[DEFINE]
|
||||||
|
[
|
||||||
|
[NAME]
|
||||||
|
FMOD_MEMBITS
|
||||||
|
|
||||||
|
[DESCRIPTION]
|
||||||
|
Bitfield used to request specific memory usage information from the getMemoryInfo function of every public FMOD Ex class.
|
||||||
|
Use with the "memorybits" parameter of getMemoryInfo to get information on FMOD Ex memory usage.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Every public FMOD class has a getMemoryInfo function which can be used to get detailed information on what memory resources are associated with the object in question.
|
||||||
|
The FMOD_MEMBITS defines can be OR'd together to specify precisely what memory usage you'd like to get information on. See System::getMemoryInfo for an example.
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_EVENT_MEMBITS
|
||||||
|
System::getMemoryInfo
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
#define FMOD_MEMBITS_OTHER 0x00000001 /* Memory not accounted for by other types */
|
||||||
|
#define FMOD_MEMBITS_STRING 0x00000002 /* String data */
|
||||||
|
|
||||||
|
#define FMOD_MEMBITS_SYSTEM 0x00000004 /* System object and various internals */
|
||||||
|
#define FMOD_MEMBITS_PLUGINS 0x00000008 /* Plugin objects and internals */
|
||||||
|
#define FMOD_MEMBITS_OUTPUT 0x00000010 /* Output module object and internals */
|
||||||
|
#define FMOD_MEMBITS_CHANNEL 0x00000020 /* Channel related memory */
|
||||||
|
#define FMOD_MEMBITS_CHANNELGROUP 0x00000040 /* ChannelGroup objects and internals */
|
||||||
|
#define FMOD_MEMBITS_CODEC 0x00000080 /* Codecs allocated for streaming */
|
||||||
|
#define FMOD_MEMBITS_FILE 0x00000100 /* Codecs allocated for streaming */
|
||||||
|
#define FMOD_MEMBITS_SOUND 0x00000200 /* Sound objects and internals */
|
||||||
|
#define FMOD_MEMBITS_SOUND_SECONDARYRAM 0x00000400 /* Sound data stored in secondary RAM */
|
||||||
|
#define FMOD_MEMBITS_SOUNDGROUP 0x00000800 /* SoundGroup objects and internals */
|
||||||
|
#define FMOD_MEMBITS_STREAMBUFFER 0x00001000 /* Stream buffer memory */
|
||||||
|
#define FMOD_MEMBITS_DSPCONNECTION 0x00002000 /* DSPConnection objects and internals */
|
||||||
|
#define FMOD_MEMBITS_DSP 0x00004000 /* DSP implementation objects */
|
||||||
|
#define FMOD_MEMBITS_DSPCODEC 0x00008000 /* Realtime file format decoding DSP objects */
|
||||||
|
#define FMOD_MEMBITS_PROFILE 0x00010000 /* Profiler memory footprint. */
|
||||||
|
#define FMOD_MEMBITS_RECORDBUFFER 0x00020000 /* Buffer used to store recorded data from microphone */
|
||||||
|
#define FMOD_MEMBITS_REVERB 0x00040000 /* Reverb implementation objects */
|
||||||
|
#define FMOD_MEMBITS_REVERBCHANNELPROPS 0x00080000 /* Reverb channel properties structs */
|
||||||
|
#define FMOD_MEMBITS_GEOMETRY 0x00100000 /* Geometry objects and internals */
|
||||||
|
#define FMOD_MEMBITS_SYNCPOINT 0x00200000 /* Sync point memory. */
|
||||||
|
#define FMOD_MEMBITS_ALL 0xffffffff /* All memory used by FMOD Ex */
|
||||||
|
/* [DEFINE_END] */
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[DEFINE]
|
||||||
|
[
|
||||||
|
[NAME]
|
||||||
|
FMOD_EVENT_MEMBITS
|
||||||
|
|
||||||
|
[DESCRIPTION]
|
||||||
|
Bitfield used to request specific memory usage information from the getMemoryInfo function of every public FMOD Event System class.
|
||||||
|
Use with the "event_memorybits" parameter of getMemoryInfo to get information on FMOD Event System memory usage.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Every public FMOD Event System class has a getMemoryInfo function which can be used to get detailed information on what memory resources are associated with the object in question.
|
||||||
|
The FMOD_EVENT_MEMBITS defines can be OR'd together to specify precisely what memory usage you'd like to get information on. See EventSystem::getMemoryInfo for an example.
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_MEMBITS
|
||||||
|
System::getMemoryInfo
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTSYSTEM 0x00000001 /* EventSystem and various internals */
|
||||||
|
#define FMOD_EVENT_MEMBITS_MUSICSYSTEM 0x00000002 /* MusicSystem and various internals */
|
||||||
|
#define FMOD_EVENT_MEMBITS_FEV 0x00000004 /* Definition of objects contained in all loaded projects e.g. events, groups, categories */
|
||||||
|
#define FMOD_EVENT_MEMBITS_MEMORYFSB 0x00000008 /* Data loaded with preloadFSB */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTPROJECT 0x00000010 /* EventProject objects and internals */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTGROUPI 0x00000020 /* EventGroup objects and internals */
|
||||||
|
#define FMOD_EVENT_MEMBITS_SOUNDBANKCLASS 0x00000040 /* Objects used to manage wave banks */
|
||||||
|
#define FMOD_EVENT_MEMBITS_SOUNDBANKLIST 0x00000080 /* Data used to manage lists of wave bank usage */
|
||||||
|
#define FMOD_EVENT_MEMBITS_STREAMINSTANCE 0x00000100 /* Stream objects and internals */
|
||||||
|
#define FMOD_EVENT_MEMBITS_SOUNDDEFCLASS 0x00000200 /* Sound definition objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_SOUNDDEFDEFCLASS 0x00000400 /* Sound definition static data objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_SOUNDDEFPOOL 0x00000800 /* Sound definition pool data */
|
||||||
|
#define FMOD_EVENT_MEMBITS_REVERBDEF 0x00001000 /* Reverb definition objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTREVERB 0x00002000 /* Reverb objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_USERPROPERTY 0x00004000 /* User property objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCE 0x00008000 /* Event instance base objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCE_COMPLEX 0x00010000 /* Complex event instance objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCE_SIMPLE 0x00020000 /* Simple event instance objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCE_LAYER 0x00040000 /* Event layer instance objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCE_SOUND 0x00080000 /* Event sound instance objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTENVELOPE 0x00100000 /* Event envelope objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTENVELOPEDEF 0x00200000 /* Event envelope definition objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTPARAMETER 0x00400000 /* Event parameter objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTCATEGORY 0x00800000 /* Event category objects */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTENVELOPEPOINT 0x01000000 /* Event envelope point object+s */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCEPOOL 0x02000000 /* Event instance pool data */
|
||||||
|
#define FMOD_EVENT_MEMBITS_ALL 0xffffffff /* All memory used by FMOD Event System */
|
||||||
|
|
||||||
|
/* All event instance memory */
|
||||||
|
#define FMOD_EVENT_MEMBITS_EVENTINSTANCE_GROUP (FMOD_EVENT_MEMBITS_EVENTINSTANCE | \
|
||||||
|
FMOD_EVENT_MEMBITS_EVENTINSTANCE_COMPLEX | \
|
||||||
|
FMOD_EVENT_MEMBITS_EVENTINSTANCE_SIMPLE | \
|
||||||
|
FMOD_EVENT_MEMBITS_EVENTINSTANCE_LAYER | \
|
||||||
|
FMOD_EVENT_MEMBITS_EVENTINSTANCE_SOUND)
|
||||||
|
|
||||||
|
/* All sound definition memory */
|
||||||
|
#define FMOD_EVENT_MEMBITS_SOUNDDEF_GROUP (FMOD_EVENT_MEMBITS_SOUNDDEFCLASS | \
|
||||||
|
FMOD_EVENT_MEMBITS_SOUNDDEFDEFCLASS | \
|
||||||
|
FMOD_EVENT_MEMBITS_SOUNDDEFPOOL)
|
||||||
|
/* [DEFINE_END] */
|
||||||
|
|
||||||
|
#endif
|
93
fmodex/inc/fmod_output.h
Normal file
93
fmodex/inc/fmod_output.h
Normal file
|
@ -0,0 +1,93 @@
|
||||||
|
/* ==================================================================================================== */
|
||||||
|
/* FMOD Ex - output development header file. Copyright (c), Firelight Technologies Pty, Ltd. 2004-2016. */
|
||||||
|
/* */
|
||||||
|
/* Use this header if you are wanting to develop your own output plugin to use with */
|
||||||
|
/* FMOD's output system. With this header you can make your own output plugin that FMOD */
|
||||||
|
/* can register and use. See the documentation and examples on how to make a working plugin. */
|
||||||
|
/* */
|
||||||
|
/* ==================================================================================================== */
|
||||||
|
|
||||||
|
#ifndef _FMOD_OUTPUT_H
|
||||||
|
#define _FMOD_OUTPUT_H
|
||||||
|
|
||||||
|
#include "fmod.h"
|
||||||
|
|
||||||
|
typedef struct FMOD_OUTPUT_STATE FMOD_OUTPUT_STATE;
|
||||||
|
|
||||||
|
/*
|
||||||
|
Output callbacks
|
||||||
|
*/
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_GETNUMDRIVERSCALLBACK)(FMOD_OUTPUT_STATE *output_state, int *numdrivers);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_GETDRIVERNAMECALLBACK)(FMOD_OUTPUT_STATE *output_state, int id, char *name, int namelen);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_GETDRIVERCAPSCALLBACK)(FMOD_OUTPUT_STATE *output_state, int id, FMOD_CAPS *caps);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_INITCALLBACK) (FMOD_OUTPUT_STATE *output_state, int selecteddriver, FMOD_INITFLAGS flags, int *outputrate, int outputchannels, FMOD_SOUND_FORMAT *outputformat, int dspbufferlength, int dspnumbuffers, void *extradriverdata);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_CLOSECALLBACK) (FMOD_OUTPUT_STATE *output_state);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_UPDATECALLBACK) (FMOD_OUTPUT_STATE *output_state);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_GETHANDLECALLBACK) (FMOD_OUTPUT_STATE *output_state, void **handle);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_GETPOSITIONCALLBACK) (FMOD_OUTPUT_STATE *output_state, unsigned int *pcm);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_LOCKCALLBACK) (FMOD_OUTPUT_STATE *output_state, unsigned int offset, unsigned int length, void **ptr1, void **ptr2, unsigned int *len1, unsigned int *len2);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_UNLOCKCALLBACK) (FMOD_OUTPUT_STATE *output_state, void *ptr1, void *ptr2, unsigned int len1, unsigned int len2);
|
||||||
|
typedef FMOD_RESULT (F_CALLBACK *FMOD_OUTPUT_READFROMMIXER) (FMOD_OUTPUT_STATE *output_state, void *buffer, unsigned int length);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
When creating an output, declare one of these and provide the relevant callbacks and name for FMOD to use when it opens and reads a file of this type.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [in] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
Members marked with [out] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_OUTPUT_STATE
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
typedef struct FMOD_OUTPUT_DESCRIPTION
|
||||||
|
{
|
||||||
|
const char *name; /* [in] Name of the output. */
|
||||||
|
unsigned int version; /* [in] Plugin writer's version number. */
|
||||||
|
int polling; /* [in] If TRUE (non zero), this tells FMOD to start a thread and call getposition / lock / unlock for feeding data. If 0, the output is probably callback based, so all the plugin needs to do is call readfrommixer to the appropriate pointer. */
|
||||||
|
FMOD_OUTPUT_GETNUMDRIVERSCALLBACK getnumdrivers; /* [in] For sound device enumeration. This callback is to give System::getNumDrivers somthing to return. */
|
||||||
|
FMOD_OUTPUT_GETDRIVERNAMECALLBACK getdrivername; /* [in] For sound device enumeration. This callback is to give System::getDriverName somthing to return. */
|
||||||
|
FMOD_OUTPUT_GETDRIVERCAPSCALLBACK getdrivercaps; /* [in] For sound device enumeration. This callback is to give System::getDriverCaps somthing to return. */
|
||||||
|
FMOD_OUTPUT_INITCALLBACK init; /* [in] Initialization function for the output device. This is called from System::init. */
|
||||||
|
FMOD_OUTPUT_CLOSECALLBACK close; /* [in] Cleanup / close down function for the output device. This is called from System::close. */
|
||||||
|
FMOD_OUTPUT_UPDATECALLBACK update; /* [in] Update function that is called once a frame by the user. This is called from System::update. */
|
||||||
|
FMOD_OUTPUT_GETHANDLECALLBACK gethandle; /* [in] This is called from System::getOutputHandle. This is just to return a pointer to the internal system device object that the system may be using.*/
|
||||||
|
FMOD_OUTPUT_GETPOSITIONCALLBACK getposition; /* [in] This is called from the FMOD software mixer thread if 'polling' = true. This returns a position value in samples so that FMOD knows where and when to fill its buffer. */
|
||||||
|
FMOD_OUTPUT_LOCKCALLBACK lock; /* [in] This is called from the FMOD software mixer thread if 'polling' = true. This function provides a pointer to data that FMOD can write to when software mixing. */
|
||||||
|
FMOD_OUTPUT_UNLOCKCALLBACK unlock; /* [in] This is called from the FMOD software mixer thread if 'polling' = true. This optional function accepts the data that has been mixed and copies it or does whatever it needs to before sending it to the hardware. */
|
||||||
|
} FMOD_OUTPUT_DESCRIPTION;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
[STRUCTURE]
|
||||||
|
[
|
||||||
|
[DESCRIPTION]
|
||||||
|
Output plugin structure that is passed into each callback.
|
||||||
|
|
||||||
|
[REMARKS]
|
||||||
|
Members marked with [in] mean the variable can be written to. The user can set the value.<br>
|
||||||
|
Members marked with [out] mean the variable is modified by FMOD and is for reading purposes only. Do not change this value.<br>
|
||||||
|
|
||||||
|
[PLATFORMS]
|
||||||
|
Win32, Win64, Linux, Linux64, Macintosh, Xbox360, PlayStation Portable, PlayStation 3, Wii, iPhone, 3GS, NGP, Android
|
||||||
|
|
||||||
|
[SEE_ALSO]
|
||||||
|
FMOD_OUTPUT_DESCRIPTION
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
struct FMOD_OUTPUT_STATE
|
||||||
|
{
|
||||||
|
void *plugindata; /* [in] Plugin writer created data the output author wants to attach to this object. */
|
||||||
|
FMOD_OUTPUT_READFROMMIXER readfrommixer; /* [out] Function to update mixer and write the result to the provided pointer. Used from callback based output only. Polling based output uses lock/unlock/getposition. */
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
BIN
fmodex/lib/libfmodex.dylib
Normal file
BIN
fmodex/lib/libfmodex.dylib
Normal file
Binary file not shown.
Loading…
Reference in a new issue