re3/milessdk/include/mss.h

4806 lines
163 KiB
C
Raw Normal View History

2019-08-02 20:20:12 +00:00
//############################################################################
//## ##
//## 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 <windows.h>
#include <mmsystem.h>
#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 <string.h>
#include <Files.h>
#include <Sound.h>
#include <Resources.h> // 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