//############################################################################ //## ## //## Miles Sound System ## //## ## //## MSS.H: Miles Sound System main header file ## //## ## //## Version 1.00 of 15-Feb-95: Initial, derived from AIL.H V3.02 ## //## 1.01 of 19-Jun-95: Added various functions for V3.03 release ## //## 1.02 of 22-Nov-95: C++ typedef problem fixed, declspecs added ## //## 1.03 of 15-Feb-96: Changes for 16 bit callbacks and multiple ## //## 16 bit DLL loads (JKR) ## //## 1.04 of 2-Nov-97: Changes made to handle DLS in future ## //## versions ## //## 1.05 of 1-Jan-98: Massive changes for version 4.0 ## //## 1.06 of 17-Sep-98: Massive changes for version 5.0 ## //## 1.07 of 2-Feb-99: Changes for new input API ## //## 1.08 of 8-Feb-99: Changes for new filter helper functions ## //## ## //## Author: John Miles ## //## ## //############################################################################ //## ## //## Contact RAD Game Tools at 425-893-4300 for technical support. ## //## ## //############################################################################ #ifndef MSS_VERSION #define MSS_VERSION "6.1a" #define MSS_MAJOR_VERSION 6 #define MSS_MINOR_VERSION 1 #define MSS_SUB_VERSION 1 #define MSS_VERSION_DATE "06-Mar-01" #define MSS_COPYRIGHT "Copyright (C) 1991-2001, RAD Game Tools, Inc." #endif #ifndef MSS_H #define MSS_H // IS_DOS for DOS // IS_WINDOWS for Windows or Win32s // IS_WIN32 for Win32s // IS_WIN16 for Windows // IS_32 for 32-bit DOS or Win32s // IS_16 for 16-bit Windows // IS_LE for little endian (PCs) // IS_BE for big endian (Macs) // IS_X86 for Intel // IS_MAC for Mac // IS_PPC for PPC Mac // IS_68K for 68K Mac #ifdef IS_DOS #undef IS_DOS #endif #ifdef IS_WINDOWS #undef IS_WINDOWS #endif #ifdef IS_WIN32 #undef IS_WIN32 #endif #ifdef IS_WIN16 #undef IS_WIN16 #endif #ifdef IS_32 #undef IS_32 #endif #ifdef IS_16 #undef IS_16 #endif #ifdef IS_LE #undef IS_LE #endif #ifdef IS_BE #undef IS_BE #endif #ifdef IS_X86 #undef IS_X86 #endif #ifdef IS_MAC #undef IS_MAC #endif #ifdef IS_PPC #undef IS_PPC #endif #ifdef IS_68K #undef IS_68K #endif #ifdef __DOS__ #define IS_DOS #define IS_32 #define IS_LE #define IS_X86 #else #ifdef _WIN32 #define IS_WINDOWS #define IS_WIN32 #define IS_32 #define IS_LE #define IS_X86 #else #ifdef WIN32 #define IS_WINDOWS #define IS_WIN32 #define IS_32 #define IS_LE #define IS_X86 #else #ifdef __NT__ #define IS_WINDOWS #define IS_WIN32 #define IS_32 #define IS_LE #define IS_X86 #else #ifdef __WIN32__ #define IS_WINDOWS #define IS_WIN32 #define IS_32 #define IS_LE #define IS_X86 #else #ifdef _WINDOWS #define IS_WINDOWS #define IS_WIN16 #define IS_16 #define IS_LE #define IS_X86 #else #ifdef _WINDLL #define IS_WINDOWS #define IS_WIN16 #define IS_16 #define IS_LE #define IS_X86 #else #ifdef WINDOWS #define IS_WINDOWS #define IS_WIN16 #define IS_16 #define IS_LE #define IS_X86 #else #ifdef __WINDOWS__ #define IS_WINDOWS #define IS_WIN16 #define IS_16 #define IS_LE #define IS_X86 #else #ifdef _Windows #define IS_WINDOWS #define IS_WIN16 #define IS_16 #define IS_LE #define IS_X86 #else #if defined(macintosh) || defined(__powerc) || defined(powerc) || defined(__POWERPC__) || defined(__MC68K__) #define IS_MAC #define IS_32 #define IS_BE #if defined(__powerc) || defined(powerc) || defined(__POWERPC__) #define IS_PPC #else #if defined(__MC68K__) #define IS_68K #endif #endif #endif #endif #endif #endif #endif #endif #endif #endif #endif #endif #endif #if (!defined(IS_LE) && !defined(IS_BE)) #error MSS.H did not detect your platform. Define __DOS__, _WINDOWS, WIN32, or macintosh. #endif #if defined(_PUSHPOP_SUPPORTED) || PRAGMA_STRUCT_PACKPUSH #pragma pack(push,1) #else #pragma pack(1) #endif #ifdef __cplusplus extern "C" { #endif #ifdef IS_DOS #define AILCALLBACK __pascal #define AILEXPORT cdecl #define DXDEC extern #define DXDEF #define AILCALL cdecl #define FAR #define HIWORD(ptr) (((U32)ptr)>>16) #define LOWORD(ptr) ((U16)((U32)ptr)) #define FOURCC U32 #define MAKEFOURCC(ch0, ch1, ch2, ch3) \ ((U32)(U8)(ch0) | ((U32)(U8)(ch1) << 8) | \ ((U32)(U8)(ch2) << 16) | ((U32)(U8)(ch3) << 24 )) #define mmioFOURCC(w,x,y,z) MAKEFOURCC(w,x,y,z) #define AILLIBCALLBACK __pascal #define MSS_MAIN_DEF #define MSS_REDIST_DIR_NAME "DOS" #define MSS_DIR_SEP "\\" #define MSS_DIR_UP ".." MSS_DIR_SEP #define MSS_DIR_UP_TWO MSS_DIR_UP MSS_DIR_UP #else #ifdef IS_WINDOWS #define AILLIBCALLBACK WINAPI #ifndef WIN32_LEAN_AND_MEAN #define WIN32_LEAN_AND_MEAN #endif #ifndef WIN32_EXTRA_LEAN #define WIN32_EXTRA_LEAN #endif #ifndef STRICT #define STRICT #endif #include #include #define MSS_MAIN_DEF __cdecl // // If compiling MSS DLL, use __declspec(dllexport) for both // declarations and definitions // // If compiling MSS16 library or application, use "extern" in declarations // and nothing in definitions // #ifdef IS_WIN32 #define AILEXPORT WINAPI #ifdef BUILD_MSS #define DXDEC __declspec(dllexport) #define DXDEF __declspec(dllexport) #else #if 1 /*def __BORLANDC__*/ #define DXDEC extern #define DXDEF #else #define DXDEC __declspec(dllimport) #endif #endif #define MSSDLLNAME "MSS32.DLL" #define MSS_REDIST_DIR_NAME "WIN32" #define MSS_DIR_SEP "\\" #define MSS_DIR_UP ".." MSS_DIR_SEP #define MSS_DIR_UP_TWO MSS_DIR_UP MSS_DIR_UP #else #define AILEXPORT __export WINAPI #define DXDEC extern #define DXDEF #define MSSDLLNAME "MSS16.DLL" #define MSS_REDIST_DIR_NAME "WIN16" #define MSS_DIR_SEP "\\" #define MSS_DIR_UP ".." MSS_DIR_SEP #define MSS_DIR_UP_TWO MSS_DIR_UP MSS_DIR_UP #endif #define AILCALL WINAPI #define AILCALLBACK AILEXPORT typedef LPVOID AILLPDIRECTSOUND; typedef LPVOID AILLPDIRECTSOUNDBUFFER; #else #ifdef IS_MAC #include #include #include #include // needed for GetResource, ReleaseResource #define FAR #define AILLIBCALLBACK //pascal #define AILCALL //pascal #define AILEXPORT //pascal #define AILCALLBACK //pascal #ifdef BUILD_MSS #define DXDEC __declspec(export) #define DXDEF #else #define DXDEC extern #define DXDEF #endif #define MSS_REDIST_DIR_NAME "MAC" #define MSS_DIR_SEP ":" #define MSS_DIR_UP ":" MSS_DIR_SEP #define MSS_DIR_UP_TWO MSS_DIR_UP MSS_DIR_SEP #define HIWORD(ptr) (((U32)ptr)>>16) #define LOWORD(ptr) ((U16)((U32)ptr)) #define FOURCC U32 #ifndef MAKEFOURCC #define MAKEFOURCC(ch0, ch1, ch2, ch3) \ (((U32)(U8)(ch0) << 24) | ((U32)(U8)(ch1) << 16) | \ ((U32)(U8)(ch2) << 8) | ((U32)(U8)(ch3) )) #endif #define mmioFOURCC(w,x,y,z) MAKEFOURCC(w,x,y,z) #define MSS_MAIN_DEF #endif #endif #endif #ifndef NULL #define NULL 0 #endif // // Misc. constant definitions // #define MAX_DRVRS 16 // Max. # of simultaneous drivers #define MAX_TIMERS 16 // Max. # of simultaneous timers #define MAX_NOTES 32 // Max # of notes "on" #define FOR_NEST 4 // # of nested XMIDI FOR loops #define NUM_CHANS 16 // # of possible MIDI channels #define MAX_W_VOICES 16 // Max virtual wave synth voice cnt #define MAX_W_ENTRIES 512 // 512 wave library entries max. #ifdef IS_MAC #define MAX_INSTR 150 // Max # of instruments 128 + 32 #endif #define MIN_CHAN ( 1-1) // Min channel recognized (0-based) #define MAX_CHAN (16-1) // Max channel recognized #define MIN_LOCK_CHAN ( 2-1) // Min channel available for locking #define MAX_LOCK_CHAN ( 9-1) // Max channel available for locking #define PERCUSS_CHAN (10-1) // Percussion channel (no locking) #define AIL_MAX_FILE_HEADER_SIZE 4096 // AIL_set_named_sample_file() requires at least 4K // of data or the entire file image, whichever is less, // to determine sample format #define DIG_F_16BITS_MASK 1 #define DIG_F_STEREO_MASK 2 #define DIG_F_ADPCM_MASK 4 #define DIG_F_MONO_8 0 // PCM data formats #define DIG_F_MONO_16 (DIG_F_16BITS_MASK) #define DIG_F_STEREO_8 (DIG_F_STEREO_MASK) #define DIG_F_STEREO_16 (DIG_F_STEREO_MASK|DIG_F_16BITS_MASK) #define DIG_F_ADPCM_MONO_16 (DIG_F_ADPCM_MASK |DIG_F_16BITS_MASK) #define DIG_F_ADPCM_STEREO_16 (DIG_F_ADPCM_MASK |DIG_F_16BITS_MASK|DIG_F_STEREO_MASK) #define DIG_F_USING_ASI 16 #define DIG_PCM_SIGN 0x0001 // (obsolete) #define DIG_PCM_ORDER 0x0002 #define DIG_PCM_POLARITY 0x0004 // PCM flags used by driver hardware #define DIG_PCM_SPLIT 0x0008 #define DIG_BUFFER_SERVICE 0x0010 #define DIG_DUAL_DMA 0x0020 #define DIG_RECORDING_SUPPORTED 0x8000 #define WAVE_FORMAT_PCM 1 #define WAVE_FORMAT_IMA_ADPCM 0x0011 #ifdef IS_DOS #define AIL3DIG 0 // .DIG driver #define AIL3MDI 1 // .MDI driver #define DIG_DETECT_8_BIT_ONLY 0x0001 // Detect 8-bit DMA only #define DIG_DETECT_16_BIT_ONLY 0x0002 // Detect 16-bit DMA only #define DIG_DETECT_8_AND_16_BITS 0x0003 // Detect both 8- and 16-bit DMA #define DRV_INIT 0x300 // Functions common to .MDI and .DIG #define DRV_GET_INFO 0x301 // drivers #define DRV_SERVE 0x302 #define DRV_PARSE_ENV 0x303 #define DRV_VERIFY_IO 0x304 #define DRV_INIT_DEV 0x305 #define DRV_SHUTDOWN_DEV 0x306 #define DIG_HW_VOLUME 0x400 // .DIG driver functions #define DIG_START_P_CMD 0x401 #define DIG_STOP_P_REQ 0x402 #define DIG_START_R_CMD 0x403 #define DIG_STOP_R_REQ 0x404 #define DIG_VSE 0x405 #define MDI_HW_VOLUME 0x500 // .MDI driver functions #define MDI_INIT_INS_MGR 0x501 #define MDI_MIDI_XMIT 0x502 #define MDI_INSTALL_T_SET 0x503 #define MDI_GET_T_STATUS 0x504 #define MDI_PROT_UNPROT_T 0x505 #define MDI_VSE 0x506 #else // // Pass to AIL_midiOutOpen for NULL MIDI driver // #define MIDI_NULL_DRIVER ((U32)(S32)-2) #endif // // Non-specific XMIDI/MIDI controllers and event types // #define SYSEX_BYTE 105 #define PB_RANGE 106 #define CHAN_MUTE 107 #define CALLBACK_PFX 108 #define SEQ_BRANCH 109 #define CHAN_LOCK 110 #define CHAN_PROTECT 111 #define VOICE_PROTECT 112 #define TIMBRE_PROTECT 113 #define PATCH_BANK_SEL 114 #define INDIRECT_C_PFX 115 #define FOR_LOOP 116 #define NEXT_LOOP 117 #define CLEAR_BEAT_BAR 118 #define CALLBACK_TRIG 119 #define SEQ_INDEX 120 #define GM_BANK_MSB 0 #define MODULATION 1 #define DATA_MSB 6 #define PART_VOLUME 7 #define PANPOT 10 #define EXPRESSION 11 #define GM_BANK_LSB 32 #define DATA_LSB 38 #define SUSTAIN 64 #define REVERB 91 #define CHORUS 93 #define RPN_LSB 100 #define RPN_MSB 101 #define RESET_ALL_CTRLS 121 #define ALL_NOTES_OFF 123 #define EV_NOTE_OFF 0x80 #define EV_NOTE_ON 0x90 #define EV_POLY_PRESS 0xa0 #define EV_CONTROL 0xb0 #define EV_PROGRAM 0xc0 #define EV_CHAN_PRESS 0xd0 #define EV_PITCH 0xe0 #define EV_SYSEX 0xf0 #define EV_ESC 0xf7 #define EV_META 0xff #define META_EOT 0x2f #define META_TEMPO 0x51 #define META_TIME_SIG 0x58 // // SAMPLE.system_data[] usage // #define SSD_EOD_CALLBACK 0 // Application end-of-data callback if not NULL #define VOC_BLK_PTR 1 // Pointer to current block #define VOC_REP_BLK 2 // Pointer to beginning of repeat loop block #define VOC_N_REPS 3 // # of iterations left in repeat loop #define VOC_MARKER 4 // Marker to search for, or -1 if all #define VOC_MARKER_FOUND 5 // Desired marker found if 1, else 0 #define SSD_RELEASE 6 // Release sample handle upon termination if >0 #ifdef IS_WINDOWS #define SSD_EOD_CB_WIN32S 7 // Application end-of-data callback is in Win32s #else #define SSD_TEMP 7 // Temporary storage location for general use #endif // // Timer status values // #define AILT_FREE 0 // Timer handle is free for allocation #define AILT_STOPPED 1 // Timer is stopped #define AILT_RUNNING 2 // Timer is running // // SAMPLE.status flag values // #define SMP_FREE 0x0001 // Sample is available for allocation #define SMP_DONE 0x0002 // Sample has finished playing, or has // never been started #define SMP_PLAYING 0x0004 // Sample is playing #define SMP_STOPPED 0x0008 // Sample has been stopped #define SMP_PLAYINGBUTRELEASED 0x0010 // Sample is playing, but digital handle // has been temporarily released // // SEQUENCE.status flag values // #define SEQ_FREE 0x0001 // Sequence is available for allocation #define SEQ_DONE 0x0002 // Sequence has finished playing, or has // never been started #define SEQ_PLAYING 0x0004 // Sequence is playing #define SEQ_STOPPED 0x0008 // Sequence has been stopped #define SEQ_PLAYINGBUTRELEASED 0x0010 // Sequence is playing, but MIDI handle // has been temporarily released #ifdef IS_DOS // // MIDI driver types // #define MDIDRVRTYPE_GM 0 // General MIDI driver (Roland-compatible) #define MDIDRVRTYPE_FM_2 1 // 2-operator FM MIDI driver (OPL2) #define MDIDRVRTYPE_FM_4 2 // 4-operator FM MIDI driver (OPL3) #define MDIDRVRTYPE_SPKR 3 // Tandy or PC speaker "beep" driver // // .INI installation result codes // #define AIL_INIT_SUCCESS 0 // Driver installed successfully #define AIL_NO_INI_FILE 1 // No MDI.INI or DIG.INI file exists #define AIL_INIT_FAILURE 2 // Driver could not be initialized #ifdef __BORLANDC__ #ifndef REALPTR #define REALPTR(x) ((void *) (U32) ((((U32) (x))>>16<<4) + ((x) & 0xffff) \ - AIL_sel_base(_DS))) #endif #else #ifndef REALPTR #define REALPTR(x) ((void *) (U32) ((((U32) (x))>>16<<4) + ((x) & 0xffff))) #endif #endif #else #ifdef IS_WINDOWS // // AIL_set_direct_buffer_control() command values // #define AILDS_RELINQUISH 0 // App returns control of secondary buffer #define AILDS_SEIZE 1 // App takes control of secondary buffer #define AILDS_SEIZE_LOOP 2 // App wishes to loop the secondary buffer #endif #endif // // General type definitions for portability // #ifndef C8 #define C8 char #endif #ifndef U8 #define U8 unsigned char #endif #ifndef S8 #define S8 signed char #endif #ifndef U16 #define U16 unsigned short #endif #ifndef S16 #define S16 signed short #endif #ifndef U32 #define U32 unsigned long #endif #ifndef S32 #define S32 signed long #endif #ifndef F32 #define F32 float #endif #ifndef F64 #define F64 double #endif #ifndef REALFAR #define REALFAR unsigned long #endif #ifndef FILE_ERRS #define FILE_ERRS #define AIL_NO_ERROR 0 #define AIL_IO_ERROR 1 #define AIL_OUT_OF_MEMORY 2 #define AIL_FILE_NOT_FOUND 3 #define AIL_CANT_WRITE_FILE 4 #define AIL_CANT_READ_FILE 5 #define AIL_DISK_FULL 6 #endif #define MIN_VAL 0 #define NOM_VAL 1 #define MAX_VAL 2 #ifndef YES #define YES 1 #endif #ifndef NO #define NO 0 #endif #ifndef TRUE #define TRUE 1 #endif #ifndef FALSE #define FALSE 0 #endif // // Preference names and default values // #define DIG_RESAMPLING_TOLERANCE 0 #define DEFAULT_DRT 131 // Resampling triggered at +/- 0.2% #define DIG_MIXER_CHANNELS 1 #define DEFAULT_DMC 64 // 64 allocatable SAMPLE structures #define DIG_DEFAULT_VOLUME 2 #define DEFAULT_DDV 127 // Default sample volume = 127 (0-127) #define MDI_SERVICE_RATE 3 #define DEFAULT_MSR 120 // XMIDI sequencer timing = 120 Hz #define MDI_SEQUENCES 4 #define DEFAULT_MS 8 // 8 sequence handles/driver #define MDI_DEFAULT_VOLUME 5 #define DEFAULT_MDV 127 // Default sequence volume = 127 (0-127) #define MDI_QUANT_ADVANCE 6 #define DEFAULT_MQA 1 // Beat/bar count +1 interval #define MDI_ALLOW_LOOP_BRANCHING 7 #define DEFAULT_ALB NO // Branches cancel XMIDI FOR loops #define MDI_DEFAULT_BEND_RANGE 8 #define DEFAULT_MDBR 2 // Default pitch-bend range = 2 #ifdef IS_X86 #define MDI_DOUBLE_NOTE_OFF 9 #define DEFAULT_MDNO NO // For stuck notes on SB daughterboards #endif #define DIG_ENABLE_RESAMPLE_FILTER 31 // Enable resampling filter by #define DEFAULT_DERF YES // default #define DIG_DECODE_BUFFER_SIZE 32 // 2K decode buffer size by default #define DEFAULT_DDBS 2048 #if defined(IS_WINDOWS) || defined(IS_MAC) #define MDI_SYSEX_BUFFER_SIZE 10 #define DEFAULT_MSBS 1536 // Default sysex buffer = 1536 bytes #define DIG_OUTPUT_BUFFER_SIZE 11 #define DEFAULT_DOBS 49152 // 48K output buffer size #define AIL_MM_PERIOD 12 #define DEFAULT_AMP 5 // Default MM timer period = 5 msec. #endif #ifdef IS_WINDOWS #define DIG_DS_FRAGMENT_SIZE 34 #define DEFAULT_DDFS 8 // Use 8 millisecond buffer fragments with DirectSound if MSS mixer in use #define DIG_DS_FRAGMENT_CNT 35 #define DEFAULT_DDFC 96 // Use 96 buffer fragments with DirectSound if MSS mixer in use #define DIG_DS_MIX_FRAGMENT_CNT 42 #define DEFAULT_DDMFC 8 // Mix ahead 8 buffer fragments #define DIG_DS_USE_PRIMARY 36 #define DEFAULT_DDUP NO // Mix into secondary DirectSound buffer by default #define DIG_DS_DSBCAPS_CTRL3D 37 #define DEFAULT_DDDC NO // Do not use DSBCAPS_CTRL3D by default #define DIG_DS_CREATION_HANDLER 38 #define DEFAULT_DDCH NULL // Use DirectSoundCreate() by default #define AIL_TIMERS 13 #define DEFAULT_AT 16 // 16 allocatable HTIMER handles #define DIG_MAX_CHAIN_ELEMENT_SIZE 14 #define DEFAULT_MCES 8192 // max of 8192 bytes/waveOut buffer #define DIG_MIN_CHAIN_ELEMENT_TIME 45 #define DEFAULT_MCET 100 // 100 milliseconds buffers #define DIG_USE_WAVEOUT 15 #define DEFAULT_DUW NO // Use DirectSound by default #define DIG_DS_SECONDARY_SIZE 16 #define DEFAULT_DDSS (32*1024L) // Must be 2^n -- use 32K by default #define DIG_DS_SAMPLE_CEILING 17 #define DEFAULT_DDSC 44100 // Allow up to 44 kHz samples #define AIL_LOCK_PROTECTION 18 #define DEFAULT_ALP NO // Don't suspend foreground thread by default #define AIL_WIN32S_CALLBACK_SIZE 19 #define DEFAULT_WCS 4096 // Size of callback data in bytes #define AIL_MUTEX_PROTECTION 44 #define DEFAULT_AMPR YES // Lock each call into Miles with a mutex #else #ifdef IS_DOS #define DIG_SERVICE_RATE 10 #define DEFAULT_DSR 200 // DMA buffer-polling rate = 200 Hz #define DIG_HARDWARE_SAMPLE_RATE 11 #define DEFAULT_DHSR NOM_VAL // Use nominal sample rate by default #define DIG_DMA_RESERVE 12 #define DEFAULT_DDR 32768 // Reserve 32K real-mode mem for DMA #define DIG_LATENCY 13 #define DEFAULT_DL 100 // Half-buffer size in ms = 100 #define DIG_USE_STEREO 14 #define DEFAULT_DUS NO // Use mono output only #define DIG_USE_16_BITS 15 #define DEFAULT_DU16 NO // Use 8-bit output by default #define DIG_ALLOW_16_BIT_DMA 16 #define DEFAULT_DA16DMA YES // OK to use 16-bit DMA if necessary #define DIG_SS_LOCK 17 #define DEFAULT_DSL NO // Don't disable IRQs while mixing #define AIL_SCAN_FOR_HARDWARE 18 #define DEFAULT_ASH YES // Scan for I/O settings if necessary #define AIL_ALLOW_VDM_EXECUTION 19 #define DEFAULT_AVE YES // Allow Windows "DOS box" execution #endif #endif // ---------------------------------- // DLS Preference names and default values // Unless otherwise specified, values must be established // BEFORE calling DLSMSSOpen()! // ---------------------------------- #define DLS_TIMEBASE 20 #define DEFAULT_DTB 120 // 120 intervals/second by default #define DLS_VOICE_LIMIT 21 #define DEFAULT_DVL 24 // 24 voices supported #define DLS_BANK_SELECT_ALIAS 22 #define DEFAULT_DBSA NO // Do not treat controller 114 as bank #define DLS_STREAM_BOOTSTRAP 23 // Don't submit first stream buffer #define DEFAULT_DSB YES // until at least 2 available #define DLS_VOLUME_BOOST 24 #define DEFAULT_DVB 0 // Boost final volume by 0 dB #define DLS_ENABLE_FILTERING 25 // Filtering = on by default #define DEFAULT_DEF YES // (may be changed at any time) #ifdef IS_X86 #define AIL_ENABLE_MMX_SUPPORT 27 // Enable MMX support if present #define DEFAULT_AEMS YES // (may be changed at any time) #endif #define DLS_GM_PASSTHROUGH 28 // Pass unrecognized traffic on to #define DEFAULT_DGP YES // default GM driver layer // (may be changed at any time) #define DLS_ADPCM_TO_ASI_THRESHOLD 39 // Size in samples to switch to ASI #define DEFAULT_DATAT 32768 // // Add'l platform-independent prefs // #define DIG_REVERB_BUFFER_SIZE 40 #define DEFAULT_DRBS 0 // No reverb support by default #define DIG_INPUT_LATENCY 41 // Use >= 250-millisecond input buffers if #define DEFAULT_DIL 250 // explicit size request cannot be satisfied #ifdef IS_WINDOWS #define DIG_USE_WAVEIN 43 #define DEFAULT_DUWI YES // Use waveIn for input by default #endif #define N_PREFS 46 // # of preference types typedef struct _AILSOUNDINFO { S32 format; void const FAR* data_ptr; U32 data_len; U32 rate; S32 bits; S32 channels; U32 samples; U32 block_size; void const FAR* initial_ptr; } AILSOUNDINFO; // for multi-processor machines #ifdef IS_WIN32 #ifdef BUILD_MSS #define MSSLockedIncrement(var) _asm { lock inc [var] } #define MSSLockedDecrement(var) _asm { lock dec [var] } static void __MSSLockedIncrementAddr(void * addr) { _asm { mov eax,[addr] lock inc dword ptr [eax] } } static void __MSSLockedDecrementAddr(void * addr) { _asm { mov eax,[addr] lock dec dword ptr [eax] } } #define MSSLockedIncrementPtr(var) __MSSLockedIncrementAddr(&(var)) #define MSSLockedDecrementPtr(var) __MSSLockedDecrementAddr(&(var)) #else #define MSSLockedIncrement(var) (++var) #define MSSLockedDecrement(var) (--var) #define MSSLockedIncrementPtr(var) (++var) #define MSSLockedDecrementPtr(var) (--var) #endif #else #define MSSLockedIncrement(var) (++var) #define MSSLockedDecrement(var) (--var) #define MSSLockedIncrementPtr(var) (++var) #define MSSLockedDecrementPtr(var) (--var) #endif #ifndef RIB_H // RIB.H contents included if RIB.H not already included // #include "rib.h" #define RIB_H #define ARY_CNT(x) (sizeof((x)) / sizeof((x)[0])) // ---------------------------------- // RIB data types // ---------------------------------- typedef S32 RIBRESULT; #define RIB_NOERR 0 // Success -- no error #define RIB_NOT_ALL_AVAILABLE 1 // Some requested functions/attribs not available #define RIB_NOT_FOUND 2 // Resource not found #define RIB_OUT_OF_MEM 3 // Out of system RAM // // Handle to interface provider // typedef U32 HPROVIDER; // // Handle representing token used to obtain attribute or preference // data from RIB provider // typedef U32 HATTRIB; // // Handle representing an enumerated interface entry // // RIB_enumerate_interface() returns 1 if valid next entry found, else // 0 if end of list reached // typedef U32 HINTENUM; #define HINTENUM_FIRST 0 // // Handle representing an enumerated provider entry // // RIB_enumerate_providers() returns 1 if valid next entry found, else // 0 if end of list reached // typedef U32 HPROENUM; #define HPROENUM_FIRST 0 // // Data types for RIB attributes and preferences // typedef enum { RIB_NONE = 0, // No type RIB_CUSTOM, // Used for pointers to application-specific structures RIB_DEC, // Used for 32-bit integer values to be reported in decimal RIB_HEX, // Used for 32-bit integer values to be reported in hex RIB_FLOAT, // Used for 32-bit single-precision FP values RIB_PERCENT, // Used for 32-bit single-precision FP values to be reported as percentages RIB_BOOL, // Used for Boolean-constrained integer values to be reported as TRUE or FALSE RIB_STRING // Used for pointers to null-terminated ASCII strings } RIB_DATA_SUBTYPE; // // RIB_ENTRY_TYPE structure, used to register an interface or request one // typedef enum { RIB_FUNCTION = 0, RIB_ATTRIBUTE, // Attribute: read-only data type used for status/info communication RIB_PREFERENCE // Preference: read/write data type used to control behavior } RIB_ENTRY_TYPE; // // RIB_INTERFACE_ENTRY, used to represent a function or data entry in an // interface // typedef struct { RIB_ENTRY_TYPE type; // See list above C8 FAR *entry_name; // Name of desired function or attribute U32 token; // Function pointer or attribute token RIB_DATA_SUBTYPE subtype; // Data (attrib or preference) subtype } RIB_INTERFACE_ENTRY; // // Standard RAD Interface Broker provider identification attributes // #define PROVIDER_NAME (-100) // RIB_STRING name of decoder #define PROVIDER_VERSION (-101) // RIB_HEX BCD version number // // Standard function to obtain provider attributes (see PROVIDER_ defines // above) // // Each provider of a searchable interface must export this function // typedef U32 (AILCALL FAR *PROVIDER_QUERY_ATTRIBUTE) (HATTRIB index); // // Macros to simplify interface registrations/requests for functions, // attributes, and preferences // #define FN(entry_name) { RIB_FUNCTION, #entry_name, (U32) &(entry_name), RIB_NONE } #define REG_FN(entry_name) { RIB_FUNCTION, #entry_name, (U32) &(entry_name), RIB_NONE } #define AT(entry_name,ID) { RIB_ATTRIBUTE, (entry_name), (U32) &(ID), RIB_NONE } #define REG_AT(entry_name,ID,subtype) { RIB_ATTRIBUTE, (entry_name), (U32) (ID), subtype } #define PR(entry_name,ID) { RIB_PREFERENCE, (entry_name), (U32) &(ID), RIB_NONE } #define REG_PR(entry_name,ID,subtype) { RIB_PREFERENCE, (entry_name), (U32) (ID), subtype } #define RIB_register(x,y,z) RIB_register_interface (HPROVIDER(x), y, ARY_CNT(z), z) #define RIB_unregister(x,y,z) RIB_unregister_interface(HPROVIDER(x), y, ARY_CNT(z), z) #define RIB_unregister_all(x) RIB_unregister_interface(HPROVIDER(x), NULL, 0, NULL) #define RIB_free_libraries() RIB_free_provider_library(HPROVIDER(NULL)); #define RIB_request(x,y,z) RIB_request_interface (x, y, ARY_CNT(z), z) // ---------------------------------- // Standard RIB API prototypes // ---------------------------------- DXDEC HPROVIDER AILCALL RIB_alloc_provider_handle (U32 module); DXDEC void AILCALL RIB_free_provider_handle (HPROVIDER provider); DXDEC HPROVIDER AILCALL RIB_load_provider_library (C8 const FAR *filename); DXDEC void AILCALL RIB_free_provider_library (HPROVIDER provider); DXDEC HPROVIDER AILCALL RIB_provider_library_handle (void); DXDEC RIBRESULT AILCALL RIB_register_interface (HPROVIDER provider, C8 const FAR *interface_name, S32 entry_count, RIB_INTERFACE_ENTRY const FAR *rlist); DXDEC RIBRESULT AILCALL RIB_unregister_interface (HPROVIDER provider, C8 const FAR *interface_name, S32 entry_count, RIB_INTERFACE_ENTRY const FAR *rlist); DXDEC RIBRESULT AILCALL RIB_request_interface (HPROVIDER provider, C8 const FAR *interface_name, S32 entry_count, RIB_INTERFACE_ENTRY FAR *rlist); DXDEC RIBRESULT AILCALL RIB_request_interface_entry (HPROVIDER provider, C8 const FAR *interface_name, RIB_ENTRY_TYPE entry_type, C8 const FAR *entry_name, U32 FAR *token); DXDEC S32 AILCALL RIB_enumerate_interface (HPROVIDER provider, C8 FAR *interface_name, RIB_ENTRY_TYPE type, HINTENUM FAR *next, RIB_INTERFACE_ENTRY FAR *dest); DXDEC S32 AILCALL RIB_enumerate_providers (C8 FAR *interface_name, HPROENUM FAR *next, HPROVIDER FAR *dest); DXDEC C8 FAR * AILCALL RIB_type_string (U32 data, RIB_DATA_SUBTYPE subtype); DXDEC HPROVIDER AILCALL RIB_find_file_provider (C8 const FAR *interface_name, C8 const FAR *attribute_name, C8 const FAR *file_suffix); DXDEC HPROVIDER AILCALL RIB_find_provider (C8 const FAR *interface_name, C8 const FAR *attribute_name, C8 const FAR *attribute_value); DXDEC HPROVIDER AILCALL RIB_find_files_provider (C8 const FAR *interface_name, C8 const FAR *attribute_name_1, C8 const FAR *file_suffix_1, C8 const FAR *attribute_name_2, C8 const FAR *file_suffix_2); DXDEC HPROVIDER AILCALL RIB_find_file_dec_provider (C8 const FAR *interface_name, C8 const FAR *attribute_name_1, U32 attribute_value_1, C8 const FAR *attribute_name_2, C8 const FAR *file_suffix_2); DXDEC S32 AILCALL RIB_load_application_providers (C8 const FAR *filespec); DXDEC void AILCALL RIB_set_provider_user_data (HPROVIDER provider, U32 index, S32 value); DXDEC S32 AILCALL RIB_provider_user_data (HPROVIDER provider, U32 index); DXDEC void AILCALL RIB_set_provider_system_data (HPROVIDER provider, U32 index, S32 value); DXDEC S32 AILCALL RIB_provider_system_data (HPROVIDER provider, U32 index); DXDEC C8 FAR * AILCALL RIB_error (void); #endif #ifndef MSS_ASI_VERSION // MSSASI.H contents included if MSSASI.H not already included // #include "mssasi.h" #define AIL_ASI_VERSION 1 #define AIL_ASI_REVISION 0 // // Handle to stream being managed by ASI codec // typedef S32 HASISTREAM; // // ASI result codes // typedef S32 ASIRESULT; #define ASI_NOERR 0 // Success -- no error #define ASI_NOT_ENABLED 1 // ASI not enabled #define ASI_ALREADY_STARTED 2 // ASI already started #define ASI_INVALID_PARAM 3 // Invalid parameters used #define ASI_INTERNAL_ERR 4 // Internal error in ASI driver #define ASI_OUT_OF_MEM 5 // Out of system RAM #define ASI_ERR_NOT_IMPLEMENTED 6 // Feature not implemented #define ASI_NOT_FOUND 7 // ASI supported device not found #define ASI_NOT_INIT 8 // ASI not initialized #define ASI_CLOSE_ERR 9 // ASI not closed correctly // ---------------------------------- // Application-provided ASI callbacks // ---------------------------------- // // AILASIFETCHCB: Called by ASI to obtain data from stream source // // offset normally will be either 0 at the first call made by the codec // or -1 to specify a continuous stream, except when ASI_stream_seek() // is called to restart the stream codec at a new stream offset. In this // case, the application must execute the seek operation on the ASI codec's // behalf. // // In response to this callback, the application should read the requested // data and copy it to the specified destination buffer, returning the number // of bytes copied (which can be less than bytes_requested if the end of // the stream is reached). // typedef S32 (AILCALLBACK FAR * AILASIFETCHCB) (U32 user, // User value passed to ASI_open_stream() void FAR *dest, // Location to which stream data should be copied by app S32 bytes_requested, // # of bytes requested by ASI codec S32 offset); // If not -1, application should seek to this point in stream //############################################################################ //## ## //## Interface "ASI codec" ## //## ## //############################################################################ // // Initialize ASI stream codec // // No other ASI functions may be called outside an ASI_startup() / // ASI_shutdown() pair, except for the standard RIB function // PROVIDER_query_attribute(). All provider attributes must be accessible // without starting up the codec. // typedef ASIRESULT (AILCALL FAR *ASI_STARTUP)(void); // // Shut down ASI codec // typedef ASIRESULT (AILCALL FAR * ASI_SHUTDOWN)(void); // // Return codec error message, or NULL if no errors have occurred since // last call // // The ASI error text state is global to all streams // typedef C8 FAR * (AILCALL FAR * ASI_ERROR)(void); //############################################################################ //## ## //## Interface "ASI stream" ## //## ## //############################################################################ // // Open a stream, returning handle to stream // typedef HASISTREAM (AILCALL FAR *ASI_STREAM_OPEN) (U32 user, // User value passed to fetch callback AILASIFETCHCB fetch_CB, // Source data fetch handler U32 total_size); // Total size for %-done calculations (0=unknown) // // Translate data in stream, returning # of bytes actually decoded or encoded // // Any number of bytes may be requested. Requesting more data than is // available in the codec's internal buffer will cause the AILASIFETCHCB // handler to be called to fetch more data from the stream. // typedef S32 (AILCALL FAR *ASI_STREAM_PROCESS) (HASISTREAM stream, // Handle of stream void FAR *buffer, // Destination for processed data S32 buffer_size); // # of bytes to return in buffer // // Restart stream decoding process at new offset // // Relevant for decoders only // // Seek destination is given as offset in bytes from beginning of stream // // At next ASI_stream_process() call, decoder will seek to the closest possible // point in the stream which occurs at or after the specified position // // This function has no effect for decoders which do not support random // seeks on a given stream type // // Warning: some decoders may need to implement seeking by reparsing // the entire stream up to the specified offset, through multiple calls // to the data-fetch callback. This operation may be extremely // time-consuming on large files or slow network connections. // // A stream_offset value of -1 may be used to inform the decoder that the // application has changed the input stream offset on its own, e.g. for a // double-buffering application where the ASI decoder is not accessing the // stream directly. ASI decoders should respond to this by flushing all // internal buffers and resynchronizing themselves to the data stream. // typedef ASIRESULT (AILCALL FAR *ASI_STREAM_SEEK) (HASISTREAM stream, S32 stream_offset); // // Retrieve an ASI stream attribute or preference value by index // typedef S32 (AILCALL FAR *ASI_STREAM_ATTRIBUTE) (HASISTREAM stream, HATTRIB attrib); // // Set an ASI stream preference value by index // typedef S32 (AILCALL FAR *ASI_STREAM_SET_PREFERENCE) (HASISTREAM stream, HATTRIB preference, void const FAR * value); // // Close stream, freeing handle and all internally-allocated resources // typedef ASIRESULT (AILCALL FAR *ASI_STREAM_CLOSE) (HASISTREAM stream); #endif //############################################################################ //## ## //## Interface "MSS 3D audio services" ## //## ## //############################################################################ // // 3D positioning services // typedef struct h3DPOBJECT { U32 junk; } h3DPOBJECT; typedef h3DPOBJECT FAR * H3DPOBJECT; typedef H3DPOBJECT H3DSAMPLE; // // M3D result codes // typedef S32 M3DRESULT; #define M3D_NOERR 0 // Success -- no error #define M3D_NOT_ENABLED 1 // M3D not enabled #define M3D_ALREADY_STARTED 2 // M3D already started #define M3D_INVALID_PARAM 3 // Invalid parameters used #define M3D_INTERNAL_ERR 4 // Internal error in M3D driver #define M3D_OUT_OF_MEM 5 // Out of system RAM #define M3D_ERR_NOT_IMPLEMENTED 6 // Feature not implemented #define M3D_NOT_FOUND 7 // M3D supported device not found #define M3D_NOT_INIT 8 // M3D not initialized #define M3D_CLOSE_ERR 9 // M3D not closed correctly typedef void (AILCALLBACK FAR* AIL3DSAMPLECB) (H3DSAMPLE sample); typedef M3DRESULT (AILCALL FAR *M3D_STARTUP)(void); typedef M3DRESULT (AILCALL FAR *M3D_SHUTDOWN)(void); typedef C8 FAR * (AILCALL FAR *M3D_ERROR)(void); typedef S32 (AILCALL FAR *M3D_SET_PROVIDER_PREFERENCE)(HATTRIB preference, void const FAR * value); typedef M3DRESULT (AILCALL FAR * M3D_ACTIVATE)(S32 enable); typedef H3DSAMPLE (AILCALL FAR * M3D_ALLOCATE_3D_SAMPLE_HANDLE)(void); typedef void (AILCALL FAR * M3D_RELEASE_3D_SAMPLE_HANDLE)(H3DSAMPLE samp); typedef void (AILCALL FAR * M3D_START_3D_SAMPLE)(H3DSAMPLE samp); typedef void (AILCALL FAR * M3D_STOP_3D_SAMPLE)(H3DSAMPLE samp); typedef void (AILCALL FAR * M3D_RESUME_3D_SAMPLE)(H3DSAMPLE samp); typedef void (AILCALL FAR * M3D_END_3D_SAMPLE)(H3DSAMPLE samp); typedef S32 (AILCALL FAR * M3D_SET_3D_SAMPLE_DATA)(H3DSAMPLE samp, AILSOUNDINFO const FAR *info); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_VOLUME)(H3DSAMPLE samp, S32 volume); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_PLAYBACK_RATE)(H3DSAMPLE samp, S32 playback_rate); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_OFFSET)(H3DSAMPLE samp, U32 offset); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_LOOP_COUNT)(H3DSAMPLE samp, U32 loops); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_LOOP_BLOCK)(H3DSAMPLE S, S32 loop_start_offset, S32 loop_end_offset); typedef U32 (AILCALL FAR * M3D_3D_SAMPLE_STATUS)(H3DSAMPLE samp); typedef U32 (AILCALL FAR * M3D_3D_SAMPLE_ATTRIBUTE)(H3DSAMPLE samp, HATTRIB index); typedef S32 (AILCALL FAR * M3D_3D_SET_SAMPLE_PREFERENCE)(H3DSAMPLE samp, HATTRIB preference, void const FAR * value); typedef S32 (AILCALL FAR * M3D_3D_SAMPLE_VOLUME)(H3DSAMPLE samp); typedef S32 (AILCALL FAR * M3D_3D_SAMPLE_PLAYBACK_RATE)(H3DSAMPLE samp); typedef U32 (AILCALL FAR * M3D_3D_SAMPLE_OFFSET)(H3DSAMPLE samp); typedef U32 (AILCALL FAR * M3D_3D_SAMPLE_LENGTH)(H3DSAMPLE samp); typedef U32 (AILCALL FAR * M3D_3D_SAMPLE_LOOP_COUNT)(H3DSAMPLE samp); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_DISTANCES)(H3DSAMPLE samp, F32 max_dist, F32 min_dist); typedef void (AILCALL FAR * M3D_3D_SAMPLE_DISTANCES)(H3DSAMPLE samp, F32 FAR * max_dist, F32 FAR * min_dist); typedef S32 (AILCALL FAR * M3D_ACTIVE_3D_SAMPLE_COUNT)(void); typedef H3DPOBJECT (AILCALL FAR * M3D_3D_OPEN_LISTENER)(void); typedef void (AILCALL FAR * M3D_3D_CLOSE_LISTENER)(H3DPOBJECT listener); typedef H3DPOBJECT (AILCALL FAR * M3D_3D_OPEN_OBJECT)(void); typedef void (AILCALL FAR * M3D_3D_CLOSE_OBJECT)(H3DPOBJECT obj); typedef void (AILCALL FAR * M3D_SET_3D_POSITION)(H3DPOBJECT obj, F32 X, F32 Y, F32 Z); typedef void (AILCALL FAR * M3D_SET_3D_VELOCITY)(H3DPOBJECT obj, F32 dX_per_ms, F32 dY_per_ms, F32 dZ_per_ms, F32 magnitude); typedef void (AILCALL FAR * M3D_SET_3D_VELOCITY_VECTOR)(H3DPOBJECT obj, F32 dX_per_ms, F32 dY_per_ms, F32 dZ_per_ms); typedef void (AILCALL FAR * M3D_SET_3D_ORIENTATION)(H3DPOBJECT obj, F32 X_face, F32 Y_face, F32 Z_face, F32 X_up, F32 Y_up, F32 Z_up); typedef void (AILCALL FAR * M3D_3D_POSITION)(H3DPOBJECT obj, F32 FAR *X, F32 FAR *Y, F32 FAR *Z); typedef void (AILCALL FAR * M3D_3D_VELOCITY)(H3DPOBJECT obj, F32 FAR *dX_per_ms, F32 FAR *dY_per_ms, F32 FAR *dZ_per_ms); typedef void (AILCALL FAR * M3D_3D_ORIENTATION)(H3DPOBJECT obj, F32 FAR *X_face, F32 FAR *Y_face, F32 FAR *Z_face, F32 FAR *X_up, F32 FAR *Y_up, F32 FAR *Z_up); typedef void (AILCALL FAR * M3D_3D_UPDATE_POSITION)(H3DPOBJECT obj, F32 dt_milliseconds); typedef void (AILCALL FAR * M3D_3D_AUTO_UPDATE_POSITION)(H3DPOBJECT obj, S32 enable); typedef S32 (AILCALL FAR * M3D_3D_ROOM_TYPE)(void); typedef void (AILCALL FAR * M3D_SET_3D_ROOM_TYPE)(S32 EAX_room_type); typedef S32 (AILCALL FAR * M3D_3D_SPEAKER_TYPE)(void); typedef void (AILCALL FAR * M3D_SET_3D_SPEAKER_TYPE)(S32 speaker_type); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_OBSTRUCTION)(H3DSAMPLE samp, F32 obstruction); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_OCCLUSION)(H3DSAMPLE samp, F32 occlusion); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_EFFECTS_LEVEL)(H3DSAMPLE samp, F32 effects_level); typedef F32 (AILCALL FAR * M3D_3D_SAMPLE_OBSTRUCTION)(H3DSAMPLE samp); typedef F32 (AILCALL FAR * M3D_3D_SAMPLE_OCCLUSION)(H3DSAMPLE samp); typedef F32 (AILCALL FAR * M3D_3D_SAMPLE_EFFECTS_LEVEL)(H3DSAMPLE samp); typedef AIL3DSAMPLECB (AILCALL FAR * M3D_SET_3D_EOS)(H3DSAMPLE client,H3DSAMPLE samp,AIL3DSAMPLECB cb); typedef void (AILCALL FAR * M3D_SET_3D_SAMPLE_CONE)(H3DSAMPLE samp, F32 inner_angle, F32 outer_angle, S32 outer_volume); typedef void (AILCALL FAR * M3D_3D_SAMPLE_CONE)(H3DSAMPLE samp, F32 FAR* inner_angle, F32 FAR* outer_angle, S32 FAR* outer_volume); //############################################################################ //## ## //## Interface "MSS mixer services" ## //## ## //############################################################################ // // Operation flags used by mixer module // #define M_DEST_STEREO 1 // Set to enable stereo mixer output #define M_SRC_16 2 // Set to enable mixing of 16-bit samples #define M_FILTER 4 // Set to enable filtering when resampling #define M_SRC_STEREO 8 // Set to enable mixing of stereo input samples #define M_VOL_SCALING 16 // Set to enable volume scalars other than 2047 #define M_RESAMPLE 32 // Set to enable playback ratios other than 65536 #define M_ORDER 64 // Set to reverse L/R stereo order for sample #ifdef IS_32 // // Initialize mixer // // No other mixer functions may be called outside a MIXER_startup() / // MIXER_shutdown() pair, except for the standard RIB function // PROVIDER_query_attribute(). All provider attributes must be accessible // without starting up the module. // typedef void (AILCALL FAR *MIXER_STARTUP)(void); // // Shut down mixer // typedef void (AILCALL FAR *MIXER_SHUTDOWN)(void); // // Flush mixer buffer // typedef void (AILCALL FAR *MIXER_FLUSH) (S32 FAR *dest, S32 len, S32 FAR *reverb_buffer, S32 reverb_level #ifdef IS_X86 ,U32 MMX_available #endif ); // // Perform audio mixing operation // typedef void (AILCALL FAR *MIXER_MERGE) (void const FAR * FAR *src, U32 FAR *src_fract, void const FAR *src_end, S32 FAR * FAR *dest, void FAR *dest_end, S32 FAR *left_val, S32 FAR *right_val, S32 playback_ratio, S32 scale_left, S32 scale_right, U32 operation #ifdef IS_X86 ,U32 MMX_available #endif ); // // Translate mixer buffer contents to final output format // #ifdef IS_MAC typedef void (AILCALL FAR *MIXER_COPY) (void const FAR *src, S32 src_len, void FAR *dest, U32 operation, U32 big_endian_output); #else typedef void (AILCALL FAR *MIXER_COPY) (void const FAR *src, S32 src_len, void FAR *dest, U32 operation, U32 MMX_available); #endif #else // // Initialize mixer // // No other mixer functions may be called outside a MIXER_startup() / // MIXER_shutdown() pair, except for the standard RIB function // PROVIDER_query_attribute(). All provider attributes must be accessible // without starting up the module. // typedef void (AILCALL FAR *MIXER_STARTUP)(void); // // Shut down mixer // typedef void (AILCALL FAR *MIXER_SHUTDOWN)(void); // // Flush mixer buffer // typedef void (AILCALL FAR *MIXER_FLUSH) (S32 FAR *dest, S32 len, S32 FAR *reverb_buffer, S32 reverb_level, U32 MMX_available); // // Perform audio mixing operation // typedef void (AILCALL FAR *MIXER_MERGE) (U32 src_sel, U32 dest_sel, U32 FAR *src_fract, U32 FAR *src_offset, U32 FAR *dest_offset, U32 src_end_offset, U32 dest_end_offset, S32 FAR *left_val, S32 FAR *right_val, S32 playback_ratio, S32 scale_both, U32 operation); // // Translate mixer buffer contents to final output format // typedef void (AILCALL FAR *MIXER_COPY) (void const FAR *src, S32 src_len, void FAR *dest, U32 operation, U32 MMX_available); #endif // // Type definitions // struct _DIG_DRIVER; struct _MDI_DRIVER; typedef struct _DIG_DRIVER FAR * HDIGDRIVER; // Handle to digital driver typedef struct _MDI_DRIVER FAR * HMDIDRIVER; // Handle to XMIDI driver typedef struct _SAMPLE FAR * HSAMPLE; // Handle to sample typedef struct _SEQUENCE FAR * HSEQUENCE; // Handle to sequence typedef S32 HTIMER; // Handle to timer #ifdef IS_DOS // // Type definitions // typedef struct // I/O parameters structure { S16 IO; S16 IRQ; S16 DMA_8_bit; S16 DMA_16_bit; S32 IO_reserved[4]; } IO_PARMS; typedef struct // Standard MSS 3.X VDI driver header { S8 ID[8]; // "AIL3xxx" ID string, followed by ^Z U32 driver_version; REALFAR common_IO_configurations; U16 num_IO_configurations; REALFAR environment_string; IO_PARMS IO; S16 service_rate; U16 busy; U16 driver_num; // Driver number U16 this_ISR; // Offset of INT 66H dispatcher REALFAR prev_ISR; // Pointer to previous INT 66H ISR S8 scratch[128]; // Shared scratch workspace S8 dev_name[80]; // Device name (VDI version >= 1.12 only) } VDI_HDR; typedef struct { U16 minimum_physical_sample_rate; U16 nominal_physical_sample_rate; U16 maximum_physical_sample_rate; U16 minimum_DMA_half_buffer_size; U16 maximum_DMA_half_buffer_size; U32 flags; } DIG_MODE; typedef struct { U8 format_supported[16]; DIG_MODE format_data[16]; } DIG_DDT; typedef struct { REALFAR DMA_buffer_A; REALFAR DMA_buffer_B; S16 active_buffer; } DIG_DST; typedef struct { REALFAR library_environment; REALFAR GTL_suffix; U16 num_voices; U16 max_melodic_channel; U16 min_melodic_channel; U16 percussion_channel; } MDI_DDT; typedef struct { S8 library_directory[128]; S8 GTL_filename[128]; S8 MIDI_data[512]; } MDI_DST; typedef struct // Initialization file structure { char device_name[128]; // Device name char driver_name[128]; // Driver filename IO_PARMS IO; // I/O parameters for driver } AIL_INI; typedef struct // Handle to driver { REALFAR seg; // Seg:off pointer to driver (off=0) U32 sel; // Selector for driver (off=0) void *buf; // Protected-mode pointer to driver U32 size; // Size of driver image VDI_HDR *VHDR; // Pointer to driver header (same as buf) S32 type; // AIL3DIG or AIL3MDI (see below) S32 initialized; // 1 if hardware successfully init'd, else 0 S32 PM_ISR; // -1 if no PM ISR hooked, else IRQ # HTIMER server; // DRV_SERVE periodic timer, if requested // Vector to high-level destructor, if any void (AILCALL *destructor)(HDIGDRIVER); // High-level descriptor (DIG_ or MDI_DRIVER) void *descriptor; } AIL_DRIVER; typedef struct // VDI interface register structure { S16 AX; S16 BX; S16 CX; S16 DX; S16 SI; S16 DI; } VDI_CALL; #endif // // Function pointer types // typedef void (AILCALLBACK FAR* AILINCB) (void const FAR *data, S32 len, U32 user_data); typedef void (AILCALLBACK FAR* AILTIMERCB) (U32 user); typedef void (AILCALLBACK FAR* AILSAMPLECB) (HSAMPLE sample); typedef S32 (AILCALLBACK FAR* AILEVENTCB) (HMDIDRIVER hmi,HSEQUENCE seq,S32 status,S32 data_1,S32 data_2); typedef S32 (AILCALLBACK FAR* AILTIMBRECB) (HMDIDRIVER hmi,S32 bank,S32 patch); typedef S32 (AILCALLBACK FAR* AILPREFIXCB) (HSEQUENCE seq,S32 log,S32 data); typedef void (AILCALLBACK FAR* AILTRIGGERCB) (HSEQUENCE seq,S32 log,S32 data); typedef void (AILCALLBACK FAR* AILBEATCB) (HMDIDRIVER hmi,HSEQUENCE seq,S32 beat,S32 measure); typedef void (AILCALLBACK FAR* AILSEQUENCECB) (HSEQUENCE seq); // // Handle to sample and driver being managed by pipeline filter // typedef S32 HSAMPLESTATE; typedef S32 HDRIVERSTATE; // // Digital pipeline stages // // These are the points at which external modules may be installed into // a given HSAMPLE or HDIGDRIVER's processing pipeline // typedef enum { DP_ASI_DECODER=0, // Must be "ASI codec stream" provider DP_FILTER, // Must be "MSS pipeline filter" provider DP_MERGE, // Must be "MSS mixer" provider N_SAMPLE_STAGES, // Placeholder for end of list (= # of valid stages) SAMPLE_ALL_STAGES // Used to signify all pipeline stages, for shutdown } SAMPLESTAGE; typedef enum { DP_FLUSH = 0, // Must be "MSS mixer" provider DP_DEFAULT_FILTER, // Must be "MSS pipeline filter" provider (sets the default) DP_DEFAULT_MERGE, // Must be "MSS mixer" provider (sets the default) DP_COPY, // Must be "MSS mixer" provider N_DIGDRV_STAGES, // Placeholder for end of list (= # of valid stages) DIGDRV_ALL_STAGES // Used to signify all pipeline stages, for shutdown } DIGDRVSTAGE; typedef struct { ASI_STREAM_OPEN ASI_stream_open; ASI_STREAM_PROCESS ASI_stream_process; ASI_STREAM_SEEK ASI_stream_seek; ASI_STREAM_CLOSE ASI_stream_close; ASI_STREAM_ATTRIBUTE ASI_stream_attribute; ASI_STREAM_SET_PREFERENCE ASI_stream_set_preference; HATTRIB INPUT_BIT_RATE; HATTRIB INPUT_SAMPLE_RATE; HATTRIB INPUT_BITS; HATTRIB INPUT_CHANNELS; HATTRIB OUTPUT_BIT_RATE; HATTRIB OUTPUT_SAMPLE_RATE; HATTRIB OUTPUT_BITS; HATTRIB OUTPUT_CHANNELS; HATTRIB POSITION; HATTRIB PERCENT_DONE; HATTRIB MIN_INPUT_BLOCK_SIZE; HATTRIB RAW_RATE; HATTRIB RAW_BITS; HATTRIB RAW_CHANNELS; HATTRIB REQUESTED_RATE; HATTRIB REQUESTED_BITS; HATTRIB REQUESTED_CHANS; HASISTREAM stream; } ASISTAGE; typedef struct { MIXER_FLUSH MSS_mixer_flush; MIXER_MERGE MSS_mixer_merge; MIXER_COPY MSS_mixer_copy; } MIXSTAGE; typedef struct { struct _FLTPROVIDER FAR *provider; HSAMPLESTATE sample_state; } FLTSTAGE; typedef struct { S32 active; // Pass-through if 0, active if 1 HPROVIDER provider; union { ASISTAGE ASI; MIXSTAGE MIX; FLTSTAGE FLT; } TYPE; } DPINFO; // // Other data types // typedef struct _AIL_INPUT_INFO // Input descriptor type { U32 device_ID; // DS LPGUID or wave device ID U32 hardware_format; // e.g., DIG_F_STEREO_16 U32 hardware_rate; // e.g., 22050 AILINCB callback; // Callback function to receive incoming data S32 buffer_size; // Maximum # of bytes to be passed to callback (-1 to use DIG_INPUT_LATENCY) U32 user_data; // this is a user defined value } AIL_INPUT_INFO; typedef struct _AILTIMER // Timer instance { U32 status; AILTIMERCB callback; U32 user; S32 elapsed; S32 value; S32 callingCT; // Calling EXE's task number (16 bit only) S32 callingDS; // Calling EXE's DS (used in 16 bit only) S32 IsWin32s; // Is this a Win32s callback } AILTIMERSTR; typedef struct _ADPCMDATATAG { U32 blocksize; U32 extrasamples; U32 blockleft; U32 step; U32 savesrc; U32 sample; U32 destend; U32 srcend; U32 samplesL; U32 samplesR; U16 moresamples[16]; } ADPCMDATA; typedef struct _SAMPLE // Sample instance { char tag[4]; // HSAM HDIGDRIVER driver; // Driver for playback U32 status; // SMP_ flags: _FREE, _DONE, _PLAYING void const FAR *start[2]; // Sample buffer address (W) U32 len [2]; // Sample buffer size in bytes (W) U32 pos [2]; // Index to next byte (R/W) U32 done [2]; // Nonzero if buffer with len=0 sent by app S32 reset_ASI [2]; // Reset the ASI decoder at the end of the buffer U32 src_fract; // Fractional part of source address S32 left_val; // Mixer source value from end of last buffer S32 right_val; // Mixer source value from end of last buffer S32 current_buffer; // Buffer # active (0/1) S32 last_buffer; // Last active buffer (for double-buffering) S32 starved; // Buffer stream has run out of data S32 loop_count; // # of cycles-1 (1=one-shot, 0=indefinite) S32 loop_start; // Starting offset of loop block (0=SOF) S32 loop_end; // End offset of loop block (-1=EOF) S32 format; // DIG_F format (8/16 bits, mono/stereo) U32 flags; // DIG_PCM_SIGN / DIG_PCM_ORDER (stereo only) S32 playback_rate; // Playback rate in hertz S32 volume; // Sample volume 0-127 S32 pan; // Mono panpot/stereo balance (0=L ... 127=R) S32 left_scale; // Left/mono volume scalar 0-2047 S32 right_scale; // Right volume scalar 0-2047 S32 service_type; // 1 if single-buffered; 2 if streamed AILSAMPLECB SOB; // Start-of-block callback function AILSAMPLECB EOB; // End-of-buffer callback function AILSAMPLECB EOS; // End-of-sample callback function S32 user_data [8]; // Miscellaneous user data S32 system_data[8]; // Miscellaneous system data ADPCMDATA adpcm; #ifdef IS_WINDOWS S32 SOB_IsWin32s; // Is this a Win32s callback S32 EOB_IsWin32s; // Is this a Win32s callback S32 EOS_IsWin32s; // Is this a Win32s callback // // DirectSound-specific data // S32 secondary_buffer; // Secondary buffer index S32 service_interval; // Service sample every n ms S32 service_tick; // Current service countdown value S32 buffer_segment_size; // Buffer segment size to fill S32 prev_segment; // Previous segment # (0...n) S32 prev_cursor; // Previous play cursor location S32 bytes_remaining; // # of bytes left to play (if not -1) S32 direct_control; // 1 if app controls buffer, 0 if MSS #endif S32 doeob; // Flags to trigger callbacks S32 dosob; S32 doeos; // // Sample pipeline stages // DPINFO pipeline[N_SAMPLE_STAGES]; // // Reverb parms // F32 reverb_level; // Level [0.0, 1.0] F32 reverb_reflect_time; // Reflect time in milliseconds F32 reverb_decay_time; // Decay time [0.1, 20.0] S32 base_scale; // Original 12-bit volume scalar } SAMPLE; #if defined(IS_WINDOWS) || defined(IS_MAC) DXDEC U32 AILCALL AIL_get_timer_highest_delay (void); DXDEC void AILCALL AIL_serve(void); #ifdef IS_MAC typedef void * LPSTR; #define WHDR_DONE 0 typedef struct _WAVEIN { long temp; } * HWAVEIN; typedef struct _WAVEHDR { S32 dwFlags; S32 dwBytesRecorded; S32 dwUser; S32 temp; void * lpData; S32 dwBufferLength; S32 longdwLoops; S32 dwLoops; void * lpNext; U32 * reserved; } WAVEHDR, * LPWAVEHDR; #endif typedef struct _DIG_INPUT_DRIVER FAR *HDIGINPUT; // Handle to digital input driver typedef struct _DIG_INPUT_DRIVER // Handle to digital input driver { C8 tag[4]; // HDIN HTIMER background_timer; // Background timer handle AIL_INPUT_INFO info; // Input device descriptor S32 input_enabled; // 1 if enabled, 0 if not #ifndef IS_MAC U32 callback_user; // Callback user value // // Provider-independent data // U32 DMA_size; // Size of each DMA sub-buffer in bytes void FAR *DMA[2]; // Simulated DMA buffers U8 silence; // Silence value for current format (0 or 128) S32 device_active; // 1 if buffers submittable, 0 if not // // waveOut-specific data // HWAVEIN hWaveIn; // Handle to wave input device volatile WAVEHDR wavehdr[2]; // Handles to wave headers #else Boolean timer_started; Boolean locked; Boolean enter_lock; U32 saved_period; void* my_vars; // // Input related // U32 input_buffer_size; char * input_buffers[2]; // // Mix related // char * build_buffer; U32 build_buffer_size; // // Output related // struct { S8 * buffer; S8 * buffer_end; U32 size; S8 * right_margine; S8 * current_head; S8 * current_tail; } output_buffer; S32 mix_operation; S32 playback_ratio; U32 src_fract; S8 * current_head; S32 left_val; S32 right_val; U32 stored_sample_size; U32 stored_number_of_channels; U32 last_rw_delta; U32 period; #endif } DIG_INPUT_DRIVER; #endif typedef struct _DIG_DRIVER // Handle to digital audio driver { char tag[4]; // HDIG HTIMER backgroundtimer; // Background timer handle S32 quiet; // # of consecutive quiet sample periods S32 n_active_samples; // # of samples being processed S32 master_volume; // Master sample volume 0-127 S32 DMA_rate; // Hardware sample rate S32 hw_format; // DIG_F code in use U32 hw_mode_flags; // DIG_PCM_ flags for mode in use S32 channels_per_sample; // # of channels per sample (1 or 2) S32 bytes_per_channel; // # of bytes per channel (1 or 2) S32 channels_per_buffer; // # of channels per half-buffer S32 samples_per_buffer; // # of samples per half-buffer S32 playing; // Playback active if non-zero #ifdef IS_MAC U32 n_samples_allocated; U32 n_samples_used; U32 n_samples_played; SAMPLE *samples; // Pointer to SAMPLEs HDIGDRIVER next; // Pointer to next HDIGDRIVER in use U32 reset_works; // TRUE if OK to do waveOutReset U32 request_reset; // If nonzero, do waveOutReset ASAP S32 released; // has the sound manager been released? ExtSoundHeader sound_header; SndChannelPtr sound_channel; SndCallBackUPP global_callback; Ptr buffers[2]; Boolean loaded[2]; U32 work_buffer; U32 play_buffer; U32 load_pos; U32 load_size; Boolean load; U32 start_time; void* background_processor; #else HSAMPLE samples; // Pointer to list of SAMPLEs #endif S32 n_samples; // # of SAMPLEs S32 build_size; // # of bytes in build buffer S32 FAR *build_buffer; // Build buffer (4 * samples_per_buffer) S32 system_data[8]; // Miscellaneous system data S32 buffer_size; // Size of each output buffer #ifdef IS_WINDOWS // // waveOut-specific interface data // HWAVEOUT hWaveOut; // Wave output driver U32 reset_works; // TRUE if OK to do waveOutReset U32 request_reset; // If nonzero, do waveOutReset ASAP LPWAVEHDR first; // Pointer to first WAVEHDR in chain S32 n_buffers; // # of output WAVEHDRs in chain LPWAVEHDR volatile FAR *return_list; // Circular list of returned WAVEHDRs S32 volatile return_head; // Head of WAVEHDR list (insertion point) S32 volatile return_tail; // Tail of WAVEHDR list (retrieval point) U32 deviceid; // id from waveout open PCMWAVEFORMAT wformat; // format from waveout open // // DirectSound-specific interface data // U32 guid; // The guid id of the ds driver AILLPDIRECTSOUND pDS; // DirectSound output driver (don't // use with Smacker directly anymore!) U32 ds_priority; // priority opened with S32 emulated_ds; // is ds emulated or not? AILLPDIRECTSOUNDBUFFER lppdsb; // primary buffer or null U32 dsHwnd; // HWND used with DirectSound AILLPDIRECTSOUNDBUFFER FAR * lpbufflist; // List of pointers to secondary buffers HSAMPLE FAR *samp_list; // HSAMPLE associated with each buffer S32 FAR *sec_format; // DIG_F_ format for secondary buffer S32 max_buffs; // Max. allowable # of secondary buffers // // Misc. data // S32 released; // has the sound manager been released? U32 foreground_timer; // Foreground timer handle HDIGDRIVER next; // Pointer to next HDIGDRIVER in use S32 callingCT; // Calling EXE's task number (16 bit only) S32 callingDS; // Calling EXE's DS (used in 16 bit only) // // Vars for waveOut emulation // S32 DS_initialized; AILLPDIRECTSOUNDBUFFER DS_sec_buff; // Secondary buffer (or NULL if none) AILLPDIRECTSOUNDBUFFER DS_out_buff; // Output buffer (may be sec or prim) S32 DS_buffer_size; // Size of entire output buffer S32 DS_frag_cnt; // Total fragment count and size, and S32 DS_frag_size; // last fragment occupied by play cursor S32 DS_last_frag; S32 DS_last_write; S32 DS_last_timer; S32 DS_skip_time; S32 DS_use_default_format; // 1 to force use of default DS primary buffer format #else #ifdef IS_DOS // must be first in the DOS section void *DMA[2]; // Protected-mode pointers to half-buffers // (note that DMA[0] may != DMA_buf) REALFAR DMA_seg; // Seg:off pointer to DMA buffers (off=0) U32 DMA_sel; // Selector for DMA buffers (off=0) void *DMA_buf; // Protected-mode pointer to DMA buffers S16 *buffer_flag; // Protected-mode pointer to buffer flag S32 last_buffer; // Last active buffer flag value in driver AIL_DRIVER *drvr; // Base driver descriptor DIG_DDT *DDT; // Protected-mode pointer to DDT DIG_DST *DST; // Protected-mode pointer to DST #endif #endif #ifdef IS_X86 S32 use_MMX; // Use MMX with this driver if TRUE #endif void FAR *decode_buffer; // Buffer used by optional ASI pipeline decoder S32 decode_buffer_size; // # of bytes in decode buffer U32 us_count; U32 ms_count; U32 last_ms_polled; U32 last_percent; // // Digital driver pipeline stages // DPINFO pipeline[N_DIGDRV_STAGES]; // // Reverb buffer // S32 FAR *reverb_buffer; S32 reverb_buffer_size; S32 reverb_buffer_position; #ifdef IS_WINDOWS S32 no_wom_done; // don't process WOM_DONEs on this driver U32 wom_done_buffers; #endif } DIG_DRIVER; typedef struct // MIDI status log structure { S32 program [NUM_CHANS]; // Program Change S32 pitch_l [NUM_CHANS]; // Pitch Bend LSB S32 pitch_h [NUM_CHANS]; // Pitch Bend MSB S32 c_lock [NUM_CHANS]; // Channel Lock S32 c_prot [NUM_CHANS]; // Channel Lock Protection S32 c_mute [NUM_CHANS]; // Channel Mute S32 c_v_prot [NUM_CHANS]; // Voice Protection S32 bank [NUM_CHANS]; // Patch Bank Select S32 gm_bank_l [NUM_CHANS]; // GM Bank Select S32 gm_bank_m [NUM_CHANS]; // GM Bank Select S32 indirect [NUM_CHANS]; // ICA indirect controller value S32 callback [NUM_CHANS]; // Callback Trigger S32 mod [NUM_CHANS]; // Modulation S32 vol [NUM_CHANS]; // Volume S32 pan [NUM_CHANS]; // Panpot S32 exp [NUM_CHANS]; // Expression S32 sus [NUM_CHANS]; // Sustain S32 reverb [NUM_CHANS]; // Reverb S32 chorus [NUM_CHANS]; // Chorus S32 bend_range[NUM_CHANS]; // Bender Range (data MSB, RPN 0 assumed) S32 RPN_L [NUM_CHANS]; // RPN # LSB S32 RPN_M [NUM_CHANS]; // RPN # MSB } CTRL_LOG; typedef struct _SEQUENCE // XMIDI sequence state table { char tag[4]; // HSEQ HMDIDRIVER driver; // Driver for playback U32 status; // SEQ_ flags void const FAR *TIMB; // XMIDI IFF chunk pointers void const FAR *RBRN; void const FAR *EVNT; U8 const FAR *EVNT_ptr; // Current event pointer U8 FAR *ICA; // Indirect Controller Array AILPREFIXCB prefix_callback; // XMIDI Callback Prefix handler AILTRIGGERCB trigger_callback; // XMIDI Callback Trigger handler AILBEATCB beat_callback; // XMIDI beat/bar change handler AILSEQUENCECB EOS; // End-of-sequence callback function S32 loop_count; // 0=one-shot, -1=indefinite, ... S32 interval_count; // # of intervals until next event S32 interval_num; // # of intervals since start S32 volume; // Sequence volume 0-127 S32 volume_target; // Target sequence volume 0-127 S32 volume_accum; // Accumulated volume period S32 volume_period; // Period for volume stepping S32 tempo_percent; // Relative tempo percentage 0-100 S32 tempo_target; // Target tempo 0-100 S32 tempo_accum; // Accumulated tempo period S32 tempo_period; // Period for tempo stepping S32 tempo_error; // Error counter for tempo DDA S32 beat_count; // Sequence playback position S32 measure_count; S32 time_numerator; // Sequence timing data S32 time_fraction; S32 beat_fraction; S32 time_per_beat; void const FAR *FOR_ptrs[FOR_NEST]; // Loop stack S32 FOR_loop_count [FOR_NEST]; S32 chan_map [NUM_CHANS]; // Physical channel map for sequence CTRL_LOG shadow; // Controller values for sequence S32 note_count; // # of notes "on" S32 note_chan [MAX_NOTES]; // Channel for queued note (-1=free) S32 note_num [MAX_NOTES]; // Note # for queued note S32 note_time [MAX_NOTES]; // Remaining duration in intervals S32 user_data [8]; // Miscellaneous user data S32 system_data[8]; // Miscellaneous system data #ifdef IS_WINDOWS S32 PREFIX_IsWin32s; // Is this a Win32s callback S32 TRIGGER_IsWin32s; // Is this a Win32s callback S32 BEAT_IsWin32s; // Is this a Win32s callback S32 EOS_IsWin32s; // Is this a Win32s callback #endif } SEQUENCE; #ifdef IS_MAC struct MIDIHDR; struct MIDIOUT; typedef struct MIDIOUT* HMIDIOUT; #endif typedef struct _MDI_DRIVER // Handle to XMIDI driver { char tag[4]; // HMDI HTIMER timer; // XMIDI quantization timer S32 interval_time; // XMIDI quantization timer interval in uS S32 disable; // > 0 to disable XMIDI service HSEQUENCE sequences; // Pointer to list of SEQUENCEs S32 n_sequences; // # of SEQUENCEs S32 lock [NUM_CHANS]; // 1 if locked, 2 if protected, else 0 HSEQUENCE locker[NUM_CHANS]; // HSEQUENCE which locked channel HSEQUENCE owner [NUM_CHANS]; // HSEQUENCE which owned locked channel HSEQUENCE user [NUM_CHANS]; // Last sequence to use channel S32 state [NUM_CHANS]; // Lock state prior to being locked S32 notes [NUM_CHANS]; // # of active notes in channel AILEVENTCB event_trap; // MIDI event trap callback function AILTIMBRECB timbre_trap; // Timbre request callback function S32 master_volume; // Master XMIDI note volume 0-127 S32 system_data[8]; // Miscellaneous system data #if defined(IS_WINDOWS) || defined(IS_MAC) S32 released; // has the hmidiout handle been released U32 deviceid; // ID of the MIDI device U8 FAR *sysdata; // SysEx buffer #endif #ifdef IS_WINDOWS S32 EVENT_IsWin32s; // Is this a Win32s callback S32 TIMBRE_IsWin32s; // Is this a Win32s callback MIDIHDR FAR *mhdr; // SysEx header HMDIDRIVER next; // Pointer to next HMDIDRIVER in use S32 callingCT; // Calling EXE's task number (16 bit only) S32 callingDS; // Calling EXE's DS (used in 16 bit only) HMIDIOUT hMidiOut; // MIDI output driver #else #ifdef IS_DOS S32 message_count; // MIDI message count S32 offset; // MIDI buffer offset AIL_DRIVER *drvr; // Base driver descriptor MDI_DDT *DDT; // Protected-mode pointer to DDT MDI_DST *DST; // Protected-mode pointer to DST #else #ifdef IS_MAC struct MIDIHDR FAR *mhdr; // SysEx header HMDIDRIVER next; // Pointer to next HMDIDRIVER in use HMIDIOUT hMidiOut; // MIDI output driver U32 last_us_time; long period_counter; long current_period_sum; #endif #endif #endif } MDI_DRIVER; typedef struct // XMIDI TIMB IFF chunk { S8 name[4]; U8 msb; U8 lsb; U8 lsb2; U8 lsb3; U16 n_entries; U16 timbre[1]; } TIMB_chunk; typedef struct // XMIDI RBRN IFF entry { S16 bnum; U32 offset; } RBRN_entry; typedef struct // Wave library entry { S32 bank; // XMIDI bank, MIDI patch for sample S32 patch; S32 root_key; // Root MIDI note # for sample (or -1) U32 file_offset; // Offset of wave data from start-of-file U32 size; // Size of wave sample in bytes S32 format; // DIG_F format (8/16 bits, mono/stereo) U32 flags; // DIG_PCM_SIGN / DIG_PCM_ORDER (stereo) S32 playback_rate; // Playback rate in hertz } WAVE_ENTRY; typedef struct // Virtual "wave synthesizer" descriptor { HMDIDRIVER mdi; // MIDI driver for use with synthesizer HDIGDRIVER dig; // Digital driver for use with synthesizer WAVE_ENTRY FAR *library; // Pointer to wave library AILEVENTCB prev_event_fn; // Previous MIDI event trap function AILTIMBRECB prev_timb_fn; // Previous timbre request trap function CTRL_LOG controls; // MIDI controller states WAVE_ENTRY FAR *wave [NUM_CHANS];// Pointer to WAVE_ENTRY for each channel HSAMPLE S [MAX_W_VOICES]; // List of HSAMPLE voices S32 n_voices; // Actual # of voices allocated to synth S32 chan [MAX_W_VOICES]; // MIDI channel for each voice, or -1 S32 note [MAX_W_VOICES]; // MIDI note number for voice S32 root [MAX_W_VOICES]; // MIDI root note for voice S32 rate [MAX_W_VOICES]; // Playback rate for voice S32 vel [MAX_W_VOICES]; // MIDI note velocity for voice U32 time [MAX_W_VOICES]; // Timestamp for voice U32 event; // Event counter for LRU timestamps } WAVE_SYNTH; typedef WAVE_SYNTH FAR * HWAVESYNTH;// Handle to virtual wave synthesizer // // Handle to thread which called AIL_startup() // // This thread is suspended by MSS callback threads, to simulate DOS-style // interrupt handler behavior // #ifdef IS_WIN32 extern HANDLE hAppThread; #endif // // Background flag for timers // extern volatile S32 AIL_bkgnd_flag; // // Global preference array // extern S32 AIL_preference [N_PREFS]; // // DIG_DRIVER list // extern HDIGDRIVER DIG_first; // // MDI_DRIVER list // extern HMDIDRIVER MDI_first; // // Miscellaneous system services // #define FILE_READ_WITH_SIZE ((void FAR*)(S32)-1) #ifndef NO_OLD_SYS_FUNCTIONS #define MEM_alloc_lock AIL_mem_alloc_lock #define MEM_free_lock AIL_mem_free_lock #define FILE_error AIL_file_error #define FILE_size AIL_file_size #define FILE_read AIL_file_read #define FILE_write AIL_file_write #ifdef IS_DOS #define MEM_alloc AIL_mem_alloc #define MEM_free AIL_mem_free #define MEM_use_malloc AIL_mem_use_malloc #define MEM_use_free AIL_mem_use_free #define MEM_alloc_DOS AIL_mem_alloc_DOS #define MEM_free_DOS AIL_mem_free_DOS #define VMM_lock_range AIL_vmm_lock_range #define VMM_unlock_range AIL_vmm_unlock_range #define VMM_lock AIL_vmm_lock #define VMM_unlock AIL_vmm_unlock #endif #endif extern S32 AILCALLBACK DP_ASI_DECODER_callback(U32 user, void FAR *dest, S32 bytes_requested, S32 offset); DXDEC void FAR * AILCALL AIL_mem_alloc_lock(U32 size); DXDEC void AILCALL AIL_mem_free_lock (void FAR *ptr); DXDEC S32 AILCALL AIL_file_error (void); DXDEC S32 AILCALL AIL_file_size (char const FAR *filename); DXDEC void FAR * AILCALL AIL_file_read (char const FAR *filename, void FAR *dest); DXDEC S32 AILCALL AIL_file_write (char const FAR *filename, void const FAR *buf, U32 len); DXDEC S32 AILCALL AIL_WAV_file_write (char const FAR *filename, void const FAR *buf, U32 len, S32 rate, S32 format); DXDEC S32 AILCALL AIL_file_append (char const FAR *filename, void const FAR *buf, U32 len); #ifdef IS_MAC DXDEC S32 AILCALL AIL_file_fss_size(FSSpec const FAR *filename); DXDEC void FAR * AILCALL AIL_file_fss_read(FSSpec const FAR *filename, void FAR *dest); DXDEC S32 AILCALL AIL_file_fss_write(FSSpec const FAR *filename, void const FAR *buf, U32 len); DXDEC S32 AILCALL AIL_file_fss_attrib_write (FSSpec const FAR *filename, void const FAR *buf, U32 len, U32 type, U32 creator ); DXDEC S32 AILCALL AIL_WAV_file_fss_write (FSSpec const FAR *filename, void const FAR *buf, U32 len, S32 rate, S32 format); DXDEC void * AILCALL AIL_mem_use_malloc(void * AILCALLBACK (*fn)(U32)); DXDEC void * AILCALL AIL_mem_use_free (void AILCALLBACK (*fn)(void *)); #endif #ifdef IS_DOS extern void * AILCALLBACK (*AIL_mem_alloc) (U32); extern void AILCALLBACK (*AIL_mem_free) (void *); void * cdecl AIL_mem_use_malloc(void * AILCALLBACK (*fn)(U32)); void * cdecl AIL_mem_use_free (void AILCALLBACK (*fn)(void *)); // // Other memory-management functions // DXDEC S32 AILCALL AIL_mem_alloc_DOS (U32 n_paras, void **protected_ptr, U32 *segment_far_ptr, U32 *selector); DXDEC void AILCALL AIL_mem_free_DOS (void *protected_ptr, U32 segment_far_ptr, U32 selector); DXDEC S32 AILCALL AIL_vmm_lock_range (void *p1, void *p2); DXDEC S32 AILCALL AIL_vmm_unlock_range (void *p1, void *p2); DXDEC S32 AILCALL AIL_vmm_lock (void *start, U32 size); DXDEC S32 AILCALL AIL_vmm_unlock (void *start, U32 size); DXDEC U32 AILCALL AIL_sel_base (U32 sel); DXDEC void AILCALL AIL_sel_set_limit (U32 sel, U32 limit); // // Last IO_PARMS structure used to attempt device detection // extern IO_PARMS AIL_last_IO_attempt; // // Low-level support services // DXDEC REALFAR AILCALL AIL_get_real_vect (U32 vectnum); DXDEC void AILCALL AIL_set_real_vect (U32 vectnum, REALFAR real_ptr); DXDEC void AILCALL AIL_set_USE16_ISR (S32 IRQ, REALFAR real_base, U32 ISR_offset); DXDEC void AILCALL AIL_restore_USE16_ISR (S32 IRQ); DXDEC U32 AILCALL AIL_disable_interrupts (void); DXDEC void AILCALL AIL_restore_interrupts (U32 FD_register); DXDEC void AILCALL AIL_switch_stack (void *stack, U32 size, U32 *SS, void **ESP, void **EBP); DXDEC void AILCALL AIL_restore_stack (U32 SS, void *ESP, void *EBP); DXDEC S32 AILCALL AIL_call_driver (AIL_DRIVER *drvr, S32 fn, VDI_CALL *in, VDI_CALL *out); DXDEC S32 AILCALL AIL_read_INI (AIL_INI *INI, char *filename); DXDEC U32 AILCALL AIL_interrupt_divisor (void); #endif #ifdef __WATCOMC__ void MSSBreakPoint(); #pragma aux MSSBreakPoint = "int 3"; #else #define MSSBreakPoint() __asm {int 3} #endif // // High-level support services // #ifdef IS_MAC #if !defined(max) #define max(a,b) (((a) > (b)) ? (a) : (b)) #endif #if !defined(min) #define min(a,b) (((a) < (b)) ? (a) : (b)) #endif #endif #ifdef IS_DOS #ifdef IS_WATCOM #if !defined(max) // Watcom stdlib.h doesn't define these for C++ #define max(a,b) (((a) > (b)) ? (a) : (b)) #endif #if !defined(min) #define min(a,b) (((a) < (b)) ? (a) : (b)) #endif #endif #ifdef __SW_3R extern S32 AILCALL AIL_startup_reg (void); #define AIL_startup AIL_startup_reg #else extern S32 AILCALL AIL_startup_stack (void); #define AIL_startup AIL_startup_stack #endif #define AIL_quick_startup(ud,um,opr,opb,ops) AIL_quick_startup_with_start(&AIL_startup,ud,um,opr,opb,ops) #define AIL_get_preference(number) (AIL_preference[number]) #else DXDEC S32 AILCALL AIL_startup (void); DXDEC S32 AILCALL AIL_get_preference (U32 number); #endif DXDEC void AILCALL AIL_shutdown (void); DXDEC S32 AILCALL AIL_set_preference (U32 number, S32 value); DXDEC char FAR *AILCALL AIL_last_error (void); DXDEC void AILCALL AIL_set_error (char const FAR * error_msg); // // Low-level support services // DXDEC void #ifndef IS_MAC __cdecl #endif AIL_debug_printf (C8 const FAR *fmt, ...); #ifdef IS_X86 DXDEC U32 AILCALL AIL_MMX_available (void); #endif DXDEC void AILCALL AIL_lock (void); DXDEC void AILCALL AIL_unlock (void); #ifdef IS_WIN32 DXDEC void AILCALL AIL_lock_mutex (void); DXDEC void AILCALL AIL_unlock_mutex (void); #endif DXDEC void AILCALL AIL_delay (S32 intervals); DXDEC S32 AILCALL AIL_background (void); // // Process services // DXDEC HTIMER AILCALL AIL_register_timer (AILTIMERCB fn); DXDEC U32 AILCALL AIL_set_timer_user (HTIMER timer, U32 user); DXDEC void AILCALL AIL_set_timer_period (HTIMER timer, U32 microseconds); DXDEC void AILCALL AIL_set_timer_frequency (HTIMER timer, U32 hertz); DXDEC void AILCALL AIL_set_timer_divisor (HTIMER timer, U32 PIT_divisor); DXDEC void AILCALL AIL_start_timer (HTIMER timer); DXDEC void AILCALL AIL_start_all_timers (void); DXDEC void AILCALL AIL_stop_timer (HTIMER timer); DXDEC void AILCALL AIL_stop_all_timers (void); DXDEC void AILCALL AIL_release_timer_handle (HTIMER timer); DXDEC void AILCALL AIL_release_all_timers (void); #ifdef IS_WIN32 #ifndef BUILD_MSS // static function that handles shutdown int __cdecl MSS_auto_cleanup(void); #ifdef _MSC_VER // on MSVC, automatically register a cleanup function //ODCODENOTE Remove //#define AIL_startup() (MSS_auto_cleanup(),AIL_startup()) #endif #endif DXDEC HWND AILCALL AIL_HWND (void); #else #ifdef IS_MAC DXDEC ProcessSerialNumber AIL_Process(void); #endif #endif // // high-level digital services // DXDEC HDIGDRIVER AILCALL AIL_open_digital_driver( U32 frequency, S32 bits, S32 channel, U32 flags ); #define AIL_OPEN_DIGITAL_FORCE_PREFERENCE 1 DXDEC void AILCALL AIL_close_digital_driver( HDIGDRIVER dig ); #ifdef IS_WINDOWS #define AIL_MSS_version(str,len) \ { \ HINSTANCE l=LoadLibrary(MSSDLLNAME); \ if ((U32)l<=32) \ *(str)=0; \ else { \ LoadString(l,1,str,len); \ FreeLibrary(l); \ } \ } DXDEC S32 AILCALL AIL_waveOutOpen (HDIGDRIVER FAR *drvr, LPHWAVEOUT FAR *lphWaveOut, S32 wDeviceID, LPWAVEFORMAT lpFormat); DXDEC void AILCALL AIL_waveOutClose (HDIGDRIVER drvr); DXDEC S32 AILCALL AIL_digital_handle_release(HDIGDRIVER drvr); DXDEC S32 AILCALL AIL_digital_handle_reacquire (HDIGDRIVER drvr); #else #ifdef IS_MAC typedef struct MSS_VersionType_ { Str255 version_name; } MSS_VersionType; #define AIL_MSS_version(str,len) \ { \ long _res = OpenResFile("\pMiles Shared Library"); \ if (_res==-1) \ { \ str[0]=0; \ } \ else \ { \ Handle _H; \ short _Err; \ long _cur= CurResFile(); \ UseResFile(_res); \ _H = GetResource('vers', 2); \ _Err = ResError(); \ if((_Err != noErr) || (_H==0)) \ { \ str[0]=0; \ UseResFile(_cur); \ CloseResFile(_res); \ } \ else \ { \ if (GetHandleSize(_H)==0) \ { \ str[0]=0; \ UseResFile(_cur); \ CloseResFile(_res); \ } \ else \ { \ MSS_VersionType * _vt = (MSS_VersionType*)*_H; \ if ((U32)_vt->version_name[6]>4) \ _vt->version_name[6]-=4; \ else \ _vt->version_name[6]=0; \ if (((U32)len) <= ((U32)_vt->version_name[6])) \ _vt->version_name[6] = (U8)len-1; \ memcpy( str, _vt->version_name+11, _vt->version_name[6] ); \ str[_vt->version_name[6]]=0; \ UseResFile(_cur); \ CloseResFile(_res); \ } \ ReleaseResource(_H); \ } \ } \ } DXDEC S32 AILCALL AIL_digital_handle_release(HDIGDRIVER drvr); DXDEC S32 AILCALL AIL_digital_handle_reacquire (HDIGDRIVER drvr); #else // // DOS installation services // DXDEC IO_PARMS * AILCALL AIL_get_IO_environment (AIL_DRIVER *drvr); DXDEC AIL_DRIVER* AILCALL AIL_install_driver (U8 const *driver_image, U32 n_bytes); DXDEC void AILCALL AIL_uninstall_driver (AIL_DRIVER *drvr); DXDEC S32 AILCALL AIL_install_DIG_INI (HDIGDRIVER *dig); DXDEC HDIGDRIVER AILCALL AIL_install_DIG_driver_file (char const *filename, IO_PARMS *IO); DXDEC void AILCALL AIL_uninstall_DIG_driver (HDIGDRIVER dig); DXDEC HDIGDRIVER AILCALL AIL_install_DIG_driver_image (void const *driver_image, U32 size, IO_PARMS *IO); #endif #endif DXDEC char FAR* AILCALL AIL_set_redist_directory(char const FAR*dir); DXDEC S32 AILCALL AIL_digital_CPU_percent (HDIGDRIVER dig); DXDEC S32 AILCALL AIL_digital_latency (HDIGDRIVER dig); DXDEC HSAMPLE AILCALL AIL_allocate_sample_handle (HDIGDRIVER dig); DXDEC HSAMPLE AILCALL AIL_allocate_file_sample (HDIGDRIVER dig, void const FAR *file_image, S32 block); DXDEC void AILCALL AIL_release_sample_handle (HSAMPLE S); DXDEC void AILCALL AIL_init_sample (HSAMPLE S); DXDEC S32 AILCALL AIL_set_sample_file (HSAMPLE S, void const FAR *file_image, S32 block); DXDEC S32 AILCALL AIL_set_named_sample_file (HSAMPLE S, C8 const FAR *file_type_suffix, void const FAR *file_image, S32 file_size, S32 block); DXDEC HPROVIDER AILCALL AIL_set_sample_processor (HSAMPLE S, SAMPLESTAGE pipeline_stage, HPROVIDER provider); DXDEC HPROVIDER AILCALL AIL_set_digital_driver_processor (HDIGDRIVER dig, DIGDRVSTAGE pipeline_stage, HPROVIDER provider); DXDEC void AILCALL AIL_set_sample_adpcm_block_size (HSAMPLE S, U32 blocksize); DXDEC void AILCALL AIL_set_sample_address (HSAMPLE S, void const FAR *start, U32 len); DXDEC void AILCALL AIL_set_sample_type (HSAMPLE S, S32 format, U32 flags); DXDEC void AILCALL AIL_start_sample (HSAMPLE S); DXDEC void AILCALL AIL_stop_sample (HSAMPLE S); DXDEC void AILCALL AIL_resume_sample (HSAMPLE S); DXDEC void AILCALL AIL_end_sample (HSAMPLE S); DXDEC void AILCALL AIL_set_sample_playback_rate (HSAMPLE S, S32 playback_rate); DXDEC void AILCALL AIL_set_sample_volume (HSAMPLE S, S32 volume); DXDEC void AILCALL AIL_set_sample_pan (HSAMPLE S, S32 pan); DXDEC void AILCALL AIL_set_sample_loop_count (HSAMPLE S, S32 loop_count); DXDEC void AILCALL AIL_set_sample_loop_block (HSAMPLE S, S32 loop_start_offset, S32 loop_end_offset); DXDEC U32 AILCALL AIL_sample_status (HSAMPLE S); DXDEC S32 AILCALL AIL_sample_playback_rate (HSAMPLE S); DXDEC S32 AILCALL AIL_sample_volume (HSAMPLE S); DXDEC S32 AILCALL AIL_sample_pan (HSAMPLE S); DXDEC S32 AILCALL AIL_sample_loop_count (HSAMPLE S); DXDEC void AILCALL AIL_set_digital_master_volume (HDIGDRIVER dig, S32 master_volume); DXDEC S32 AILCALL AIL_digital_master_volume (HDIGDRIVER dig); DXDEC void AILCALL AIL_set_sample_reverb(HSAMPLE S, F32 reverb_level, F32 reverb_reflect_time, F32 reverb_decay_time); DXDEC void AILCALL AIL_sample_reverb (HSAMPLE S, F32 FAR *reverb_level, F32 FAR *reverb_reflect_time, F32 FAR *reverb_decay_time); // // low-level digital services // DXDEC S32 AILCALL AIL_minimum_sample_buffer_size(HDIGDRIVER dig, S32 playback_rate, S32 format); DXDEC S32 AILCALL AIL_sample_buffer_ready (HSAMPLE S); DXDEC void AILCALL AIL_load_sample_buffer (HSAMPLE S, U32 buff_num, void const FAR *buffer, U32 len); DXDEC void AILCALL AIL_request_EOB_ASI_reset (HSAMPLE S, U32 buff_num); DXDEC S32 AILCALL AIL_sample_buffer_info (HSAMPLE S, //) U32 FAR *pos0, U32 FAR *len0, U32 FAR *pos1, U32 FAR *len1); DXDEC U32 AILCALL AIL_sample_granularity (HSAMPLE S); DXDEC void AILCALL AIL_set_sample_position (HSAMPLE S, U32 pos); DXDEC U32 AILCALL AIL_sample_position (HSAMPLE S); DXDEC AILSAMPLECB AILCALL AIL_register_SOB_callback (HSAMPLE S, AILSAMPLECB SOB); DXDEC AILSAMPLECB AILCALL AIL_register_EOB_callback (HSAMPLE S, AILSAMPLECB EOB); DXDEC AILSAMPLECB AILCALL AIL_register_EOS_callback (HSAMPLE S, AILSAMPLECB EOS); DXDEC AILSAMPLECB AILCALL AIL_register_EOF_callback (HSAMPLE S, AILSAMPLECB EOFILE); DXDEC void AILCALL AIL_set_sample_user_data (HSAMPLE S, U32 index, S32 value); DXDEC S32 AILCALL AIL_sample_user_data (HSAMPLE S, U32 index); DXDEC S32 AILCALL AIL_active_sample_count (HDIGDRIVER dig); DXDEC void AILCALL AIL_digital_configuration (HDIGDRIVER dig, S32 FAR *rate, S32 FAR *format, char FAR *string); #ifdef IS_WIN32 DXDEC S32 AILCALL AIL_set_direct_buffer_control (HSAMPLE S, U32 command); DXDEC void AILCALL AIL_get_DirectSound_info (HSAMPLE S, AILLPDIRECTSOUND *lplpDS, AILLPDIRECTSOUNDBUFFER *lplpDSB); DXDEC S32 AILCALL AIL_set_DirectSound_HWND(HDIGDRIVER dig, HWND wnd); #endif DXDEC void AILCALL AIL_set_sample_ms_position (HSAMPLE S, //) S32 milliseconds); DXDEC void AILCALL AIL_sample_ms_position (HSAMPLE S, //) S32 FAR * total_milliseconds, S32 FAR * current_milliseconds); // // Digital input services // #if defined(IS_WINDOWS) || defined (IS_MAC) DXDEC HDIGINPUT AILCALL AIL_open_input (AIL_INPUT_INFO FAR *info); DXDEC void AILCALL AIL_close_input (HDIGINPUT dig); DXDEC AIL_INPUT_INFO FAR * AILCALL AIL_get_input_info (HDIGINPUT dig); DXDEC S32 AILCALL AIL_set_input_state (HDIGINPUT dig, S32 enable); #endif // // High-level XMIDI services // DXDEC HMDIDRIVER AILCALL AIL_open_XMIDI_driver( U32 flags ); #define AIL_OPEN_XMIDI_NULL_DRIVER 1 DXDEC void AILCALL AIL_close_XMIDI_driver( HMDIDRIVER mdi ); #ifdef IS_MAC DXDEC S32 AILCALL AIL_MIDI_handle_release (HMDIDRIVER mdi); DXDEC S32 AILCALL AIL_MIDI_handle_reacquire (HMDIDRIVER mdi); #else #ifdef IS_WINDOWS DXDEC S32 AILCALL AIL_midiOutOpen(HMDIDRIVER FAR *drvr, LPHMIDIOUT FAR *lphMidiOut, S32 dwDeviceID); DXDEC void AILCALL AIL_midiOutClose (HMDIDRIVER mdi); DXDEC S32 AILCALL AIL_MIDI_handle_release (HMDIDRIVER mdi); DXDEC S32 AILCALL AIL_MIDI_handle_reacquire (HMDIDRIVER mdi); #else #ifdef IS_DOS DXDEC S32 AILCALL AIL_install_MDI_INI (HMDIDRIVER *mdi); DXDEC HMDIDRIVER AILCALL AIL_install_MDI_driver_file (char const *filename, IO_PARMS *IO); DXDEC void AILCALL AIL_uninstall_MDI_driver (HMDIDRIVER mdi); DXDEC HMDIDRIVER AILCALL AIL_install_MDI_driver_image (void const *driver_image, U32 size, IO_PARMS *IO); DXDEC S32 AILCALL AIL_MDI_driver_type (HMDIDRIVER mdi); DXDEC void AILCALL AIL_set_GTL_filename_prefix (char const*prefix); DXDEC S32 AILCALL AIL_timbre_status (HMDIDRIVER mdi, S32 bank, S32 patch); DXDEC S32 AILCALL AIL_install_timbre (HMDIDRIVER mdi, S32 bank, S32 patch); DXDEC void AILCALL AIL_protect_timbre (HMDIDRIVER mdi, S32 bank, S32 patch); DXDEC void AILCALL AIL_unprotect_timbre (HMDIDRIVER mdi, S32 bank, S32 patch); #endif #endif #endif DXDEC HSEQUENCE AILCALL AIL_allocate_sequence_handle (HMDIDRIVER mdi); DXDEC void AILCALL AIL_release_sequence_handle (HSEQUENCE S); DXDEC S32 AILCALL AIL_init_sequence (HSEQUENCE S, void const FAR *start, S32 sequence_num); DXDEC void AILCALL AIL_start_sequence (HSEQUENCE S); DXDEC void AILCALL AIL_stop_sequence (HSEQUENCE S); DXDEC void AILCALL AIL_resume_sequence (HSEQUENCE S); DXDEC void AILCALL AIL_end_sequence (HSEQUENCE S); DXDEC void AILCALL AIL_set_sequence_tempo (HSEQUENCE S, S32 tempo, S32 milliseconds); DXDEC void AILCALL AIL_set_sequence_volume (HSEQUENCE S, S32 volume, S32 milliseconds); DXDEC void AILCALL AIL_set_sequence_loop_count (HSEQUENCE S, S32 loop_count); DXDEC U32 AILCALL AIL_sequence_status (HSEQUENCE S); DXDEC S32 AILCALL AIL_sequence_tempo (HSEQUENCE S); DXDEC S32 AILCALL AIL_sequence_volume (HSEQUENCE S); DXDEC S32 AILCALL AIL_sequence_loop_count (HSEQUENCE S); DXDEC void AILCALL AIL_set_XMIDI_master_volume (HMDIDRIVER mdi, S32 master_volume); DXDEC S32 AILCALL AIL_XMIDI_master_volume (HMDIDRIVER mdi); // // Low-level XMIDI services // DXDEC S32 AILCALL AIL_active_sequence_count (HMDIDRIVER mdi); DXDEC S32 AILCALL AIL_controller_value (HSEQUENCE S, S32 channel, S32 controller_num); DXDEC S32 AILCALL AIL_channel_notes (HSEQUENCE S, S32 channel); DXDEC void AILCALL AIL_sequence_position (HSEQUENCE S, S32 FAR *beat, S32 FAR *measure); DXDEC void AILCALL AIL_branch_index (HSEQUENCE S, U32 marker); DXDEC AILPREFIXCB AILCALL AIL_register_prefix_callback (HSEQUENCE S, AILPREFIXCB callback); DXDEC AILTRIGGERCB AILCALL AIL_register_trigger_callback (HSEQUENCE S, AILTRIGGERCB callback); DXDEC AILSEQUENCECB AILCALL AIL_register_sequence_callback (HSEQUENCE S, AILSEQUENCECB callback); DXDEC AILBEATCB AILCALL AIL_register_beat_callback (HSEQUENCE S, AILBEATCB callback); DXDEC AILEVENTCB AILCALL AIL_register_event_callback (HMDIDRIVER mdi, AILEVENTCB callback); DXDEC AILTIMBRECB AILCALL AIL_register_timbre_callback (HMDIDRIVER mdi, AILTIMBRECB callback); DXDEC void AILCALL AIL_set_sequence_user_data (HSEQUENCE S, U32 index, S32 value); DXDEC S32 AILCALL AIL_sequence_user_data (HSEQUENCE S, U32 index); DXDEC void AILCALL AIL_register_ICA_array (HSEQUENCE S, U8 FAR *array); DXDEC S32 AILCALL AIL_lock_channel (HMDIDRIVER mdi); DXDEC void AILCALL AIL_release_channel (HMDIDRIVER mdi, S32 channel); DXDEC void AILCALL AIL_map_sequence_channel (HSEQUENCE S, S32 seq_channel, S32 new_channel); DXDEC S32 AILCALL AIL_true_sequence_channel (HSEQUENCE S, S32 seq_channel); DXDEC void AILCALL AIL_send_channel_voice_message (HMDIDRIVER mdi, HSEQUENCE S, S32 status, S32 data_1, S32 data_2); DXDEC void AILCALL AIL_send_sysex_message (HMDIDRIVER mdi, void const FAR *buffer); DXDEC HWAVESYNTH AILCALL AIL_create_wave_synthesizer (HDIGDRIVER dig, HMDIDRIVER mdi, void const FAR *wave_lib, S32 polyphony); DXDEC void AILCALL AIL_destroy_wave_synthesizer (HWAVESYNTH W); DXDEC void AILCALL AIL_set_sequence_ms_position (HSEQUENCE S, //) S32 milliseconds); DXDEC void AILCALL AIL_sequence_ms_position(HSEQUENCE S, //) S32 FAR *total_milliseconds, S32 FAR *current_milliseconds); // // red book functions // #ifdef IS_DOS typedef struct _REDBOOKTRACKINFO { U32 tracks; U32 trackstarts[100]; } REDBOOKTRACKINFO; #endif typedef struct _REDBOOK { U32 DeviceID; U32 paused; U32 pausedsec; U32 lastendsec; #ifdef IS_DOS U32 readcontents; REDBOOKTRACKINFO info; #endif #ifdef IS_MAC short vDRefNum; #endif } REDBOOK; typedef struct _REDBOOK FAR* HREDBOOK; #define REDBOOK_ERROR 0 #define REDBOOK_PLAYING 1 #define REDBOOK_PAUSED 2 #define REDBOOK_STOPPED 3 DXDEC HREDBOOK AILCALL AIL_redbook_open(U32 which); #ifdef IS_MAC DXDEC HREDBOOK AILCALL AIL_redbook_open_volume(char const * drive); #else DXDEC HREDBOOK AILCALL AIL_redbook_open_drive(S32 drive); #endif DXDEC void AILCALL AIL_redbook_close(HREDBOOK hand); DXDEC void AILCALL AIL_redbook_eject(HREDBOOK hand); DXDEC void AILCALL AIL_redbook_retract(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_status(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_tracks(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_track(HREDBOOK hand); DXDEC void AILCALL AIL_redbook_track_info(HREDBOOK hand,U32 tracknum, U32 FAR* startmsec,U32 FAR* endmsec); DXDEC U32 AILCALL AIL_redbook_id(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_position(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_play(HREDBOOK hand,U32 startmsec, U32 endmsec); DXDEC U32 AILCALL AIL_redbook_stop(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_pause(HREDBOOK hand); DXDEC U32 AILCALL AIL_redbook_resume(HREDBOOK hand); DXDEC S32 AILCALL AIL_redbook_volume(HREDBOOK hand); DXDEC S32 AILCALL AIL_redbook_set_volume(HREDBOOK hand, S32 volume); #ifdef IS_WIN16 #define AIL_ms_count timeGetTime DXDEC U32 AILCALL AIL_us_count(void); #else DXDEC U32 AILCALL AIL_ms_count(void); DXDEC U32 AILCALL AIL_us_count(void); #endif typedef struct _STREAM FAR* HSTREAM; // Handle to stream typedef void (AILCALLBACK FAR* AILSTREAMCB) (HSTREAM stream); typedef struct _STREAM { S32 block_oriented; // 1 if this is an ADPCM or ASI-compressed stream S32 using_ASI; // 1 if using ASI decoder to uncompress stream data ASISTAGE FAR *ASI; // handy pointer to our ASI coded HSAMPLE samp; // the sample handle U32 fileh; // the open file handle U8 FAR* bufs[3]; // the data buffers U32 bufsizes[3]; // the size of each buffer S32 reset_ASI[3]; // should we reset the ASI at the end of the buffer? S32 bufstart[3]; // offset of where this buffer started void FAR* asyncs[3];// async read structures S32 loadedbufstart[2]; // offset of where the loaded buffer started S32 loadedorder[2]; // order of the buffers as they were loaded S32 loadorder; // incremented as each buffer is loaded S32 bufsize; // size of each buffer S32 readsize; // size of each read block U32 buf1; // 0,1,2 (current buffer that we are reading into) S32 size1; // holds the current amount of data read U32 buf2; // 0,1,2 (the next buffer that we are reading into) S32 size2; // next buffer loaded up to U32 buf3; // 0,1,2 (the next buffer that we are reading into) S32 size3; // next buffer loaded up to U32 datarate; // datarate in bytes per second S32 filerate; // original datarate of the file S32 filetype; // file format type U32 fileflags; // file format flags (signed or unsigned) S32 totallen; // total length of the sound data S32 substart; // subblock loop start S32 sublen; // subblock loop len S32 subpadding; // amount to pad the final block U32 blocksize; // ADPCM block size S32 padding; // padding to be done S32 padded; // padding done S32 loadedsome; // have we done any loads? U32 startpos; // point that the sound data begins U32 totalread; // total bytes read from the disk U32 loopsleft; // how many loops are left U32 error; // read error has occurred S32 preload; // preload the file into the first buffer U32 preloadpos; // position to use in preload S32 noback; // no background processing S32 alldone; // alldone S32 primeamount; // amount to load after a seek S32 readatleast; // forced amount to read on next service S32 playcontrol; // control: 0=stopped, 1=started, |8=paused, |16=sample paused AILSTREAMCB callback; // end of stream callback S32 user_data[8]; // Miscellaneous user data void FAR* next; // pointer to next stream #if defined(IS_WINDOWS) || defined(IS_MAC) S32 autostreaming; // are we autostreaming this stream #endif #ifdef IS_WINDOWS S32 cb_IsWin32s; // Is the callback win32s? #endif S32 docallback; // set when it time to poll for a callback #ifdef IS_MAC IOParam stream_param; S32 donext; S32 donext1; U32 fillup; U32 session; U32 tamt; U32 buf; S32* size; S32* done; S32 done1; S32 done2; S32 done3; Boolean force_quit; #endif } MSTREAM_TYPE; DXDEC HSTREAM AILCALL AIL_open_stream(HDIGDRIVER dig, char const FAR * filename, S32 stream_mem); DXDEC void AILCALL AIL_close_stream(HSTREAM stream); DXDEC S32 AILCALL AIL_service_stream(HSTREAM stream, S32 fillup); DXDEC void AILCALL AIL_start_stream(HSTREAM stream); DXDEC void AILCALL AIL_pause_stream(HSTREAM stream, S32 onoff); DXDEC void AILCALL AIL_set_stream_volume(HSTREAM stream,S32 volume); DXDEC void AILCALL AIL_set_stream_pan(HSTREAM stream,S32 pan); DXDEC S32 AILCALL AIL_stream_volume(HSTREAM stream); DXDEC S32 AILCALL AIL_stream_pan(HSTREAM stream); DXDEC void AILCALL AIL_set_stream_playback_rate(HSTREAM stream, S32 rate); DXDEC S32 AILCALL AIL_stream_playback_rate(HSTREAM stream); DXDEC S32 AILCALL AIL_stream_loop_count(HSTREAM stream); DXDEC void AILCALL AIL_set_stream_loop_count(HSTREAM stream, S32 count); DXDEC void AILCALL AIL_set_stream_loop_block (HSTREAM S, S32 loop_start_offset, S32 loop_end_offset); DXDEC S32 AILCALL AIL_stream_status(HSTREAM stream); DXDEC void AILCALL AIL_set_stream_position(HSTREAM stream,S32 offset); DXDEC S32 AILCALL AIL_stream_position(HSTREAM stream); DXDEC void AILCALL AIL_stream_info(HSTREAM stream, S32 FAR* datarate, S32 FAR* sndtype, S32 FAR* length, S32 FAR* memory); DXDEC AILSTREAMCB AILCALL AIL_register_stream_callback(HSTREAM stream, AILSTREAMCB callback); DXDEC void AILCALL AIL_auto_service_stream(HSTREAM stream, S32 onoff); DXDEC void AILCALL AIL_set_stream_user_data (HSTREAM S, U32 index, S32 value); DXDEC S32 AILCALL AIL_stream_user_data (HSTREAM S, U32 index); DXDEC void AILCALL AIL_set_stream_ms_position (HSTREAM S, S32 milliseconds); DXDEC void AILCALL AIL_stream_ms_position (HSTREAM S, //) S32 FAR * total_milliseconds, S32 FAR * current_milliseconds); DXDEC void AILCALL AIL_set_stream_reverb(HSTREAM S, F32 reverb_level, F32 reverb_reflect_time, F32 reverb_decay_time); DXDEC void AILCALL AIL_stream_reverb (HSTREAM S, F32 FAR *reverb_level, F32 FAR *reverb_reflect_time, F32 FAR *reverb_decay_time); DXDEC HPROVIDER AILCALL AIL_set_stream_processor (HSTREAM S, SAMPLESTAGE pipeline_stage, HPROVIDER provider); #ifdef IS_MAC typedef struct MSS_FILE { S32 file_type; // 0 = char*, 1 = FSSpec* void const FAR* file; } MSS_FILE; #else typedef char MSS_FILE; #endif typedef U32 (AILCALLBACK FAR*AIL_file_open_callback) (MSS_FILE const FAR* Filename, U32 FAR* FileHandle); typedef void (AILCALLBACK FAR*AIL_file_close_callback) (U32 FileHandle); #define AIL_FILE_SEEK_BEGIN 0 #define AIL_FILE_SEEK_CURRENT 1 #define AIL_FILE_SEEK_END 2 typedef S32 (AILCALLBACK FAR*AIL_file_seek_callback) (U32 FileHandle, S32 Offset, U32 Type); typedef U32 (AILCALLBACK FAR*AIL_file_read_callback) (U32 FileHandle, void FAR* Buffer, U32 Bytes); DXDEC void AILCALL AIL_set_file_callbacks (AIL_file_open_callback opencb, AIL_file_close_callback closecb, AIL_file_seek_callback seekcb, AIL_file_read_callback readcb); #ifdef IS_32 typedef void FAR* (AILCALLBACK FAR*AIL_file_async_read_callback) (U32 FileHandle, void FAR* Buffer, U32 Bytes); typedef S32 (AILCALLBACK FAR*AIL_file_async_status_callback) (void FAR* async, S32 wait, U32 FAR* BytesRead); DXDEC void AILCALL AIL_set_file_async_callbacks (AIL_file_open_callback opencb, AIL_file_close_callback closecb, AIL_file_seek_callback seekcb, AIL_file_async_read_callback areadcb, AIL_file_async_status_callback statuscb); #endif // // High-level DLS functions // typedef struct _DLSFILEID { S32 id; struct _DLSFILEID FAR* next; } DLSFILEID; typedef struct _DLSFILEID FAR* HDLSFILEID; typedef struct _DLSDEVICE { void FAR* pGetPref; void FAR* pSetPref; void FAR* pMSSOpen; void FAR* pOpen; void FAR* pClose; void FAR* pLoadFile; void FAR* pLoadMem; void FAR* pUnloadFile; void FAR* pUnloadAll; void FAR* pGetInfo; void FAR* pCompact; void FAR* pSetAttr; S32 DLSHandle; U32 format; U32 buffer_size; void FAR* buffer[2]; HSAMPLE sample; HMDIDRIVER mdi; HDIGDRIVER dig; HDLSFILEID first; #ifdef IS_WINDOWS HMODULE lib; #else #ifdef IS_DOS char FAR* DOSname; #endif #endif } DLSDEVICE; typedef struct _DLSDEVICE FAR* HDLSDEVICE; typedef struct _AILDLSINFO { char Description[128]; S32 MaxDLSMemory; S32 CurrentDLSMemory; S32 LargestSize; S32 GMAvailable; S32 GMBankSize; } AILDLSINFO; #ifdef IS_DOS typedef struct _AILDOSDLS { char FAR* description; void FAR* pDLSOpen; void FAR* pMSSOpen; void FAR* pOpen; void FAR* pClose; void FAR* pLoadFile; void FAR* pLoadMem; void FAR* pUnloadFile; void FAR* pUnloadAll; void FAR* pGetInfo; void FAR* pCompact; void FAR* pSetAttr; } AILDOSDLS; #endif DXDEC HDLSDEVICE AILCALL AIL_DLS_open(HMDIDRIVER mdi, HDIGDRIVER dig, #if defined(IS_WINDOWS) || defined(IS_MAC) char const FAR * libname, #else AILDOSDLS const FAR * dosdls, #endif U32 flags, U32 rate, S32 bits, S32 channels); // // Parameters for the dwFlag used in DLSClose() and flags in AIL_DLS_close // #define RETAIN_DLS_COLLECTION 0x00000001 #define RETURN_TO_BOOTUP_STATE 0x00000002 #define RETURN_TO_GM_ONLY_STATE 0x00000004 #define DLS_COMPACT_MEMORY 0x00000008 DXDEC void AILCALL AIL_DLS_close(HDLSDEVICE dls, U32 flags); DXDEC HDLSFILEID AILCALL AIL_DLS_load_file(HDLSDEVICE dls, char const FAR* filename, U32 flags); DXDEC HDLSFILEID AILCALL AIL_DLS_load_memory(HDLSDEVICE dls, void const FAR* memfile, U32 flags); // // other parameters for AIL_DLS_unload // #define AIL_DLS_UNLOAD_MINE 0 #define AIL_DLS_UNLOAD_ALL ((HDLSFILEID)(U32)(S32)-1) DXDEC void AILCALL AIL_DLS_unload(HDLSDEVICE dls, HDLSFILEID dlsid); DXDEC void AILCALL AIL_DLS_compact(HDLSDEVICE dls); DXDEC void AILCALL AIL_DLS_get_info(HDLSDEVICE dls, AILDLSINFO FAR* info, S32 FAR* PercentCPU); DXDEC void AILCALL AIL_DLS_set_reverb(HDLSDEVICE dls, F32 reverb_level, F32 reverb_reflect_time, F32 reverb_decay_time); DXDEC void AILCALL AIL_DLS_get_reverb(HDLSDEVICE dls, F32 FAR* reverb_level, F32 FAR* reverb_reflect_time, F32 FAR* reverb_decay_time); DXDEC HPROVIDER AILCALL AIL_set_DLS_processor (HDLSDEVICE dev, SAMPLESTAGE pipeline_stage, HPROVIDER provider); // // Quick-integration service functions and data types // typedef struct { U32 const FAR *data; S32 size; S32 type; void FAR *handle; S32 status; void FAR* next; S32 speed; S32 volume; S32 extravol; F32 rlevel; F32 rrtime; F32 rdtime; HDLSFILEID dlsid; void FAR* dlsmem; void FAR* dlsmemunc; S32 milliseconds; S32 length; S32 userdata; } AUDIO_TYPE; #define QSTAT_DONE 1 // Data has finished playing #define QSTAT_LOADED 2 // Data has been loaded, but not yet played #define QSTAT_PLAYING 3 // Data is currently playing typedef AUDIO_TYPE FAR * HAUDIO; // Generic handle to any audio data type #define AIL_QUICK_USE_WAVEOUT 2 #define AIL_QUICK_MIDI_AND_DLS 2 #define AIL_QUICK_DLS_ONLY 3 #define AIL_QUICK_MIDI_AND_VORTEX_DLS 4 #define AIL_QUICK_MIDI_AND_SONICVIBES_DLS 5 DXDEC S32 AILCALL #if defined(IS_WINDOWS) || defined(IS_MAC) AIL_quick_startup ( #else AIL_quick_startup_with_start(void* startup, #endif S32 use_digital, S32 use_MIDI, U32 output_rate, S32 output_bits, S32 output_channels); DXDEC void AILCALL AIL_quick_shutdown (void); DXDEC void AILCALL AIL_quick_handles (HDIGDRIVER FAR* pdig, HMDIDRIVER FAR* pmdi, HDLSDEVICE FAR* pdls ); DXDEC HAUDIO AILCALL AIL_quick_load (char const FAR *filename); #ifdef IS_MAC DXDEC HAUDIO AILCALL AIL_quick_fss_load (FSSpec const FAR *filename); #endif DXDEC HAUDIO AILCALL AIL_quick_load_mem (void const FAR *mem, U32 size); DXDEC HAUDIO AILCALL AIL_quick_copy (HAUDIO audio); DXDEC void AILCALL AIL_quick_unload (HAUDIO audio); DXDEC S32 AILCALL AIL_quick_play (HAUDIO audio, U32 loop_count); DXDEC void AILCALL AIL_quick_halt (HAUDIO audio); DXDEC S32 AILCALL AIL_quick_status (HAUDIO audio); DXDEC HAUDIO AILCALL AIL_quick_load_and_play (char const FAR *filename, U32 loop_count, S32 wait_request); #ifdef IS_MAC DXDEC HAUDIO AILCALL AIL_quick_fss_load_and_play (FSSpec const FAR *filename, U32 loop_count, S32 wait_request); #endif DXDEC void AILCALL AIL_quick_set_speed (HAUDIO audio, S32 speed); DXDEC void AILCALL AIL_quick_set_volume (HAUDIO audio, S32 volume, S32 extravol); DXDEC void AILCALL AIL_quick_set_reverb (HAUDIO audio, F32 reverb_level, F32 reverb_reflect_time, F32 reverb_decay_time); DXDEC void AILCALL AIL_quick_set_ms_position(HAUDIO audio,S32 milliseconds); DXDEC S32 AILCALL AIL_quick_ms_position(HAUDIO audio); DXDEC S32 AILCALL AIL_quick_ms_length(HAUDIO audio); #define AIL_QUICK_XMIDI_TYPE 1 #define AIL_QUICK_DIGITAL_TYPE 2 #define AIL_QUICK_DLS_XMIDI_TYPE 3 #define AIL_QUICK_MPEG_DIGITAL_TYPE 4 DXDEC S32 AILCALL AIL_quick_type(HAUDIO audio); // // used for AIL_process // typedef struct _AILMIXINFO { AILSOUNDINFO Info; ADPCMDATA mss_adpcm; U32 src_fract; S32 left_val; S32 right_val; } AILMIXINFO; DXDEC S32 AILCALL AIL_WAV_info(void const FAR* data, AILSOUNDINFO FAR* info); DXDEC S32 AILCALL AIL_size_processed_digital_audio( U32 dest_rate, U32 dest_format, S32 num_srcs, AILMIXINFO const FAR* src); DXDEC S32 AILCALL AIL_process_digital_audio( void FAR *dest_buffer, S32 dest_buffer_size, U32 dest_rate, U32 dest_format, S32 num_srcs, AILMIXINFO FAR* src); #define AIL_LENGTHY_INIT 0 #define AIL_LENGTHY_SET_PREFERENCE 1 #define AIL_LENGTHY_UPDATE 2 #define AIL_LENGTHY_DONE 3 typedef S32 (AILCALLBACK FAR* AILLENGTHYCB)(U32 state,U32 user); typedef S32 (AILCALLBACK FAR* AILCODECSETPREF)(char const FAR* preference,U32 value); DXDEC S32 AILCALL AIL_compress_ASI(AILSOUNDINFO const FAR * info, //) char const FAR* filename_ext, void FAR* FAR* outdata, U32 FAR* outsize, AILLENGTHYCB callback); DXDEC S32 AILCALL AIL_decompress_ASI(void const FAR* indata, //) U32 insize, char const FAR* filename_ext, void FAR* FAR* wav, U32 FAR* wavsize, AILLENGTHYCB callback); DXDEC S32 AILCALL AIL_compress_ADPCM(AILSOUNDINFO const FAR * info, void FAR* FAR* outdata, U32 FAR* outsize); DXDEC S32 AILCALL AIL_decompress_ADPCM(AILSOUNDINFO const FAR * info, void FAR* FAR* outdata, U32 FAR* outsize); DXDEC S32 AILCALL AIL_compress_DLS(void const FAR* dls, char const FAR* compression_extension, void FAR* FAR* mls, U32 FAR* mlssize, AILLENGTHYCB callback); DXDEC S32 AILCALL AIL_merge_DLS_with_XMI(void const FAR* xmi, void const FAR* dls, void FAR* FAR* mss, U32 FAR* msssize); DXDEC S32 AILCALL AIL_extract_DLS( void const FAR *source_image, //) U32 source_size, void FAR * FAR *XMI_output_data, U32 FAR *XMI_output_size, void FAR * FAR *DLS_output_data, U32 FAR *DLS_output_size, AILLENGTHYCB callback); #define AILFILTERDLS_USINGLIST 1 DXDEC S32 AILCALL AIL_filter_DLS_with_XMI(void const FAR* xmi, void const FAR* dls, void FAR* FAR* dlsout, U32 FAR* dlssize, S32 flags, AILLENGTHYCB callback); #define AILMIDITOXMI_USINGLIST 1 #define AILMIDITOXMI_TOLERANT 2 DXDEC S32 AILCALL AIL_MIDI_to_XMI (void const FAR* MIDI, U32 MIDI_size, void FAR* FAR*XMIDI, U32 FAR* XMIDI_size, S32 flags); #define AILMIDILIST_ROLANDSYSEX 1 #define AILMIDILIST_ROLANDUN 2 #define AILMIDILIST_ROLANDAB 4 DXDEC S32 AILCALL AIL_list_MIDI (void const FAR* MIDI, U32 MIDI_size, char FAR* FAR* lst, U32 FAR* lst_size, S32 flags); #define AILDLSLIST_ARTICULATION 1 #define AILDLSLIST_DUMP_WAVS 2 DXDEC S32 AILCALL AIL_list_DLS (void const FAR* DLS, char FAR* FAR* lst, U32 FAR* lst_size, S32 flags, C8 FAR* title); #define AILFILETYPE_UNKNOWN 0 #define AILFILETYPE_PCM_WAV 1 #define AILFILETYPE_ADPCM_WAV 2 #define AILFILETYPE_OTHER_WAV 3 #define AILFILETYPE_VOC 4 #define AILFILETYPE_MIDI 5 #define AILFILETYPE_XMIDI 6 #define AILFILETYPE_XMIDI_DLS 7 #define AILFILETYPE_XMIDI_MLS 8 #define AILFILETYPE_DLS 9 #define AILFILETYPE_MLS 10 #define AILFILETYPE_MPEG_L1_AUDIO 11 #define AILFILETYPE_MPEG_L2_AUDIO 12 #define AILFILETYPE_MPEG_L3_AUDIO 13 #define AILFILETYPE_OTHER_ASI_WAV 14 DXDEC S32 AILCALL AIL_file_type(void const FAR* data, U32 size); DXDEC S32 AILCALL AIL_find_DLS (void const FAR* data, U32 size, void FAR* FAR* xmi, U32 FAR* xmisize, void FAR* FAR* dls, U32 FAR* dlssize); #if defined(IS_WIN32) || defined(IS_MAC) // // Auxiliary 2D interface calls // DXDEC HDIGDRIVER AILCALL AIL_primary_digital_driver (HDIGDRIVER new_primary); // // Filter result codes // typedef S32 FLTRESULT; #define FLT_NOERR 0 // Success -- no error #define FLT_NOT_ENABLED 1 // FLT not enabled #define FLT_ALREADY_STARTED 2 // FLT already started #define FLT_INVALID_PARAM 3 // Invalid parameters used #define FLT_INTERNAL_ERR 4 // Internal error in FLT driver #define FLT_OUT_OF_MEM 5 // Out of system RAM #define FLT_ERR_NOT_IMPLEMENTED 6 // Feature not implemented #define FLT_NOT_FOUND 7 // FLT supported device not found #define FLT_NOT_INIT 8 // FLT not initialized #define FLT_CLOSE_ERR 9 // FLT not closed correctly //############################################################################ //## ## //## Interface "MSS pipeline filter" ## //## ## //############################################################################ typedef FLTRESULT (AILCALL FAR *FLT_STARTUP)(void); typedef FLTRESULT (AILCALL FAR *FLT_SHUTDOWN)(void); typedef C8 FAR * (AILCALL FAR *FLT_ERROR)(void); typedef S32 (AILCALL FAR *FLT_SET_PROVIDER_PREFERENCE)(HATTRIB preference, void const FAR* value); typedef HDRIVERSTATE (AILCALL FAR *FLT_OPEN_DRIVER) (HDIGDRIVER dig, S32 FAR *build_buffer, S32 build_buffer_size); typedef FLTRESULT (AILCALL FAR *FLT_CLOSE_DRIVER) (HDRIVERSTATE state); typedef void (AILCALL FAR *FLT_PREMIX_PROCESS) (HDRIVERSTATE driver #ifdef IS_MAC ,U32 buffer_size #endif ); typedef void (AILCALL FAR *FLT_POSTMIX_PROCESS) (HDRIVERSTATE driver #ifdef IS_MAC ,U32 buffer_size #endif ); //############################################################################ //## ## //## Interface "Pipeline filter sample services" ## //## ## //############################################################################ typedef HSAMPLESTATE (AILCALL FAR * FLTSMP_OPEN_SAMPLE) (HDRIVERSTATE driver, HSAMPLE S); typedef FLTRESULT (AILCALL FAR * FLTSMP_CLOSE_SAMPLE) (HSAMPLESTATE state); typedef S32 (AILCALL FAR * FLTSMP_SAMPLE_PROCESS) (HSAMPLESTATE state, void const FAR * FAR *orig_src, U32 FAR * orig_src_fract, void FAR * orig_src_end, S32 FAR * FAR *build_dest, void FAR * build_dest_end, S32 FAR * left_val, S32 FAR * right_val, S32 playback_ratio, S32 left_scale, S32 right_scale, S32 base_scale, MIXSTAGE FAR * mixer_provider, U32 mixer_operation); typedef S32 (AILCALL FAR * FLTSMP_SAMPLE_ATTRIBUTE) (HSAMPLESTATE state, HATTRIB attribute); typedef S32 (AILCALL FAR * FLTSMP_SET_SAMPLE_PREFERENCE) (HSAMPLESTATE state, HATTRIB preference, void const FAR* value); // // Pipeline filter calls // DXDEC S32 AILCALL AIL_enumerate_filters (HPROENUM FAR *next, HPROVIDER FAR *dest, C8 FAR * FAR *name); DXDEC HDRIVERSTATE AILCALL AIL_open_filter (HPROVIDER lib, HDIGDRIVER dig); DXDEC void AILCALL AIL_close_filter (HDRIVERSTATE filter); DXDEC S32 AILCALL AIL_enumerate_filter_attributes (HPROVIDER lib, HINTENUM FAR * next, RIB_INTERFACE_ENTRY FAR * dest); DXDEC void AILCALL AIL_filter_attribute (HPROVIDER lib, C8 const FAR* name, void FAR * val); DXDEC void AILCALL AIL_set_filter_preference (HPROVIDER lib, C8 const FAR* name, void const FAR* val); DXDEC S32 AILCALL AIL_enumerate_filter_sample_attributes (HPROVIDER lib, HINTENUM FAR * next, RIB_INTERFACE_ENTRY FAR * dest); DXDEC void AILCALL AIL_filter_sample_attribute (HSAMPLE S, C8 const FAR* name, void FAR * val); DXDEC void AILCALL AIL_filter_stream_attribute (HSTREAM S, C8 const FAR* name, void FAR* val); DXDEC void AILCALL AIL_filter_DLS_attribute (HDLSDEVICE dls, C8 const FAR* name, void FAR * val); DXDEC void AILCALL AIL_set_filter_sample_preference (HSAMPLE S, C8 const FAR * name, void const FAR * val); DXDEC void AILCALL AIL_set_filter_stream_preference (HSTREAM S, C8 const FAR * name, void const FAR * val); DXDEC void AILCALL AIL_set_filter_DLS_preference (HDLSDEVICE dls, C8 const FAR * name, void const FAR * val); typedef struct _FLTPROVIDER { PROVIDER_QUERY_ATTRIBUTE PROVIDER_query_attribute; FLT_STARTUP startup; FLT_ERROR error; FLT_SHUTDOWN shutdown; FLT_SET_PROVIDER_PREFERENCE set_provider_preference; FLT_OPEN_DRIVER open_driver; FLT_CLOSE_DRIVER close_driver; FLT_PREMIX_PROCESS premix_process; FLT_POSTMIX_PROCESS postmix_process; FLTSMP_OPEN_SAMPLE open_sample; FLTSMP_CLOSE_SAMPLE close_sample; FLTSMP_SAMPLE_PROCESS sample_process; FLTSMP_SAMPLE_ATTRIBUTE sample_attribute; FLTSMP_SET_SAMPLE_PREFERENCE set_sample_preference; HDIGDRIVER dig; HPROVIDER provider; HDRIVERSTATE driver_state; struct _FLTPROVIDER FAR *next; } FLTPROVIDER; // // 3D provider calls // DXDEC S32 AILCALL AIL_enumerate_3D_providers (HPROENUM FAR *next, HPROVIDER FAR *dest, C8 FAR * FAR *name); DXDEC M3DRESULT AILCALL AIL_open_3D_provider (HPROVIDER lib); DXDEC void AILCALL AIL_close_3D_provider (HPROVIDER lib); DXDEC S32 AILCALL AIL_enumerate_3D_provider_attributes (HPROVIDER lib, HINTENUM FAR * next, RIB_INTERFACE_ENTRY FAR * dest); DXDEC void AILCALL AIL_3D_provider_attribute (HPROVIDER lib, C8 const FAR* name, void FAR * val); DXDEC void AILCALL AIL_set_3D_provider_preference(HPROVIDER lib, C8 const FAR* name, void const FAR* val); struct H3D { H3DPOBJECT actual; HPROVIDER owner; S32 user_data[8]; }; typedef struct _M3DPROVIDER { PROVIDER_QUERY_ATTRIBUTE PROVIDER_query_attribute; M3D_STARTUP startup; M3D_ERROR error; M3D_SHUTDOWN shutdown; M3D_SET_PROVIDER_PREFERENCE set_provider_preference; M3D_ACTIVATE activate; M3D_ALLOCATE_3D_SAMPLE_HANDLE allocate_3D_sample_handle; M3D_RELEASE_3D_SAMPLE_HANDLE release_3D_sample_handle; M3D_START_3D_SAMPLE start_3D_sample; M3D_STOP_3D_SAMPLE stop_3D_sample; M3D_RESUME_3D_SAMPLE resume_3D_sample; M3D_END_3D_SAMPLE end_3D_sample; M3D_SET_3D_SAMPLE_DATA set_3D_sample_data; M3D_SET_3D_SAMPLE_VOLUME set_3D_sample_volume; M3D_SET_3D_SAMPLE_PLAYBACK_RATE set_3D_sample_playback_rate; M3D_SET_3D_SAMPLE_OFFSET set_3D_sample_offset; M3D_SET_3D_SAMPLE_LOOP_COUNT set_3D_sample_loop_count; M3D_SET_3D_SAMPLE_LOOP_BLOCK set_3D_sample_loop_block; M3D_3D_SAMPLE_STATUS sample_status; M3D_3D_SAMPLE_VOLUME sample_volume; M3D_3D_SAMPLE_PLAYBACK_RATE sample_playback_rate; M3D_3D_SAMPLE_OFFSET sample_offset; M3D_3D_SAMPLE_LENGTH sample_length; M3D_3D_SAMPLE_LOOP_COUNT sample_loop_count; M3D_SET_3D_SAMPLE_DISTANCES set_3D_sample_distances; M3D_3D_SAMPLE_DISTANCES sample_distances; M3D_ACTIVE_3D_SAMPLE_COUNT active_3D_sample_count; M3D_3D_OPEN_LISTENER open_listener; M3D_3D_CLOSE_LISTENER close_listener; M3D_3D_OPEN_OBJECT open_object; M3D_3D_CLOSE_OBJECT close_object; M3D_SET_3D_POSITION set_3D_position; M3D_SET_3D_VELOCITY set_3D_velocity; M3D_SET_3D_VELOCITY_VECTOR set_3D_velocity_vector; M3D_SET_3D_ORIENTATION set_3D_orientation; M3D_3D_POSITION position; M3D_3D_VELOCITY velocity; M3D_3D_ORIENTATION orientation; M3D_3D_UPDATE_POSITION update_position; M3D_3D_AUTO_UPDATE_POSITION auto_update_position; M3D_3D_SAMPLE_ATTRIBUTE sample_query_attribute; M3D_3D_SET_SAMPLE_PREFERENCE set_sample_preference; M3D_3D_ROOM_TYPE room_type; M3D_SET_3D_ROOM_TYPE set_3D_room_type; M3D_3D_SPEAKER_TYPE speaker_type; M3D_SET_3D_SPEAKER_TYPE set_3D_speaker_type; M3D_SET_3D_SAMPLE_OBSTRUCTION set_3D_sample_obstruction; M3D_SET_3D_SAMPLE_OCCLUSION set_3D_sample_occlusion; M3D_SET_3D_SAMPLE_CONE set_3D_sample_cone; M3D_SET_3D_SAMPLE_EFFECTS_LEVEL set_3D_sample_effects_level; M3D_3D_SAMPLE_OBSTRUCTION sample_obstruction; M3D_3D_SAMPLE_OCCLUSION sample_occlusion; M3D_3D_SAMPLE_CONE sample_cone; M3D_3D_SAMPLE_EFFECTS_LEVEL sample_effects_level; M3D_SET_3D_EOS set_3D_EOS; } M3DPROVIDER; // // Sample calls // DXDEC H3DSAMPLE AILCALL AIL_allocate_3D_sample_handle (HPROVIDER lib); DXDEC void AILCALL AIL_release_3D_sample_handle (H3DSAMPLE S); DXDEC void AILCALL AIL_start_3D_sample (H3DSAMPLE S); DXDEC void AILCALL AIL_stop_3D_sample (H3DSAMPLE S); DXDEC void AILCALL AIL_resume_3D_sample (H3DSAMPLE S); DXDEC void AILCALL AIL_end_3D_sample (H3DSAMPLE S); DXDEC S32 AILCALL AIL_set_3D_sample_file (H3DSAMPLE S, void const FAR*file_image); DXDEC S32 AILCALL AIL_set_3D_sample_info (H3DSAMPLE S, AILSOUNDINFO const FAR*info); DXDEC void AILCALL AIL_set_3D_sample_volume (H3DSAMPLE S, S32 volume); DXDEC void AILCALL AIL_set_3D_sample_offset (H3DSAMPLE S, U32 offset); DXDEC void AILCALL AIL_set_3D_sample_playback_rate (H3DSAMPLE S, S32 playback_rate); DXDEC void AILCALL AIL_set_3D_sample_loop_count(H3DSAMPLE S, U32 loops); DXDEC void AILCALL AIL_set_3D_sample_loop_block(H3DSAMPLE S, S32 loop_start_offset, S32 loop_end_offset); DXDEC U32 AILCALL AIL_3D_sample_status (H3DSAMPLE S); DXDEC S32 AILCALL AIL_3D_sample_volume (H3DSAMPLE S); DXDEC U32 AILCALL AIL_3D_sample_offset (H3DSAMPLE S); DXDEC S32 AILCALL AIL_3D_sample_playback_rate (H3DSAMPLE S); DXDEC U32 AILCALL AIL_3D_sample_length (H3DSAMPLE S); DXDEC U32 AILCALL AIL_3D_sample_loop_count (H3DSAMPLE S); DXDEC S32 AILCALL AIL_3D_room_type (HPROVIDER lib); DXDEC void AILCALL AIL_set_3D_room_type (HPROVIDER lib, S32 room_type); #define AIL_3D_2_SPEAKER 0 #define AIL_3D_HEADPHONE 1 #define AIL_3D_SURROUND 2 #define AIL_3D_4_SPEAKER 3 DXDEC S32 AILCALL AIL_3D_speaker_type (HPROVIDER lib); DXDEC void AILCALL AIL_set_3D_speaker_type (HPROVIDER lib, S32 speaker_type); // // Changed the definition of distances to only be max and min, vs. front // min/max and back min/max. Only RSX supported the concept of different // front and distances, so we changed the API to make it more orthogonal // to most of the 3D providers. Sorry in advance. // DXDEC void AILCALL AIL_set_3D_sample_distances (H3DSAMPLE S, F32 max_dist, F32 min_dist); DXDEC void AILCALL AIL_3D_sample_distances (H3DSAMPLE S, F32 FAR * max_dist, F32 FAR * min_dist); DXDEC S32 AILCALL AIL_active_3D_sample_count (HPROVIDER lib); DXDEC S32 AILCALL AIL_enumerate_3D_sample_attributes (HPROVIDER lib, HINTENUM FAR * next, RIB_INTERFACE_ENTRY FAR * dest); DXDEC void AILCALL AIL_3D_sample_attribute (H3DSAMPLE samp, C8 const FAR* name, void FAR * val); DXDEC void AILCALL AIL_set_3D_sample_preference (H3DSAMPLE samp, C8 const FAR* name, void const FAR* val); DXDEC void AILCALL AIL_set_3D_sample_obstruction (H3DSAMPLE S, F32 obstruction); DXDEC void AILCALL AIL_set_3D_sample_occlusion (H3DSAMPLE S, F32 occlusion); DXDEC void AILCALL AIL_set_3D_sample_cone (H3DSAMPLE S, F32 inner_angle, F32 outer_angle, S32 outer_volume); DXDEC void AILCALL AIL_set_3D_sample_effects_level (H3DSAMPLE S, F32 effects_level); DXDEC F32 AILCALL AIL_3D_sample_obstruction (H3DSAMPLE S); DXDEC F32 AILCALL AIL_3D_sample_occlusion (H3DSAMPLE S); DXDEC void AILCALL AIL_3D_sample_cone (H3DSAMPLE S, F32 FAR* inner_angle, F32 FAR* outer_angle, S32 FAR* outer_volume); DXDEC F32 AILCALL AIL_3D_sample_effects_level (H3DSAMPLE S); DXDEC AIL3DSAMPLECB AILCALL AIL_register_3D_EOS_callback (H3DSAMPLE S, AIL3DSAMPLECB EOS); // // Positioning-object allocation calls // DXDEC H3DPOBJECT AILCALL AIL_open_3D_listener (HPROVIDER lib); DXDEC void AILCALL AIL_close_3D_listener (H3DPOBJECT listener); DXDEC H3DPOBJECT AILCALL AIL_open_3D_object (HPROVIDER lib); DXDEC void AILCALL AIL_close_3D_object (H3DPOBJECT obj); // // 3D object calls // DXDEC void AILCALL AIL_set_3D_position (H3DPOBJECT obj, F32 X, F32 Y, F32 Z); DXDEC void AILCALL AIL_set_3D_velocity (H3DPOBJECT obj, F32 dX_per_ms, F32 dY_per_ms, F32 dZ_per_ms, F32 magnitude); DXDEC void AILCALL AIL_set_3D_velocity_vector (H3DPOBJECT obj, F32 dX_per_ms, F32 dY_per_ms, F32 dZ_per_ms); DXDEC void AILCALL AIL_set_3D_orientation (H3DPOBJECT obj, F32 X_face, F32 Y_face, F32 Z_face, F32 X_up, F32 Y_up, F32 Z_up); DXDEC void AILCALL AIL_3D_position (H3DPOBJECT obj, F32 FAR *X, F32 FAR *Y, F32 FAR *Z); DXDEC void AILCALL AIL_3D_velocity (H3DPOBJECT obj, F32 FAR *dX_per_ms, F32 FAR *dY_per_ms, F32 FAR *dZ_per_ms); DXDEC void AILCALL AIL_3D_orientation (H3DPOBJECT obj, F32 FAR *X_face, F32 FAR *Y_face, F32 FAR *Z_face, F32 FAR *X_up, F32 FAR *Y_up, F32 FAR *Z_up); DXDEC void AILCALL AIL_update_3D_position (H3DPOBJECT obj, F32 dt_milliseconds); DXDEC void AILCALL AIL_auto_update_3D_position (H3DPOBJECT obj, S32 enable); DXDEC void AILCALL AIL_set_3D_user_data (H3DPOBJECT obj, U32 index, S32 value); DXDEC S32 AILCALL AIL_3D_user_data (H3DPOBJECT obj, U32 index); // Obsolete 3D function names: #define AIL_set_3D_object_user_data AIL_set_3D_user_data #define AIL_3D_object_user_data AIL_3D_user_data #define AIL_3D_open_listener AIL_open_3D_listener #define AIL_3D_close_listener AIL_close_3D_listener #define AIL_3D_open_object AIL_open_3D_object #define AIL_3D_close_object AIL_close_3D_object // // RAD room types - currently the same as EAX // enum { ENVIRONMENT_GENERIC, // factory default ENVIRONMENT_PADDEDCELL, ENVIRONMENT_ROOM, // standard environments ENVIRONMENT_BATHROOM, ENVIRONMENT_LIVINGROOM, ENVIRONMENT_STONEROOM, ENVIRONMENT_AUDITORIUM, ENVIRONMENT_CONCERTHALL, ENVIRONMENT_CAVE, ENVIRONMENT_ARENA, ENVIRONMENT_HANGAR, ENVIRONMENT_CARPETEDHALLWAY, ENVIRONMENT_HALLWAY, ENVIRONMENT_STONECORRIDOR, ENVIRONMENT_ALLEY, ENVIRONMENT_FOREST, ENVIRONMENT_CITY, ENVIRONMENT_MOUNTAINS, ENVIRONMENT_QUARRY, ENVIRONMENT_PLAIN, ENVIRONMENT_PARKINGLOT, ENVIRONMENT_SEWERPIPE, ENVIRONMENT_UNDERWATER, ENVIRONMENT_DRUGGED, ENVIRONMENT_DIZZY, ENVIRONMENT_PSYCHOTIC, ENVIRONMENT_COUNT // total number of environments }; // // enumerated values for EAX // #ifndef EAX_H_INCLUDED enum { EAX_ENVIRONMENT_GENERIC, // factory default EAX_ENVIRONMENT_PADDEDCELL, EAX_ENVIRONMENT_ROOM, // standard environments EAX_ENVIRONMENT_BATHROOM, EAX_ENVIRONMENT_LIVINGROOM, EAX_ENVIRONMENT_STONEROOM, EAX_ENVIRONMENT_AUDITORIUM, EAX_ENVIRONMENT_CONCERTHALL, EAX_ENVIRONMENT_CAVE, EAX_ENVIRONMENT_ARENA, EAX_ENVIRONMENT_HANGAR, EAX_ENVIRONMENT_CARPETEDHALLWAY, EAX_ENVIRONMENT_HALLWAY, EAX_ENVIRONMENT_STONECORRIDOR, EAX_ENVIRONMENT_ALLEY, EAX_ENVIRONMENT_FOREST, EAX_ENVIRONMENT_CITY, EAX_ENVIRONMENT_MOUNTAINS, EAX_ENVIRONMENT_QUARRY, EAX_ENVIRONMENT_PLAIN, EAX_ENVIRONMENT_PARKINGLOT, EAX_ENVIRONMENT_SEWERPIPE, EAX_ENVIRONMENT_UNDERWATER, EAX_ENVIRONMENT_DRUGGED, EAX_ENVIRONMENT_DIZZY, EAX_ENVIRONMENT_PSYCHOTIC, EAX_ENVIRONMENT_COUNT // total number of environments }; #define EAX_REVERBMIX_USEDISTANCE (-1.0F) #endif #else typedef struct _FLTPROVIDER { U32 junk; } FLTPROVIDER; #endif #ifdef __cplusplus } #endif #if defined(_PUSHPOP_SUPPORTED) || PRAGMA_STRUCT_PACKPUSH #pragma pack(pop) #else #pragma pack() #endif #endif