开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 图形图像 > OpenGL > 查看源码
Fmod.h
资源名称：OpenGL动画演示(包含代码).rar　[点击查看]
上传用户：sz83729876
上传日期：2013-03-07
资源大小：4140k
文件大小：63k
源码类别：

OpenGL

开发平台：

Windows_Unix

Fmod.h：源码内容
  1. /* ========================================================================================== */
  2. /* FMOD Main header file. Copyright (c), Firelight Technologies Pty, Ltd 1999-2002.           */
  3. /* ========================================================================================== */
  5. #ifndef _FMOD_H_
  6. #define _FMOD_H_
  8. /* ========================================================================================== */
  9. /* DEFINITIONS                                                                                */
  10. /* ========================================================================================== */
  12. #if (!defined(WIN32) && !defined(__WIN32__) && !defined(_WIN32_WCE)) || (defined(__GNUC__) && defined(WIN32))
  13.     #ifndef _cdecl
  14.         #define _cdecl 
  15.     #endif
  16.     #ifndef _stdcall
  17.         #define _stdcall
  18.     #endif
  19. #endif 
  21. #define F_API _stdcall
  22. #define F_CALLBACKAPI _cdecl
  24. #ifdef DLL_EXPORTS
  25.     #define DLL_API __declspec(dllexport)
  26. #else
  27.     #if defined(__LCC__) || defined(__MINGW32__) || defined(__CYGWIN32__)
  28.         #define DLL_API F_API
  29.     #else
  30.         #define DLL_API
  31.     #endif /* __LCC__ ||  __MINGW32__ || __CYGWIN32__ */
  32. #endif /* DLL_EXPORTS */
  34. #define FMOD_VERSION    3.61f
  36. /* 
  37.     FMOD defined types 
  38. */
  39. typedef struct FSOUND_SAMPLE    FSOUND_SAMPLE;
  40. typedef struct FSOUND_STREAM    FSOUND_STREAM;
  41. typedef struct FSOUND_DSPUNIT   FSOUND_DSPUNIT;
  42. typedef struct FMUSIC_MODULE    FMUSIC_MODULE;
  44. /* 
  45.     Callback types
  46. */
  47. typedef void *      (F_CALLBACKAPI *FSOUND_DSPCALLBACK)    (void *originalbuffer, void *newbuffer, int length, int param);
  48. typedef signed char (F_CALLBACKAPI *FSOUND_STREAMCALLBACK) (FSOUND_STREAM *stream, void *buff, int len, int param);
  49. typedef void        (F_CALLBACKAPI *FMUSIC_CALLBACK)       (FMUSIC_MODULE *mod, unsigned char param);
  51. typedef unsigned int(F_CALLBACKAPI *FSOUND_OPENCALLBACK)   (const char *name);
  52. typedef void        (F_CALLBACKAPI *FSOUND_CLOSECALLBACK)  (unsigned int handle);
  53. typedef int         (F_CALLBACKAPI *FSOUND_READCALLBACK)   (void *buffer, int size, unsigned int handle);
  54. typedef int         (F_CALLBACKAPI *FSOUND_SEEKCALLBACK)   (unsigned int handle, int pos, signed char mode);
  55. typedef int         (F_CALLBACKAPI *FSOUND_TELLCALLBACK)   (unsigned int handle);
  57. typedef void *      (F_CALLBACKAPI *FSOUND_ALLOCCALLBACK)  (unsigned int size);
  58. typedef void *      (F_CALLBACKAPI *FSOUND_REALLOCCALLBACK)(void *ptr, unsigned int size);
  59. typedef void        (F_CALLBACKAPI *FSOUND_FREECALLBACK)   (void *ptr);
  62. /*
  63. [ENUM]
  64. [
  65.     [DESCRIPTION]   
  66.     On failure of commands in FMOD, use FSOUND_GetError to attain what happened.
  67.     
  68.     [SEE_ALSO]      
  69.     FSOUND_GetError
  70. ]
  71. */
  72. enum FMOD_ERRORS 
  73. {
  74.     FMOD_ERR_NONE,             /* No errors */
  75.     FMOD_ERR_BUSY,             /* Cannot call this command after FSOUND_Init.  Call FSOUND_Close first. */
  76.     FMOD_ERR_UNINITIALIZED,    /* This command failed because FSOUND_Init or FSOUND_SetOutput was not called */
  77.     FMOD_ERR_INIT,             /* Error initializing output device. */
  78.     FMOD_ERR_ALLOCATED,        /* Error initializing output device, but more specifically, the output device is already in use and cannot be reused. */
  79.     FMOD_ERR_PLAY,             /* Playing the sound failed. */
  80.     FMOD_ERR_OUTPUT_FORMAT,    /* Soundcard does not support the features needed for this soundsystem (16bit stereo output) */
  81.     FMOD_ERR_COOPERATIVELEVEL, /* Error setting cooperative level for hardware. */
  82.     FMOD_ERR_CREATEBUFFER,     /* Error creating hardware sound buffer. */
  83.     FMOD_ERR_FILE_NOTFOUND,    /* File not found */
  84.     FMOD_ERR_FILE_FORMAT,      /* Unknown file format */
  85.     FMOD_ERR_FILE_BAD,         /* Error loading file */
  86.     FMOD_ERR_MEMORY,           /* Not enough memory or resources */
  87.     FMOD_ERR_VERSION,          /* The version number of this file format is not supported */
  88.     FMOD_ERR_INVALID_PARAM,    /* An invalid parameter was passed to this function */
  89.     FMOD_ERR_NO_EAX,           /* Tried to use an EAX command on a non EAX enabled channel or output. */
  90.     FMOD_ERR_CHANNEL_ALLOC,    /* Failed to allocate a new channel */
  91.     FMOD_ERR_RECORD,           /* Recording is not supported on this machine */
  92.     FMOD_ERR_MEDIAPLAYER,      /* Windows Media Player not installed so cannot play wma or use internet streaming. */
  93.     FMOD_ERR_CDDEVICE          /* An error occured trying to open the specified CD device */
  94. };
  97. /*
  98. [ENUM]
  99. [
  100.     [DESCRIPTION]   
  101.     These output types are used with FSOUND_SetOutput, to choose which output driver to use.
  102.     
  103.     FSOUND_OUTPUT_DSOUND will not support hardware 3d acceleration if the sound card driver 
  104.     does not support DirectX 6 Voice Manager Extensions.
  106.     FSOUND_OUTPUT_WINMM is recommended for NT and CE.
  108.     [SEE_ALSO]      
  109.     FSOUND_SetOutput
  110.     FSOUND_GetOutput
  111. ]
  112. */
  113. enum FSOUND_OUTPUTTYPES
  114. {
  115.     FSOUND_OUTPUT_NOSOUND,    /* NoSound driver, all calls to this succeed but do nothing. */
  116.     FSOUND_OUTPUT_WINMM,      /* Windows Multimedia driver. */
  117.     FSOUND_OUTPUT_DSOUND,     /* DirectSound driver.  You need this to get EAX2 or EAX3 support, or FX api support. */
  118.     FSOUND_OUTPUT_A3D,        /* A3D driver. */
  120.     FSOUND_OUTPUT_OSS,        /* Linux/Unix OSS (Open Sound System) driver, i.e. the kernel sound drivers. */
  121.     FSOUND_OUTPUT_ESD,        /* Linux/Unix ESD (Enlightment Sound Daemon) driver. */
  122.     FSOUND_OUTPUT_ALSA,       /* Linux Alsa driver. */
  124.     FSOUND_OUTPUT_ASIO,       /* Low latency ASIO driver */
  125.     FSOUND_OUTPUT_XBOX,       /* Xbox driver */
  126.     FSOUND_OUTPUT_PS2,        /* PlayStation 2 driver */
  127.     FSOUND_OUTPUT_MAC,        /* Mac SoundManager driver */
  128.     FSOUND_OUTPUT_GC,         /* Gamecube driver */
  130.     FSOUND_OUTPUT_NOSOUND_NONREALTIME   /* This is the same as nosound, but the sound generation is driven by FSOUND_Update */
  131. };
  134. /*
  135. [ENUM]
  136. [
  137.     [DESCRIPTION]   
  138.     These mixer types are used with FSOUND_SetMixer, to choose which mixer to use, or to act 
  139.     upon for other reasons using FSOUND_GetMixer.
  140.     It is not nescessary to set the mixer.  FMOD will autodetect the best mixer for you.
  142.     [SEE_ALSO]      
  143.     FSOUND_SetMixer
  144.     FSOUND_GetMixer
  145. ]
  146. */
  147. enum FSOUND_MIXERTYPES
  148. {
  149.     FSOUND_MIXER_AUTODETECT,        /* CE/PS2/GC Only - Non interpolating/low quality mixer. */
  150.     FSOUND_MIXER_BLENDMODE,         /* Removed / obsolete. */
  151.     FSOUND_MIXER_MMXP5,             /* Removed / obsolete. */
  152.     FSOUND_MIXER_MMXP6,             /* Removed / obsolete. */
  154.     FSOUND_MIXER_QUALITY_AUTODETECT,/* All platforms - Autodetect the fastest quality mixer based on your cpu. */
  155.     FSOUND_MIXER_QUALITY_FPU,       /* Win32/Linux only - Interpolating/volume ramping FPU mixer.  */
  156.     FSOUND_MIXER_QUALITY_MMXP5,     /* Win32/Linux only - Interpolating/volume ramping P5 MMX mixer.  */
  157.     FSOUND_MIXER_QUALITY_MMXP6,     /* Win32/Linux only - Interpolating/volume ramping ppro+ MMX mixer. */
  159.     FSOUND_MIXER_MONO,              /* CE/PS2/GC only - MONO non interpolating/low quality mixer. For speed*/
  160.     FSOUND_MIXER_QUALITY_MONO,      /* CE/PS2/GC only - MONO Interpolating mixer.  For speed */
  162.     FSOUND_MIXER_MAX
  163. };
  166. /*
  167. [ENUM]
  168. [
  169.     [DESCRIPTION]   
  170.     These definitions describe the type of song being played.
  172.     [SEE_ALSO]      
  173.     FMUSIC_GetType  
  174. ]
  175. */
  176. enum FMUSIC_TYPES
  177. {
  178.     FMUSIC_TYPE_NONE,       
  179.     FMUSIC_TYPE_MOD,        /* Protracker / Fasttracker */
  180.     FMUSIC_TYPE_S3M,        /* ScreamTracker 3 */
  181.     FMUSIC_TYPE_XM,         /* FastTracker 2 */
  182.     FMUSIC_TYPE_IT,         /* Impulse Tracker. */
  183.     FMUSIC_TYPE_MIDI        /* MIDI file */
  184. };
  187. /*
  188. [DEFINE_START] 
  189. [
  190.     [NAME] 
  191.     FSOUND_DSP_PRIORITIES
  193.     [DESCRIPTION]   
  194.     These default priorities are used by FMOD internal system DSP units.  They describe the 
  195.     position of the DSP chain, and the order of how audio processing is executed.
  196.     You can actually through the use of FSOUND_DSP_GetxxxUnit (where xxx is the name of the DSP
  197.     unit), disable or even change the priority of a DSP unit.
  199.     [SEE_ALSO]      
  200.     FSOUND_DSP_Create
  201.     FSOUND_DSP_SetPriority
  202.     FSOUND_DSP_GetSpectrum
  203. ]
  204. */
  205. #define FSOUND_DSP_DEFAULTPRIORITY_CLEARUNIT        0       /* DSP CLEAR unit - done first */
  206. #define FSOUND_DSP_DEFAULTPRIORITY_SFXUNIT          100     /* DSP SFX unit - done second */
  207. #define FSOUND_DSP_DEFAULTPRIORITY_MUSICUNIT        200     /* DSP MUSIC unit - done third */
  208. #define FSOUND_DSP_DEFAULTPRIORITY_USER             300     /* User priority, use this as reference */
  209. #define FSOUND_DSP_DEFAULTPRIORITY_FFTUNIT          900     /* This reads data for FSOUND_DSP_GetSpectrum, so it comes after user units */
  210. #define FSOUND_DSP_DEFAULTPRIORITY_CLIPANDCOPYUNIT  1000    /* DSP CLIP AND COPY unit - last */
  211. /* [DEFINE_END] */
  214. /*
  215. [DEFINE_START] 
  216. [
  217.     [NAME] 
  218.     FSOUND_CAPS
  220.     [DESCRIPTION]   
  221.     Driver description bitfields.  Use FSOUND_Driver_GetCaps to determine if a driver enumerated
  222.     has the settings you are after.  The enumerated driver depends on the output mode, see
  223.     FSOUND_OUTPUTTYPES
  225.     [SEE_ALSO]
  226.     FSOUND_GetDriverCaps
  227.     FSOUND_OUTPUTTYPES
  228. ]
  229. */
  230. #define FSOUND_CAPS_HARDWARE                0x1     /* This driver supports hardware accelerated 3d sound. */
  231. #define FSOUND_CAPS_EAX2                    0x2     /* This driver supports EAX 2 reverb */
  232. #define FSOUND_CAPS_EAX3                    0x10    /* This driver supports EAX 3 reverb */
  233. /* [DEFINE_END] */
  236. /*
  237. [DEFINE_START] 
  238. [
  239.     [NAME] 
  240.     FSOUND_MODES
  241.     
  242.     [DESCRIPTION]   
  243.     Sample description bitfields, OR them together for loading and describing samples.
  244.     NOTE.  If the file format being loaded already has a defined format, such as WAV or MP3, then 
  245.     trying to override the pre-defined format with a new set of format flags will not work.  For
  246.     example, an 8 bit WAV file will not load as 16bit if you specify FSOUND_16BITS.  It will just
  247.     ignore the flag and go ahead loading it as 8bits.  For these type of formats the only flags
  248.     you can specify that will really alter the behaviour of how it is loaded, are the following.
  250.     FSOUND_LOOP_OFF     
  251.     FSOUND_LOOP_NORMAL  
  252.     FSOUND_LOOP_BIDI    
  253.     FSOUND_HW3D
  254.     FSOUND_2D
  255.     FSOUND_STREAMABLE   
  256.     FSOUND_LOADMEMORY   
  257.     FSOUND_LOADRAW          
  258.     FSOUND_MPEGACCURATE     
  260.     See flag descriptions for what these do.
  261. ]
  262. */
  263. #define FSOUND_LOOP_OFF     0x00000001  /* For non looping samples. */
  264. #define FSOUND_LOOP_NORMAL  0x00000002  /* For forward looping samples. */
  265. #define FSOUND_LOOP_BIDI    0x00000004  /* For bidirectional looping samples.  (no effect if in hardware). */
  266. #define FSOUND_8BITS        0x00000008  /* For 8 bit samples. */
  267. #define FSOUND_16BITS       0x00000010  /* For 16 bit samples. */
  268. #define FSOUND_MONO         0x00000020  /* For mono samples. */
  269. #define FSOUND_STEREO       0x00000040  /* For stereo samples. */
  270. #define FSOUND_UNSIGNED     0x00000080  /* For user created source data containing unsigned samples. */
  271. #define FSOUND_SIGNED       0x00000100  /* For user created source data containing signed data. */
  272. #define FSOUND_DELTA        0x00000200  /* For user created source data stored as delta values. */
  273. #define FSOUND_IT214        0x00000400  /* For user created source data stored using IT214 compression. */
  274. #define FSOUND_IT215        0x00000800  /* For user created source data stored using IT215 compression. */
  275. #define FSOUND_HW3D         0x00001000  /* Attempts to make samples use 3d hardware acceleration. (if the card supports it) */
  276. #define FSOUND_2D           0x00002000  /* Tells software (not hardware) based sample not to be included in 3d processing. */
  277. #define FSOUND_STREAMABLE   0x00004000  /* For a streamimg sound where you feed the data to it. */
  278. #define FSOUND_LOADMEMORY   0x00008000  /* "name" will be interpreted as a pointer to data for streaming and samples. */
  279. #define FSOUND_LOADRAW      0x00010000  /* Will ignore file format and treat as raw pcm. */
  280. #define FSOUND_MPEGACCURATE 0x00020000  /* For FSOUND_Stream_OpenFile - for accurate FSOUND_Stream_GetLengthMs/FSOUND_Stream_SetTime.  WARNING, see FSOUND_Stream_OpenFile for inital opening time performance issues. */
  281. #define FSOUND_FORCEMONO    0x00040000  /* For forcing stereo streams and samples to be mono - needed if using FSOUND_HW3D and stereo data - incurs a small speed hit for streams */
  282. #define FSOUND_HW2D         0x00080000  /* 2D hardware sounds.  allows hardware specific effects */
  283. #define FSOUND_ENABLEFX     0x00100000  /* Allows DX8 FX to be played back on a sound.  Requires DirectX 8 - Note these sounds cannot be played more than once, be 8 bit, be less than a certain size, or have a changing frequency */
  284. #define FSOUND_MPEGHALFRATE 0x00200000  /* For FMODCE only - decodes mpeg streams using a lower quality decode, but faster execution */
  285. #define FSOUND_XADPCM       0x00400000  /* For XBOX only - Contents are compressed as XADPCM  */
  286. #define FSOUND_VAG          0x00800000  /* For PS2 only - Contents are compressed as Sony VAG format */
  287. #define FSOUND_NONBLOCKING  0x01000000  /* For FSOUND_Stream_OpenFile - Causes stream to open in the background and not block the foreground app - stream functions only work when ready.  Poll any stream function determine when it IS ready. */
  288. #define FSOUND_GCADPCM      0x02000000  /* For Gamecube only - Contents are compressed as Gamecube DSP-ADPCM format */
  290. #define FSOUND_NORMAL       (FSOUND_16BITS | FSOUND_SIGNED | FSOUND_MONO)      
  291. /* [DEFINE_END] */
  295. /*
  296. [DEFINE_START] 
  297. [
  298.     [NAME] 
  299.     FSOUND_CDPLAYMODES
  300.     
  301.     [DESCRIPTION]   
  302.     Playback method for a CD Audio track, with FSOUND_CD_SetPlayMode
  304.     [SEE_ALSO]    
  305.     FSOUND_CD_SetPlayMode  
  306.     FSOUND_CD_Play
  307. ]
  308. */
  309. #define FSOUND_CD_PLAYCONTINUOUS    0   /* Starts from the current track and plays to end of CD. */
  310. #define FSOUND_CD_PLAYONCE          1   /* Plays the specified track then stops. */
  311. #define FSOUND_CD_PLAYLOOPED        2   /* Plays the specified track looped, forever until stopped manually. */
  312. #define FSOUND_CD_PLAYRANDOM        3   /* Plays tracks in random order */
  313. /* [DEFINE_END] */
  316. /*
  317. [DEFINE_START] 
  318. [
  319.     [NAME] 
  320.     FSOUND_MISC_VALUES
  321.     
  322.     [DESCRIPTION]
  323.     Miscellaneous values for FMOD functions.
  325.     [SEE_ALSO]
  326.     FSOUND_PlaySound
  327.     FSOUND_PlaySoundEx
  328.     FSOUND_Sample_Alloc
  329.     FSOUND_Sample_Load
  330.     FSOUND_SetPan
  331. ]
  332. */
  333. #define FSOUND_FREE             -1      /* value to play on any free channel, or to allocate a sample in a free sample slot. */
  334. #define FSOUND_UNMANAGED        -2      /* value to allocate a sample that is NOT managed by FSOUND or placed in a sample slot. */
  335. #define FSOUND_ALL              -3      /* for a channel index , this flag will affect ALL channels available!  Not supported by every function. */
  336. #define FSOUND_STEREOPAN        -1      /* value for FSOUND_SetPan so that stereo sounds are not played at half volume.  See FSOUND_SetPan for more on this. */
  337. #define FSOUND_SYSTEMCHANNEL    -1000   /* special 'channel' ID for all channel based functions that want to alter the global FSOUND software mixing output channel */
  338. #define FSOUND_SYSTEMSAMPLE     -1000   /* special 'sample' ID for all sample based functions that want to alter the global FSOUND software mixing output sample */
  340. /* [DEFINE_END] */
  343. /*
  344. [STRUCTURE] 
  345. [
  346.     [DESCRIPTION]
  347.     Structure defining a reverb environment.
  348.     For more indepth descriptions of the reverb properties under win32, please see the EAX2 and EAX3
  349.     documentation at http://developer.creative.com/ under the 'downloads' section.
  350.     If they do not have the EAX3 documentation, then most information can be attained from
  351.     the EAX2 documentation, as EAX3 only adds some more parameters and functionality on top of 
  352.     EAX2.
  353.     Note the default reverb properties are the same as the FSOUND_PRESET_GENERIC preset.
  354.     Note that integer values that typically range from -10,000 to 1000 are represented in 
  355.     decibels, and are of a logarithmic scale, not linear, wheras float values are typically linear.
  356.     PORTABILITY: Each member has the platform it supports in braces ie (win32/xbox).  
  357.     Some reverb parameters are only supported in win32 and some only on xbox. If all parameters are set then
  358.     the reverb should product a similar effect on either platform.
  359.     Only Win32 supports the reverb api.
  360.     
  361.     The numerical values listed below are the maximum, minimum and default values for each variable respectively.
  363.     [SEE_ALSO]
  364.     FSOUND_Reverb_SetProperties
  365.     FSOUND_Reverb_GetProperties
  366.     FSOUND_REVERB_PRESETS
  367.     FSOUND_REVERB_FLAGS
  368. ]
  369. */
  370. typedef struct _FSOUND_REVERB_PROPERTIES /* MIN     MAX    DEFAULT   DESCRIPTION */
  371. {                                   
  372.     unsigned int Environment;            /* 0     , 25    , 0      , sets all listener properties (win32/ps2 only) */
  373.     float        EnvSize;                /* 1.0   , 100.0 , 7.5    , environment size in meters (win32 only) */
  374.     float        EnvDiffusion;           /* 0.0   , 1.0   , 1.0    , environment diffusion (win32/xbox) */
  375.     int          Room;                   /* -10000, 0     , -1000  , room effect level (at mid frequencies) (win32/xbox/ps2) */
  376.     int          RoomHF;                 /* -10000, 0     , -100   , relative room effect level at high frequencies (win32/xbox) */
  377.     int          RoomLF;                 /* -10000, 0     , 0      , relative room effect level at low frequencies (win32 only) */
  378.     float        DecayTime;              /* 0.1   , 20.0  , 1.49   , reverberation decay time at mid frequencies (win32/xbox) */
  379.     float        DecayHFRatio;           /* 0.1   , 2.0   , 0.83   , high-frequency to mid-frequency decay time ratio (win32/xbox) */
  380.     float        DecayLFRatio;           /* 0.1   , 2.0   , 1.0    , low-frequency to mid-frequency decay time ratio (win32 only) */
  381.     int          Reflections;            /* -10000, 1000  , -2602  , early reflections level relative to room effect (win32/xbox) */
  382.     float        ReflectionsDelay;       /* 0.0   , 0.3   , 0.007  , initial reflection delay time (win32/xbox) */
  383.     float        ReflectionsPan[3];      /*       ,       , [0,0,0], early reflections panning vector (win32 only) */
  384.     int          Reverb;                 /* -10000, 2000  , 200    , late reverberation level relative to room effect (win32/xbox) */
  385.     float        ReverbDelay;            /* 0.0   , 0.1   , 0.011  , late reverberation delay time relative to initial reflection (win32/xbox) */
  386.     float        ReverbPan[3];           /*       ,       , [0,0,0], late reverberation panning vector (win32 only) */
  387.     float        EchoTime;               /* .075  , 0.25  , 0.25   , echo time (win32 only) */
  388.     float        EchoDepth;              /* 0.0   , 1.0   , 0.0    , echo depth (win32 only) */
  389.     float        ModulationTime;         /* 0.04  , 4.0   , 0.25   , modulation time (win32 only) */
  390.     float        ModulationDepth;        /* 0.0   , 1.0   , 0.0    , modulation depth (win32 only) */
  391.     float        AirAbsorptionHF;        /* -100  , 0.0   , -5.0   , change in level per meter at high frequencies (win32 only) */
  392.     float        HFReference;            /* 1000.0, 20000 , 5000.0 , reference high frequency (hz) (win32/xbox) */
  393.     float        LFReference;            /* 20.0  , 1000.0, 250.0  , reference low frequency (hz) (win32 only) */
  394.     float        RoomRolloffFactor;      /* 0.0   , 10.0  , 0.0    , like FSOUND_3D_SetRolloffFactor but for room effect (win32/xbox) */
  395.     float        Diffusion;              /* 0.0   , 100.0 , 100.0  , Value that controls the echo density in the late reverberation decay. (xbox only) */
  396.     float        Density;                /* 0.0   , 100.0 , 100.0  , Value that controls the modal density in the late reverberation decay (xbox only) */
  397.     unsigned int Flags;                  /* FSOUND_REVERB_FLAGS - modifies the behavior of above properties (win32 only) */
  398. } FSOUND_REVERB_PROPERTIES;
  401. /*
  402. [DEFINE_START] 
  403. [
  404.     [NAME] 
  405.     FSOUND_REVERB_FLAGS
  406.     
  407.     [DESCRIPTION]
  408.     Values for the Flags member of the FSOUND_REVERB_PROPERTIES structure.
  410.     [SEE_ALSO]
  411.     FSOUND_REVERB_PROPERTIES
  412. ]
  413. */
  414. #define FSOUND_REVERB_FLAGS_DECAYTIMESCALE        0x00000001 /* 'EnvSize' affects reverberation decay time */
  415. #define FSOUND_REVERB_FLAGS_REFLECTIONSSCALE      0x00000002 /* 'EnvSize' affects reflection level */
  416. #define FSOUND_REVERB_FLAGS_REFLECTIONSDELAYSCALE 0x00000004 /* 'EnvSize' affects initial reflection delay time */
  417. #define FSOUND_REVERB_FLAGS_REVERBSCALE           0x00000008 /* 'EnvSize' affects reflections level */
  418. #define FSOUND_REVERB_FLAGS_REVERBDELAYSCALE      0x00000010 /* 'EnvSize' affects late reverberation delay time */
  419. #define FSOUND_REVERB_FLAGS_DECAYHFLIMIT          0x00000020 /* AirAbsorptionHF affects DecayHFRatio */
  420. #define FSOUND_REVERB_FLAGS_ECHOTIMESCALE         0x00000040 /* 'EnvSize' affects echo time */
  421. #define FSOUND_REVERB_FLAGS_MODULATIONTIMESCALE   0x00000080 /* 'EnvSize' affects modulation time */
  422. #define FSOUND_REVERB_FLAGS_CORE0                 0x00000100 /* PS2 Only - Reverb is applied to CORE0 (hw voices 0-23) */
  423. #define FSOUND_REVERB_FLAGS_CORE1                 0x00000200 /* PS2 Only - Reverb is applied to CORE1 (hw voices 24-47) */
  424. #define FSOUND_REVERB_FLAGS_DEFAULT              (FSOUND_REVERB_FLAGS_DECAYTIMESCALE |        
  425.                                                   FSOUND_REVERB_FLAGS_REFLECTIONSSCALE |      
  426.                                                   FSOUND_REVERB_FLAGS_REFLECTIONSDELAYSCALE | 
  427.                                                   FSOUND_REVERB_FLAGS_REVERBSCALE |           
  428.                                                   FSOUND_REVERB_FLAGS_REVERBDELAYSCALE |      
  429.                                                   FSOUND_REVERB_FLAGS_DECAYHFLIMIT |          
  430.                                                   FSOUND_REVERB_FLAGS_CORE0 |                 
  431.                                                   FSOUND_REVERB_FLAGS_CORE1 )
  432. /* [DEFINE_END] */
  437. /*
  438. [DEFINE_START] 
  439. [
  440.     [NAME] 
  441.     FSOUND_REVERB_PRESETS
  442.     
  443.     [DESCRIPTION]   
  444.     A set of predefined environment PARAMETERS, created by Creative Labs
  445.     These are used to initialize an FSOUND_REVERB_PROPERTIES structure statically.
  446.     ie 
  447.     FSOUND_REVERB_PROPERTIES prop = FSOUND_PRESET_GENERIC;
  449.     [SEE_ALSO]
  450.     FSOUND_Reverb_SetProperties
  451. ]
  452. */
  453. /*                                     Env  Size    Diffus  Room   RoomHF  RmLF DecTm   DecHF  DecLF   Refl  RefDel  RefPan               Revb  RevDel  ReverbPan           EchoTm  EchDp  ModTm  ModDp  AirAbs  HFRef    LFRef  RRlOff Diffus  Densty  FLAGS */
  454. #define FSOUND_PRESET_OFF              {0, 7.5f, 1.00f, -10000, -10000, 0,   1.00f,  1.00f, 1.0f,  -2602, 0.007f, { 0.0f,0.0f,0.0f },   200, 0.011f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f,   0.0f,   0.0f, 0x33f }
  455. #define FSOUND_PRESET_GENERIC          {0, 7.5f, 1.00f, -1000,  -100,   0,   1.49f,  0.83f, 1.0f,  -2602, 0.007f, { 0.0f,0.0f,0.0f },   200, 0.011f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  456. #define FSOUND_PRESET_PADDEDCELL       {1, 1.4f, 1.00f, -1000,  -6000,  0,   0.17f,  0.10f, 1.0f,  -1204, 0.001f, { 0.0f,0.0f,0.0f },   207, 0.002f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  457. #define FSOUND_PRESET_ROOM             {2, 1.9f, 1.00f, -1000,  -454,   0,   0.40f,  0.83f, 1.0f,  -1646, 0.002f, { 0.0f,0.0f,0.0f },    53, 0.003f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  458. #define FSOUND_PRESET_BATHROOM         {3, 1.4f, 1.00f, -1000,  -1200,  0,   1.49f,  0.54f, 1.0f,   -370, 0.007f, { 0.0f,0.0f,0.0f },  1030, 0.011f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f,  60.0f, 0x3f }
  459. #define FSOUND_PRESET_LIVINGROOM       {4, 2.5f, 1.00f, -1000,  -6000,  0,   0.50f,  0.10f, 1.0f,  -1376, 0.003f, { 0.0f,0.0f,0.0f }, -1104, 0.004f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  460. #define FSOUND_PRESET_STONEROOM        {5, 11.6f, 1.00f, -1000,  -300,   0,   2.31f,  0.64f, 1.0f,   -711, 0.012f, { 0.0f,0.0f,0.0f },    83, 0.017f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  461. #define FSOUND_PRESET_AUDITORIUM       {6, 21.6f, 1.00f, -1000,  -476,   0,   4.32f,  0.59f, 1.0f,   -789, 0.020f, { 0.0f,0.0f,0.0f },  -289, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  462. #define FSOUND_PRESET_CONCERTHALL      {7, 19.6f, 1.00f, -1000,  -500,   0,   3.92f,  0.70f, 1.0f,  -1230, 0.020f, { 0.0f,0.0f,0.0f },    -2, 0.029f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  463. #define FSOUND_PRESET_CAVE             {8, 14.6f, 1.00f, -1000,  0,      0,   2.91f,  1.30f, 1.0f,   -602, 0.015f, { 0.0f,0.0f,0.0f },  -302, 0.022f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x1f }
  464. #define FSOUND_PRESET_ARENA            {9, 36.2f, 1.00f, -1000,  -698,   0,   7.24f,  0.33f, 1.0f,  -1166, 0.020f, { 0.0f,0.0f,0.0f },    16, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  465. #define FSOUND_PRESET_HANGAR           {10, 50.3f, 1.00f, -1000,  -1000,  0,   10.05f, 0.23f, 1.0f,   -602, 0.020f, { 0.0f,0.0f,0.0f },   198, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  466. #define FSOUND_PRESET_CARPETTEDHALLWAY {11, 1.9f, 1.00f, -1000,  -4000,  0,   0.30f,  0.10f, 1.0f,  -1831, 0.002f, { 0.0f,0.0f,0.0f }, -1630, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  467. #define FSOUND_PRESET_HALLWAY          {12, 1.8f, 1.00f, -1000,  -300,   0,   1.49f,  0.59f, 1.0f,  -1219, 0.007f, { 0.0f,0.0f,0.0f },   441, 0.011f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  468. #define FSOUND_PRESET_STONECORRIDOR    {13, 13.5f, 1.00f, -1000,  -237,   0,   2.70f,  0.79f, 1.0f,  -1214, 0.013f, { 0.0f,0.0f,0.0f },   395, 0.020f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  469. #define FSOUND_PRESET_ALLEY         {14, 7.5f, 0.30f, -1000,  -270,   0,   1.49f,  0.86f, 1.0f,  -1204, 0.007f, { 0.0f,0.0f,0.0f },    -4, 0.011f, { 0.0f,0.0f,0.0f }, 0.125f, 0.95f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  470. #define FSOUND_PRESET_FOREST         {15, 38.0f, 0.30f, -1000,  -3300,  0,   1.49f,  0.54f, 1.0f,  -2560, 0.162f, { 0.0f,0.0f,0.0f },  -229, 0.088f, { 0.0f,0.0f,0.0f }, 0.125f, 1.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f,  79.0f, 100.0f, 0x3f }
  471. #define FSOUND_PRESET_CITY             {16, 7.5f, 0.50f, -1000,  -800,   0,   1.49f,  0.67f, 1.0f,  -2273, 0.007f, { 0.0f,0.0f,0.0f }, -1691, 0.011f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f,  50.0f, 100.0f, 0x3f }
  472. #define FSOUND_PRESET_MOUNTAINS        {17, 100.0f, 0.27f, -1000,  -2500,  0,   1.49f,  0.21f, 1.0f,  -2780, 0.300f, { 0.0f,0.0f,0.0f }, -1434, 0.100f, { 0.0f,0.0f,0.0f }, 0.250f, 1.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f,  27.0f, 100.0f, 0x1f }
  473. #define FSOUND_PRESET_QUARRY           {18, 17.5f, 1.00f, -1000,  -1000,  0,   1.49f,  0.83f, 1.0f, -10000, 0.061f, { 0.0f,0.0f,0.0f },   500, 0.025f, { 0.0f,0.0f,0.0f }, 0.125f, 0.70f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  474. #define FSOUND_PRESET_PLAIN            {19, 42.5f, 0.21f, -1000,  -2000,  0,   1.49f,  0.50f, 1.0f,  -2466, 0.179f, { 0.0f,0.0f,0.0f }, -1926, 0.100f, { 0.0f,0.0f,0.0f }, 0.250f, 1.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f,  21.0f, 100.0f, 0x3f }
  475. #define FSOUND_PRESET_PARKINGLOT       {20, 8.3f, 1.00f, -1000,  0,      0,   1.65f,  1.50f, 1.0f,  -1363, 0.008f, { 0.0f,0.0f,0.0f }, -1153, 0.012f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x1f }
  476. #define FSOUND_PRESET_SEWERPIPE        {21, 1.7f, 0.80f, -1000,  -1000,  0,   2.81f,  0.14f, 1.0f,    429, 0.014f, { 0.0f,0.0f,0.0f },  1023, 0.021f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 0.000f, -5.0f, 5000.0f, 250.0f, 0.0f,  80.0f,  60.0f, 0x3f }
  477. #define FSOUND_PRESET_UNDERWATER       {22, 1.8f, 1.00f, -1000,  -4000,  0,   1.49f,  0.10f, 1.0f,   -449, 0.007f, { 0.0f,0.0f,0.0f },  1700, 0.011f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 1.18f, 0.348f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x3f }
  479. /* Non I3DL2 presets */
  481. #define FSOUND_PRESET_DRUGGED          {23, 1.9f, 0.50f, -1000,  0,      0,   8.39f,  1.39f, 1.0f,  -115,  0.002f, { 0.0f,0.0f,0.0f },   985, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 0.25f, 1.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x1f }
  482. #define FSOUND_PRESET_DIZZY            {24, 1.8f, 0.60f, -1000,  -400,   0,   17.23f, 0.56f, 1.0f,  -1713, 0.020f, { 0.0f,0.0f,0.0f },  -613, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 1.00f, 0.81f, 0.310f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x1f }
  483. #define FSOUND_PRESET_PSYCHOTIC        {25, 1.0f, 0.50f, -1000,  -151,   0,   7.56f,  0.91f, 1.0f,  -626,  0.020f, { 0.0f,0.0f,0.0f },   774, 0.030f, { 0.0f,0.0f,0.0f }, 0.250f, 0.00f, 4.00f, 1.000f, -5.0f, 5000.0f, 250.0f, 0.0f, 100.0f, 100.0f, 0x1f }
  485. /* PlayStation 2 Only presets */
  487. #define FSOUND_PRESET_PS2_ROOM         {1, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  488. #define FSOUND_PRESET_PS2_STUDIO_A     {2, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  489. #define FSOUND_PRESET_PS2_STUDIO_B     {3, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  490. #define FSOUND_PRESET_PS2_STUDIO_C     {4, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  491. #define FSOUND_PRESET_PS2_HALL         {5, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  492. #define FSOUND_PRESET_PS2_SPACE        {6, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  493. #define FSOUND_PRESET_PS2_ECHO         {7, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  494. #define FSOUND_PRESET_PS2_DELAY        {8, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  495. #define FSOUND_PRESET_PS2_PIPE         {9, 0,     0,         0,  0,      0,   0.0f,   0.0f,  0.0f,     0,  0.000f, { 0.0f,0.0f,0.0f },     0, 0.000f, { 0.0f,0.0f,0.0f }, 0.000f, 0.00f, 0.00f, 0.000f,  0.0f, 0000.0f,   0.0f, 0.0f,   0.0f,   0.0f, 0x31f }
  497. /* [DEFINE_END] */
  500. /*
  501. [STRUCTURE] 
  502. [
  503.     [DESCRIPTION]
  504.     Structure defining the properties for a reverb source, related to a FSOUND channel.
  505.     For more indepth descriptions of the reverb properties under win32, please see the EAX3
  506.     documentation at http://developer.creative.com/ under the 'downloads' section.
  507.     If they do not have the EAX3 documentation, then most information can be attained from
  508.     the EAX2 documentation, as EAX3 only adds some more parameters and functionality on top of 
  509.     EAX2.
  510.     
  511.     Note the default reverb properties are the same as the FSOUND_PRESET_GENERIC preset.
  512.     Note that integer values that typically range from -10,000 to 1000 are represented in 
  513.     decibels, and are of a logarithmic scale, not linear, wheras float values are typically linear.
  514.     PORTABILITY: Each member has the platform it supports in braces ie (win32/xbox).  
  515.     Some reverb parameters are only supported in win32 and some only on xbox. If all parameters are set then
  516.     the reverb should product a similar effect on either platform.
  517.     Linux and FMODCE do not support the reverb api.
  518.     
  519.     The numerical values listed below are the maximum, minimum and default values for each variable respectively.
  521.     [SEE_ALSO]
  522.     FSOUND_Reverb_SetChannelProperties
  523.     FSOUND_Reverb_GetChannelProperties
  524.     FSOUND_REVERB_CHANNELFLAGS
  525. ]
  526. */
  527. typedef struct _FSOUND_REVERB_CHANNELPROPERTIES /* MIN     MAX    DEFAULT */
  528. {                                   
  529.     int    Direct;                              /* -10000, 1000,  0,    direct path level (at low and mid frequencies) (win32/xbox) */
  530.     int    DirectHF;                            /* -10000, 0,     0,    relative direct path level at high frequencies (win32/xbox) */
  531.     int    Room;                                /* -10000, 1000,  0,    room effect level (at low and mid frequencies) (win32/xbox) */
  532.     int    RoomHF;                              /* -10000, 0,     0,    relative room effect level at high frequencies (win32/xbox) */
  533.     int    Obstruction;                         /* -10000, 0,     0,    main obstruction control (attenuation at high frequencies)  (win32/xbox) */
  534.     float  ObstructionLFRatio;                  /* 0.0,    1.0,   0.0,  obstruction low-frequency level re. main control (win32/xbox) */
  535.     int    Occlusion;                           /* -10000, 0,     0,    main occlusion control (attenuation at high frequencies) (win32/xbox) */
  536.     float  OcclusionLFRatio;                    /* 0.0,    1.0,   0.25, occlusion low-frequency level re. main control (win32/xbox) */
  537.     float  OcclusionRoomRatio;                  /* 0.0,    10.0,  1.5,  relative occlusion control for room effect (win32) */
  538.     float  OcclusionDirectRatio;                /* 0.0,    10.0,  1.0,  relative occlusion control for direct path (win32) */
  539.     int    Exclusion;                           /* -10000, 0,     0,    main exlusion control (attenuation at high frequencies) (win32) */
  540.     float  ExclusionLFRatio;                    /* 0.0,    1.0,   1.0,  exclusion low-frequency level re. main control (win32) */
  541.     int    OutsideVolumeHF;                     /* -10000, 0,     0,    outside sound cone level at high frequencies (win32) */
  542.     float  DopplerFactor;                       /* 0.0,    10.0,  0.0,  like DS3D flDopplerFactor but per source (win32) */
  543.     float  RolloffFactor;                       /* 0.0,    10.0,  0.0,  like DS3D flRolloffFactor but per source (win32) */
  544.     float  RoomRolloffFactor;                   /* 0.0,    10.0,  0.0,  like DS3D flRolloffFactor but for room effect (win32/xbox) */
  545.     float  AirAbsorptionFactor;                 /* 0.0,    10.0,  1.0,  multiplies AirAbsorptionHF member of FSOUND_REVERB_PROPERTIES (win32) */
  546.     int    Flags;                               /* FSOUND_REVERB_CHANNELFLAGS - modifies the behavior of properties (win32) */
  547. } FSOUND_REVERB_CHANNELPROPERTIES;
  550. /*
  551. [DEFINE_START] 
  552. [
  553.     [NAME] 
  554.     FSOUND_REVERB_CHANNELFLAGS
  555.     
  556.     [DESCRIPTION]
  557.     Values for the Flags member of the FSOUND_REVERB_CHANNELPROPERTIES structure.
  559.     [SEE_ALSO]
  560.     FSOUND_REVERB_CHANNELPROPERTIES
  561. ]
  562. */
  563. #define FSOUND_REVERB_CHANNELFLAGS_DIRECTHFAUTO  0x00000001 /* Automatic setting of 'Direct'  due to distance from listener */
  564. #define FSOUND_REVERB_CHANNELFLAGS_ROOMAUTO      0x00000002 /* Automatic setting of 'Room'  due to distance from listener */
  565. #define FSOUND_REVERB_CHANNELFLAGS_ROOMHFAUTO    0x00000004 /* Automatic setting of 'RoomHF' due to distance from listener */
  566. #define FSOUND_REVERB_CHANNELFLAGS_DEFAULT       (FSOUND_REVERB_CHANNELFLAGS_DIRECTHFAUTO |   
  567.                                                   FSOUND_REVERB_CHANNELFLAGS_ROOMAUTO|        
  568.                                                   FSOUND_REVERB_CHANNELFLAGS_ROOMHFAUTO)
  569. /* [DEFINE_END] */
  572. /*
  573. [ENUM] 
  574. [
  575.     [DESCRIPTION]
  576.     These values are used with FSOUND_FX_Enable to enable DirectX 8 FX for a channel.
  578.     [SEE_ALSO]
  579.     FSOUND_FX_Enable
  580.     FSOUND_FX_Disable
  581.     FSOUND_FX_SetChorus
  582.     FSOUND_FX_SetCompressor
  583.     FSOUND_FX_SetDistortion
  584.     FSOUND_FX_SetEcho
  585.     FSOUND_FX_SetFlanger
  586.     FSOUND_FX_SetGargle
  587.     FSOUND_FX_SetI3DL2Reverb
  588.     FSOUND_FX_SetParamEQ
  589.     FSOUND_FX_SetWavesReverb
  590. ]
  591. */
  592. enum FSOUND_FX_MODES
  593. {
  594.     FSOUND_FX_CHORUS,
  595.     FSOUND_FX_COMPRESSOR,
  596.     FSOUND_FX_DISTORTION,
  597.     FSOUND_FX_ECHO,
  598.     FSOUND_FX_FLANGER,
  599.     FSOUND_FX_GARGLE,
  600.     FSOUND_FX_I3DL2REVERB,
  601.     FSOUND_FX_PARAMEQ,
  602.     FSOUND_FX_WAVES_REVERB,
  604.     FSOUND_FX_MAX
  605. };
  607. /*
  608. [ENUM]
  609. [
  610.     [DESCRIPTION]   
  611.     These are speaker types defined for use with the FSOUND_SetSpeakerMode command.
  612.     Note - Only reliably works with FSOUND_OUTPUT_DSOUND or FSOUND_OUTPUT_XBOX output modes.  Other output modes will only 
  613.     interpret FSOUND_SPEAKERMODE_MONO and set everything else to be stereo.
  614.     Note - Only reliably works with FSOUND_OUTPUT_DSOUND or FSOUND_OUTPUT_XBOX output modes.  Other output modes will only 
  615.     interpret FSOUND_SPEAKERMODE_MONO and set everything else to be stereo.
  617.     Using either DolbyDigital or DTS will use whatever 5.1 digital mode is available if destination hardware is unsure.
  619.     [SEE_ALSO]
  620.     FSOUND_SetSpeakerMode
  622. ]
  623. */
  624. enum FSOUND_SPEAKERMODES
  625. {
  626.     FSOUND_SPEAKERMODE_DOLBYDIGITAL,  /* The audio is played through a speaker arrangement of surround speakers with a subwoofer. */
  627.     FSOUND_SPEAKERMODE_HEADPHONES,    /* The speakers are headphones. */
  628.     FSOUND_SPEAKERMODE_MONO,          /* The speakers are monaural. */
  629.     FSOUND_SPEAKERMODE_QUAD,          /* The speakers are quadraphonic.  */
  630.     FSOUND_SPEAKERMODE_STEREO,        /* The speakers are stereo (default value). */
  631.     FSOUND_SPEAKERMODE_SURROUND,      /* The speakers are surround sound. */
  632.     FSOUND_SPEAKERMODE_DTS            /* (XBOX Only) The audio is played through a speaker arrangement of surround speakers with a subwoofer. */
  633. };
  636. /*
  637. [DEFINE_START] 
  638. [
  639.     [NAME] 
  640.     FSOUND_INIT_FLAGS
  641.     
  642.     [DESCRIPTION]   
  643.     Initialization flags.  Use them with FSOUND_Init in the flags parameter to change various behaviour.
  644.     
  645.     FSOUND_INIT_ENABLEOUTPUTFX Is an init mode which enables the FSOUND mixer buffer to be affected by DirectX 8 effects.
  646.     Note that due to limitations of DirectSound, FSOUND_Init may fail if this is enabled because the buffersize is too small.
  647.     This can be fixed with FSOUND_SetBufferSize.  Increase the BufferSize until it works.
  648.     When it is enabled you can use the FSOUND_FX api, and use FSOUND_SYSTEMCHANNEL as the channel id when setting parameters.
  650.     [SEE_ALSO]
  651.     FSOUND_Init
  652. ]
  653. */
  654. #define FSOUND_INIT_USEDEFAULTMIDISYNTH     0x01    /* Causes MIDI playback to force software decoding. */
  655. #define FSOUND_INIT_GLOBALFOCUS             0x02    /* For DirectSound output - sound is not muted when window is out of focus. */
  656. #define FSOUND_INIT_ENABLEOUTPUTFX          0x04    /* For DirectSound output - Allows FSOUND_FX api to be used on global software mixer output! */
  657. #define FSOUND_INIT_ACCURATEVULEVELS        0x08    /* This latency adjusts FSOUND_GetCurrentLevels, but incurs a small cpu and memory hit */
  658. #define FSOUND_INIT_PS2_DISABLECORE0REVERB  0x10    /* PS2 only - Disable reverb on CORE 0 to regain SRAM */
  659. #define FSOUND_INIT_PS2_DISABLECORE1REVERB  0x20    /* PS2 only - Disable reverb on CORE 1 to regain SRAM */
  660. #define FSOUND_INIT_PS2_SWAPDMACORES        0x40    /* PS2 only - By default FMOD uses DMA CH0 for mixing, CH1 for uploads, this flag swaps them around */
  661. /* [DEFINE_END] */
  666. /* ========================================================================================== */
  667. /* FUNCTION PROTOTYPES                                                                        */
  668. /* ========================================================================================== */
  670. #ifdef __cplusplus
  671. extern "C" {
  672. #endif
  674. /* ================================== */
  675. /* Initialization / Global functions. */
  676. /* ================================== */
  678. /* 
  679.     PRE - FSOUND_Init functions. These can't be called after FSOUND_Init is 
  680.     called (they will fail). They set up FMOD system functionality. 
  681. */
  683. DLL_API signed char     F_API FSOUND_SetOutput(int outputtype);
  684. DLL_API signed char     F_API FSOUND_SetDriver(int driver);
  685. DLL_API signed char     F_API FSOUND_SetMixer(int mixer);
  686. DLL_API signed char     F_API FSOUND_SetBufferSize(int len_ms);
  687. DLL_API signed char     F_API FSOUND_SetHWND(void *hwnd);
  688. DLL_API signed char     F_API FSOUND_SetMinHardwareChannels(int min);
  689. DLL_API signed char     F_API FSOUND_SetMaxHardwareChannels(int max);
  690. DLL_API signed char     F_API FSOUND_SetMemorySystem(void *pool, 
  691.                                                      int poollen, 
  692.                                                      FSOUND_ALLOCCALLBACK   useralloc,
  693.                                                      FSOUND_REALLOCCALLBACK userrealloc,
  694.                                                      FSOUND_FREECALLBACK    userfree);
  695. /* 
  696.     Main initialization / closedown functions.
  697.     Note : Use FSOUND_INIT_USEDEFAULTMIDISYNTH with FSOUND_Init for software override 
  698.            with MIDI playback.
  699.          : Use FSOUND_INIT_GLOBALFOCUS with FSOUND_Init to make sound audible no matter 
  700.            which window is in focus. (FSOUND_OUTPUT_DSOUND only)
  701. */
  703. DLL_API signed char     F_API FSOUND_Init(int mixrate, int maxsoftwarechannels, unsigned int flags);
  704. DLL_API void            F_API FSOUND_Close();
  706. /* 
  707.     Runtime system level functions 
  708. */
  710. DLL_API void            F_API FSOUND_Update();   /* This is called to update 3d sound / non-realtime output */
  712. DLL_API void            F_API FSOUND_SetSpeakerMode(unsigned int speakermode);
  713. DLL_API void            F_API FSOUND_SetSFXMasterVolume(int volume);
  714. DLL_API void            F_API FSOUND_SetPanSeperation(float pansep);
  715. DLL_API void            F_API FSOUND_File_SetCallbacks(FSOUND_OPENCALLBACK  useropen,
  716.                                                        FSOUND_CLOSECALLBACK userclose,
  717.                                                        FSOUND_READCALLBACK  userread,
  718.                                                        FSOUND_SEEKCALLBACK  userseek,
  719.                                                        FSOUND_TELLCALLBACK  usertell);
  721. /* 
  722.     System information functions. 
  723. */
  725. DLL_API int             F_API FSOUND_GetError();
  726. DLL_API float           F_API FSOUND_GetVersion();
  727. DLL_API int             F_API FSOUND_GetOutput();
  728. DLL_API void *          F_API FSOUND_GetOutputHandle();
  729. DLL_API int             F_API FSOUND_GetDriver();
  730. DLL_API int             F_API FSOUND_GetMixer();
  731. DLL_API int             F_API FSOUND_GetNumDrivers();
  732. DLL_API signed char *   F_API FSOUND_GetDriverName(int id);
  733. DLL_API signed char     F_API FSOUND_GetDriverCaps(int id, unsigned int *caps);
  734. DLL_API int             F_API FSOUND_GetOutputRate();
  735. DLL_API int             F_API FSOUND_GetMaxChannels();
  736. DLL_API int             F_API FSOUND_GetMaxSamples();
  737. DLL_API int             F_API FSOUND_GetSFXMasterVolume();
  738. DLL_API int             F_API FSOUND_GetNumHardwareChannels();
  739. DLL_API int             F_API FSOUND_GetChannelsPlaying();
  740. DLL_API float           F_API FSOUND_GetCPUUsage();
  741. DLL_API void            F_API FSOUND_GetMemoryStats(unsigned int *currentalloced, unsigned int *maxalloced);
  743. /* =================================== */
  744. /* Sample management / load functions. */
  745. /* =================================== */
  747. /* 
  748.     Sample creation and management functions
  749.     Note : Use FSOUND_LOADMEMORY   flag with FSOUND_Sample_Load to load from memory.
  750.            Use FSOUND_LOADRAW      flag with FSOUND_Sample_Load to treat as as raw pcm data.
  751. */
  753. DLL_API FSOUND_SAMPLE * F_API FSOUND_Sample_Load(int index, const char *name_or_data, unsigned int mode, int memlength);
  754. DLL_API FSOUND_SAMPLE * F_API FSOUND_Sample_Alloc(int index, int length, unsigned int mode, int deffreq, int defvol, int defpan, int defpri);
  755. DLL_API void            F_API FSOUND_Sample_Free(FSOUND_SAMPLE *sptr);
  756. DLL_API signed char     F_API FSOUND_Sample_Upload(FSOUND_SAMPLE *sptr, void *srcdata, unsigned int mode);
  757. DLL_API signed char     F_API FSOUND_Sample_Lock(FSOUND_SAMPLE *sptr, int offset, int length, void **ptr1, void **ptr2, unsigned int *len1, unsigned int *len2);
  758. DLL_API signed char     F_API FSOUND_Sample_Unlock(FSOUND_SAMPLE *sptr, void *ptr1, void *ptr2, unsigned int len1, unsigned int len2);
  760. /*
  761.     Sample control functions
  762. */
  764. DLL_API signed char     F_API FSOUND_Sample_SetMode(FSOUND_SAMPLE *sptr, unsigned int mode);
  765. DLL_API signed char     F_API FSOUND_Sample_SetLoopPoints(FSOUND_SAMPLE *sptr, int loopstart, int loopend);
  766. DLL_API signed char     F_API FSOUND_Sample_SetDefaults(FSOUND_SAMPLE *sptr, int deffreq, int defvol, int defpan, int defpri);
  767. DLL_API signed char     F_API FSOUND_Sample_SetMinMaxDistance(FSOUND_SAMPLE *sptr, float min, float max);
  768. DLL_API signed char     F_API FSOUND_Sample_SetMaxPlaybacks(FSOUND_SAMPLE *sptr, int max);
  770. /* 
  771.     Sample information functions
  772. */
  774. DLL_API FSOUND_SAMPLE * F_API FSOUND_Sample_Get(int sampno);
  775. DLL_API char *          F_API FSOUND_Sample_GetName(FSOUND_SAMPLE *sptr);
  776. DLL_API unsigned int    F_API FSOUND_Sample_GetLength(FSOUND_SAMPLE *sptr);
  777. DLL_API signed char     F_API FSOUND_Sample_GetLoopPoints(FSOUND_SAMPLE *sptr, int *loopstart, int *loopend);
  778. DLL_API signed char     F_API FSOUND_Sample_GetDefaults(FSOUND_SAMPLE *sptr, int *deffreq, int *defvol, int *defpan, int *defpri);
  779. DLL_API unsigned int    F_API FSOUND_Sample_GetMode(FSOUND_SAMPLE *sptr);
  780.   
  781. /* ============================ */
  782. /* Channel control functions.   */
  783. /* ============================ */
  785. /* 
  786.     Playing and stopping sounds.  
  787.     Note : Use FSOUND_FREE as the 'channel' variable, to let FMOD pick a free channel for you.
  788.            Use FSOUND_ALL as the 'channel' variable to control ALL channels with one function call!
  789. */
  791. DLL_API int             F_API FSOUND_PlaySound(int channel, FSOUND_SAMPLE *sptr);
  792. DLL_API int             F_API FSOUND_PlaySoundEx(int channel, FSOUND_SAMPLE *sptr, FSOUND_DSPUNIT *dsp, signed char startpaused);
  793. DLL_API signed char     F_API FSOUND_StopSound(int channel);
  795. /* 
  796.     Functions to control playback of a channel.
  797.     Note : FSOUND_ALL can be used on most of these functions as a channel value.
  798. */
  800. DLL_API signed char     F_API FSOUND_SetFrequency(int channel, int freq);
  801. DLL_API signed char     F_API FSOUND_SetVolume(int channel, int vol);
  802. DLL_API signed char     F_API FSOUND_SetVolumeAbsolute(int channel, int vol);
  803. DLL_API signed char     F_API FSOUND_SetPan(int channel, int pan);
  804. DLL_API signed char     F_API FSOUND_SetSurround(int channel, signed char surround);
  805. DLL_API signed char     F_API FSOUND_SetMute(int channel, signed char mute);
  806. DLL_API signed char     F_API FSOUND_SetPriority(int channel, int priority);
  807. DLL_API signed char     F_API FSOUND_SetReserved(int channel, signed char reserved);
  808. DLL_API signed char     F_API FSOUND_SetPaused(int channel, signed char paused);
  809. DLL_API signed char     F_API FSOUND_SetLoopMode(int channel, unsigned int loopmode);
  810. DLL_API signed char     F_API FSOUND_SetCurrentPosition(int channel, unsigned int offset);
  812. /* 
  813.     Channel information functions.
  814. */
  816. DLL_API signed char     F_API FSOUND_IsPlaying(int channel);
  817. DLL_API int             F_API FSOUND_GetFrequency(int channel);
  818. DLL_API int             F_API FSOUND_GetVolume(int channel);
  819. DLL_API int             F_API FSOUND_GetPan(int channel);
  820. DLL_API signed char     F_API FSOUND_GetSurround(int channel);
  821. DLL_API signed char     F_API FSOUND_GetMute(int channel);
  822. DLL_API int             F_API FSOUND_GetPriority(int channel);
  823. DLL_API signed char     F_API FSOUND_GetReserved(int channel);
  824. DLL_API signed char     F_API FSOUND_GetPaused(int channel);
  825. DLL_API unsigned int    F_API FSOUND_GetLoopMode(int channel);
  826. DLL_API unsigned int    F_API FSOUND_GetCurrentPosition(int channel);
  827. DLL_API FSOUND_SAMPLE * F_API FSOUND_GetCurrentSample(int channel);
  828. DLL_API signed char     F_API FSOUND_GetCurrentLevels(int channel, float *l, float *r);
  831. /* =================== */
  832. /* FX functions.       */
  833. /* =================== */
  835. /* 
  836.     Functions to control DX8 only effects processing.
  838.     - FX enabled samples can only be played once at a time, not multiple times at once.
  839.     - Sounds have to be created with FSOUND_HW2D or FSOUND_HW3D for this to work.
  840.     - FSOUND_INIT_ENABLEOUTPUTFX can be used to apply hardware effect processing to the
  841.       global mixed output of FMOD's software channels.
  842.     - FSOUND_FX_Enable returns an FX handle that you can use to alter fx parameters.
  843.     - FSOUND_FX_Enable can be called multiple times in a row, even on the same FX type,
  844.       it will return a unique handle for each FX.
  845.     - FSOUND_FX_Enable cannot be called if the sound is playing or locked.
  846.     - FSOUND_FX_Disable must be called to reset/clear the FX from a channel.
  847. */
  849. DLL_API int             F_API FSOUND_FX_Enable(int channel, unsigned int fx);    /* See FSOUND_FX_MODES */
  850. DLL_API signed char     F_API FSOUND_FX_Disable(int channel);    
  852. DLL_API signed char     F_API FSOUND_FX_SetChorus(int fxid, float WetDryMix, float Depth, float Feedback, float Frequency, int Waveform, float Delay, int Phase);
  853. DLL_API signed char     F_API FSOUND_FX_SetCompressor(int fxid, float Gain, float Attack, float Release, float Threshold, float Ratio, float Predelay);
  854. DLL_API signed char     F_API FSOUND_FX_SetDistortion(int fxid, float Gain, float Edge, float PostEQCenterFrequency, float PostEQBandwidth, float PreLowpassCutoff);
  855. DLL_API signed char     F_API FSOUND_FX_SetEcho(int fxid, float WetDryMix, float Feedback, float LeftDelay, float RightDelay, int PanDelay);
  856. DLL_API signed char     F_API FSOUND_FX_SetFlanger(int fxid, float WetDryMix, float Depth, float Feedback, float Frequency, int Waveform, float Delay, int Phase);
  857. DLL_API signed char     F_API FSOUND_FX_SetGargle(int fxid, int RateHz, int WaveShape);
  858. DLL_API signed char     F_API FSOUND_FX_SetI3DL2Reverb(int fxid, int Room, int RoomHF, float RoomRolloffFactor, float DecayTime, float DecayHFRatio, int Reflections, float ReflectionsDelay, int Reverb, float ReverbDelay, float Diffusion, float Density, float HFReference);
  859. DLL_API signed char     F_API FSOUND_FX_SetParamEQ(int fxid, float Center, float Bandwidth, float Gain);
  860. DLL_API signed char     F_API FSOUND_FX_SetWavesReverb(int fxid, float InGain, float ReverbMix, float ReverbTime, float HighFreqRTRatio);  
  861.  
  862. /* =================== */
  863. /* 3D sound functions. */
  864. /* =================== */
  866. /* 
  867.     See also FSOUND_Sample_SetMinMaxDistance (above)
  868.     Note! FSOUND_3D_Update is now called FSOUND_Update.
  869. */
  871. DLL_API void            F_API FSOUND_3D_SetDopplerFactor(float scale);
  872. DLL_API void            F_API FSOUND_3D_SetDistanceFactor(float scale);
  873. DLL_API void            F_API FSOUND_3D_SetRolloffFactor(float scale);
  874. DLL_API signed char     F_API FSOUND_3D_SetAttributes(int channel, float *pos, float *vel);
  875. DLL_API signed char     F_API FSOUND_3D_GetAttributes(int channel, float *pos, float *vel);
  877. DLL_API void            F_API FSOUND_3D_Listener_SetCurrent(int current, int numlisteners);  /* use this if you use multiple listeners / splitscreen */
  878. DLL_API void            F_API FSOUND_3D_Listener_SetAttributes(float *pos, float *vel, float fx, float fy, float fz, float tx, float ty, float tz);
  879. DLL_API void            F_API FSOUND_3D_Listener_GetAttributes(float *pos, float *vel, float *fx, float *fy, float *fz, float *tx, float *ty, float *tz);
  880.  
  881. /* ========================= */
  882. /* File Streaming functions. */
  883. /* ========================= */
  885. /*
  886.     Note : Use FSOUND_LOADMEMORY   flag with FSOUND_Stream_OpenFile to stream from memory.
  887.            Use FSOUND_LOADRAW      flag with FSOUND_Stream_OpenFile to treat stream as raw pcm data.
  888.            Use FSOUND_MPEGACCURATE flag with FSOUND_Stream_OpenFile to open mpegs in 'accurate mode' for settime/gettime/getlengthms.
  889.            Use FSOUND_FREE as the 'channel' variable, to let FMOD pick a free channel for you.
  890. */
  892. DLL_API signed char     F_API FSOUND_Stream_SetBufferSize(int ms);      /* call this before opening streams, not after */
  894. DLL_API FSOUND_STREAM * F_API FSOUND_Stream_OpenFile(const char *filename, unsigned int mode, int memlength);
  895. DLL_API FSOUND_STREAM * F_API FSOUND_Stream_Create(FSOUND_STREAMCALLBACK callback, int length, unsigned int mode, int samplerate, int userdata);
  896. DLL_API signed char     F_API FSOUND_Stream_Close(FSOUND_STREAM *stream);
  898. DLL_API int             F_API FSOUND_Stream_Play(int channel, FSOUND_STREAM *stream);
  899. DLL_API int             F_API FSOUND_Stream_PlayEx(int channel, FSOUND_STREAM *stream, FSOUND_DSPUNIT *dsp, signed char startpaused);
  900. DLL_API signed char     F_API FSOUND_Stream_Stop(FSOUND_STREAM *stream);
  902. DLL_API int             F_API FSOUND_Stream_GetOpenState(FSOUND_STREAM *stream);  /* use with FSOUND_NONBLOCKING opened streams */
  903. DLL_API signed char     F_API FSOUND_Stream_SetPosition(FSOUND_STREAM *stream, unsigned int position);
  904. DLL_API unsigned int    F_API FSOUND_Stream_GetPosition(FSOUND_STREAM *stream);
  905. DLL_API signed char     F_API FSOUND_Stream_SetTime(FSOUND_STREAM *stream, int ms);
  906. DLL_API int             F_API FSOUND_Stream_GetTime(FSOUND_STREAM *stream);
  907. DLL_API int             F_API FSOUND_Stream_GetLength(FSOUND_STREAM *stream);
  908. DLL_API int             F_API FSOUND_Stream_GetLengthMs(FSOUND_STREAM *stream);
  910. DLL_API signed char     F_API FSOUND_Stream_SetLoopPoints(FSOUND_STREAM *stream, unsigned int loopstartpcm, unsigned int loopendpcm);
  911. DLL_API FSOUND_SAMPLE * F_API FSOUND_Stream_GetSample(FSOUND_STREAM *stream);
  912. DLL_API FSOUND_DSPUNIT *F_API FSOUND_Stream_CreateDSP(FSOUND_STREAM *stream, FSOUND_DSPCALLBACK callback, int priority, int param);
  913. DLL_API signed char     F_API FSOUND_Stream_SetEndCallback(FSOUND_STREAM *stream, FSOUND_STREAMCALLBACK callback, int userdata);
  915. DLL_API signed char     F_API FSOUND_Stream_SetSynchCallback(FSOUND_STREAM *stream, FSOUND_STREAMCALLBACK callback, int userdata);
  916. DLL_API int             F_API FSOUND_Stream_AddSynchPoint(FSOUND_STREAM *stream, unsigned int pcmoffset, int userdata);
  917. DLL_API signed char     F_API FSOUND_Stream_DeleteSynchPoint(FSOUND_STREAM *stream, int index);
  918. DLL_API int             F_API FSOUND_Stream_GetNumSynchPoints(FSOUND_STREAM *stream);
  920. DLL_API signed char     F_API FSOUND_Stream_SetSubStream(FSOUND_STREAM *stream, int index);     /* For FMOD .FSB bank files.  Console only currently. */
  921. DLL_API int             F_API FSOUND_Stream_GetNumSubStreams(FSOUND_STREAM *stream);            /* For FMOD .FSB bank files.  Console only currently. */
  923. /* =================== */
  924. /* CD audio functions. */
  925. /* =================== */
  927. /*
  928.     Note : 0 = default cdrom.  Otherwise specify the drive letter, for example. 'D'. 
  929. */
  931. DLL_API signed char     F_API FSOUND_CD_Play(char drive, int track);
  932. DLL_API void            F_API FSOUND_CD_SetPlayMode(char drive, signed char mode);
  933. DLL_API signed char     F_API FSOUND_CD_Stop(char drive);
  934. DLL_API signed char     F_API FSOUND_CD_SetPaused(char drive, signed char paused);
  935. DLL_API signed char     F_API FSOUND_CD_SetVolume(char drive, int volume);
  936. DLL_API signed char     F_API FSOUND_CD_Eject(char drive);
  938. DLL_API signed char     F_API FSOUND_CD_GetPaused(char drive);
  939. DLL_API int             F_API FSOUND_CD_GetTrack(char drive);
  940. DLL_API int             F_API FSOUND_CD_GetNumTracks(char drive);
  941. DLL_API int             F_API FSOUND_CD_GetVolume(char drive);
  942. DLL_API int             F_API FSOUND_CD_GetTrackLength(char drive, int track); 
  943. DLL_API int             F_API FSOUND_CD_GetTrackTime(char drive);
  945. /* ============== */
  946. /* DSP functions. */
  947. /* ============== */
  949. /* 
  950.     DSP Unit control and information functions. 
  951.     These functions allow you access to the mixed stream that FMOD uses to play back sound on.
  952. */
  954. DLL_API FSOUND_DSPUNIT *F_API FSOUND_DSP_Create(FSOUND_DSPCALLBACK callback, int priority, int param);
  955. DLL_API void            F_API FSOUND_DSP_Free(FSOUND_DSPUNIT *unit);
  956. DLL_API void            F_API FSOUND_DSP_SetPriority(FSOUND_DSPUNIT *unit, int priority);
  957. DLL_API int             F_API FSOUND_DSP_GetPriority(FSOUND_DSPUNIT *unit);
  958. DLL_API void            F_API FSOUND_DSP_SetActive(FSOUND_DSPUNIT *unit, signed char active);
  959. DLL_API signed char     F_API FSOUND_DSP_GetActive(FSOUND_DSPUNIT *unit);
  961. /* 
  962.     Functions to get hold of FSOUND 'system DSP unit' handles. 
  963. */
  965. DLL_API FSOUND_DSPUNIT *F_API FSOUND_DSP_GetClearUnit();
  966. DLL_API FSOUND_DSPUNIT *F_API FSOUND_DSP_GetSFXUnit();
  967. DLL_API FSOUND_DSPUNIT *F_API FSOUND_DSP_GetMusicUnit();
  968. DLL_API FSOUND_DSPUNIT *F_API FSOUND_DSP_GetFFTUnit();
  969. DLL_API FSOUND_DSPUNIT *F_API FSOUND_DSP_GetClipAndCopyUnit();
  971. /* 
  972.     Miscellaneous DSP functions 
  973.     Note for the spectrum analysis function to work, you have to enable the FFT DSP unit with 
  974.     the following code FSOUND_DSP_SetActive(FSOUND_DSP_GetFFTUnit(), TRUE);
  975.     It is off by default to save cpu usage.
  976. */
  978. DLL_API signed char     F_API FSOUND_DSP_MixBuffers(void *destbuffer, void *srcbuffer, int len, int freq, int vol, int pan, unsigned int mode);
  979. DLL_API void            F_API FSOUND_DSP_ClearMixBuffer();
  980. DLL_API int             F_API FSOUND_DSP_GetBufferLength();      /* Length of each DSP update */
  981. DLL_API int             F_API FSOUND_DSP_GetBufferLengthTotal(); /* Total buffer length due to FSOUND_SetBufferSize */
  982. DLL_API float *         F_API FSOUND_DSP_GetSpectrum();          /* Array of 512 floats - call FSOUND_DSP_SetActive(FSOUND_DSP_GetFFTUnit(), TRUE)) for this to work. */
  984. /* =================================================================================== */
  985. /* Reverb functions. (eax2/eax3 reverb)  (ONLY SUPPORTED ON WIN32 W/ FSOUND_HW3D FLAG) */
  986. /* =================================================================================== */
  988. /*
  989.     See top of file for definitions and information on the reverb parameters.
  990. */
  992. DLL_API signed char F_API FSOUND_Reverb_SetProperties(FSOUND_REVERB_PROPERTIES *prop);
  993. DLL_API signed char F_API FSOUND_Reverb_GetProperties(FSOUND_REVERB_PROPERTIES *prop);
  994. DLL_API signed char F_API FSOUND_Reverb_SetChannelProperties(int channel, FSOUND_REVERB_CHANNELPROPERTIES *prop);
  995. DLL_API signed char F_API FSOUND_Reverb_GetChannelProperties(int channel, FSOUND_REVERB_CHANNELPROPERTIES *prop);
  997. /* ===================================================== */
  998. /* Recording functions  (ONLY SUPPORTED IN WIN32, WINCE) */
  999. /* ===================================================== */
  1001. /*
  1002.     Recording initialization functions
  1003. */
  1005. DLL_API signed char     F_API FSOUND_Record_SetDriver(int outputtype);
  1006. DLL_API int             F_API FSOUND_Record_GetNumDrivers();
  1007. DLL_API signed char *   F_API FSOUND_Record_GetDriverName(int id);
  1008. DLL_API int             F_API FSOUND_Record_GetDriver();
  1010. /*
  1011.     Recording functionality.  Only one recording session will work at a time.
  1012. */
  1014. DLL_API signed char     F_API FSOUND_Record_StartSample(FSOUND_SAMPLE *sptr, signed char loop);
  1015. DLL_API signed char     F_API FSOUND_Record_Stop();
  1016. DLL_API int             F_API FSOUND_Record_GetPosition();  
  1018. /* ========================================================================================== */
  1019. /* FMUSIC API (MOD,S3M,XM,IT,MIDI PLAYBACK)                                                   */
  1020. /* ========================================================================================== */
  1022. /* 
  1023.     Song management / playback functions.
  1024. */
  1026. DLL_API FMUSIC_MODULE * F_API FMUSIC_LoadSong(const char *name);
  1027. DLL_API FMUSIC_MODULE * F_API FMUSIC_LoadSongMemory(void *data, int length);
  1028. DLL_API signed char     F_API FMUSIC_FreeSong(FMUSIC_MODULE *mod);
  1029. DLL_API signed char     F_API FMUSIC_PlaySong(FMUSIC_MODULE *mod);
  1030. DLL_API signed char     F_API FMUSIC_StopSong(FMUSIC_MODULE *mod);
  1031. DLL_API void            F_API FMUSIC_StopAllSongs();
  1033. DLL_API signed char     F_API FMUSIC_SetZxxCallback(FMUSIC_MODULE *mod, FMUSIC_CALLBACK callback);
  1034. DLL_API signed char     F_API FMUSIC_SetRowCallback(FMUSIC_MODULE *mod, FMUSIC_CALLBACK callback, int rowstep);
  1035. DLL_API signed char     F_API FMUSIC_SetOrderCallback(FMUSIC_MODULE *mod, FMUSIC_CALLBACK callback, int orderstep);
  1036. DLL_API signed char     F_API FMUSIC_SetInstCallback(FMUSIC_MODULE *mod, FMUSIC_CALLBACK callback, int instrument);
  1038. DLL_API signed char     F_API FMUSIC_SetSample(FMUSIC_MODULE *mod, int sampno, FSOUND_SAMPLE *sptr);
  1039. DLL_API signed char     F_API FMUSIC_SetUserData(FMUSIC_MODULE *mod, unsigned int userdata);
  1040. DLL_API signed char     F_API FMUSIC_OptimizeChannels(FMUSIC_MODULE *mod, int maxchannels, int minvolume);
  1042. /*
  1043.     Runtime song functions. 
  1044. */
  1046. DLL_API signed char     F_API FMUSIC_SetReverb(signed char reverb);             /* MIDI only */
  1047. DLL_API signed char     F_API FMUSIC_SetLooping(FMUSIC_MODULE *mod, signed char looping);
  1048. DLL_API signed char     F_API FMUSIC_SetOrder(FMUSIC_MODULE *mod, int order);
  1049. DLL_API signed char     F_API FMUSIC_SetPaused(FMUSIC_MODULE *mod, signed char pause);
  1050. DLL_API signed char     F_API FMUSIC_SetMasterVolume(FMUSIC_MODULE *mod, int volume);
  1051. DLL_API signed char     F_API FMUSIC_SetMasterSpeed(FMUSIC_MODULE *mode, float speed);
  1052. DLL_API signed char     F_API FMUSIC_SetPanSeperation(FMUSIC_MODULE *mod, float pansep);
  1053.  
  1054. /* 
  1055.     Static song information functions.
  1056. */
  1058. DLL_API char *          F_API FMUSIC_GetName(FMUSIC_MODULE *mod);
  1059. DLL_API int             F_API FMUSIC_GetType(FMUSIC_MODULE *mod);
  1060. DLL_API int             F_API FMUSIC_GetNumOrders(FMUSIC_MODULE *mod);
  1061. DLL_API int             F_API FMUSIC_GetNumPatterns(FMUSIC_MODULE *mod);
  1062. DLL_API int             F_API FMUSIC_GetNumInstruments(FMUSIC_MODULE *mod);
  1063. DLL_API int             F_API FMUSIC_GetNumSamples(FMUSIC_MODULE *mod);
  1064. DLL_API int             F_API FMUSIC_GetNumChannels(FMUSIC_MODULE *mod);
  1065. DLL_API FSOUND_SAMPLE * F_API FMUSIC_GetSample(FMUSIC_MODULE *mod, int sampno);
  1066. DLL_API int             F_API FMUSIC_GetPatternLength(FMUSIC_MODULE *mod, int orderno);
  1067.  
  1068. /* 
  1069.     Runtime song information.
  1070. */
  1072. DLL_API signed char     F_API FMUSIC_IsFinished(FMUSIC_MODULE *mod);
  1073. DLL_API signed char     F_API FMUSIC_IsPlaying(FMUSIC_MODULE *mod);
  1074. DLL_API int             F_API FMUSIC_GetMasterVolume(FMUSIC_MODULE *mod);
  1075. DLL_API int             F_API FMUSIC_GetGlobalVolume(FMUSIC_MODULE *mod);
  1076. DLL_API int             F_API FMUSIC_GetOrder(FMUSIC_MODULE *mod);
  1077. DLL_API int             F_API FMUSIC_GetPattern(FMUSIC_MODULE *mod);
  1078. DLL_API int             F_API FMUSIC_GetSpeed(FMUSIC_MODULE *mod);
  1079. DLL_API int             F_API FMUSIC_GetBPM(FMUSIC_MODULE *mod);
  1080. DLL_API int             F_API FMUSIC_GetRow(FMUSIC_MODULE *mod);
  1081. DLL_API signed char     F_API FMUSIC_GetPaused(FMUSIC_MODULE *mod);
  1082. DLL_API int             F_API FMUSIC_GetTime(FMUSIC_MODULE *mod);
  1083. DLL_API int             F_API FMUSIC_GetRealChannel(FMUSIC_MODULE *mod, int modchannel);
  1084. DLL_API unsigned int    F_API FMUSIC_GetUserData(FMUSIC_MODULE *mod);
  1086. #ifdef __cplusplus
  1087. }
  1088. #endif
  1090. #endif