| /* | |
| dls.h | |
| Description: | |
| Interface defines and structures for the Instrument Collection Form | |
| RIFF DLS. | |
| Written by Sonic Foundry 1996. Released for public use. | |
| */ | |
| #ifndef _INC_DLS | |
| #define _INC_DLS | |
| /* | |
| Layout of an instrument collection: | |
| RIFF [] 'DLS ' [colh,INSTLIST,WAVEPOOL,INFOLIST] | |
| INSTLIST | |
| LIST [] 'lins' | |
| LIST [] 'ins ' [insh,RGNLIST,ARTLIST,INFOLIST] | |
| LIST [] 'ins ' [insh,RGNLIST,ARTLIST,INFOLIST] | |
| LIST [] 'ins ' [insh,RGNLIST,ARTLIST,INFOLIST] | |
| RGNLIST | |
| LIST [] 'lrgn' | |
| LIST [] 'rgn ' [rgnh,wsmp,wlnk,ARTLIST] | |
| LIST [] 'rgn ' [rgnh,wsmp,wlnk,ARTLIST] | |
| LIST [] 'rgn ' [rgnh,wsmp,wlnk,ARTLIST] | |
| ARTLIST | |
| LIST [] 'lart' | |
| 'art1' level 1 Articulation connection graph | |
| 'art2' level 2 Articulation connection graph | |
| '3rd1' Possible 3rd party articulation structure 1 | |
| '3rd2' Possible 3rd party articulation structure 2 .... and so on | |
| WAVEPOOL | |
| ptbl [] [pool table] | |
| LIST [] 'wvpl' | |
| [path], | |
| [path], | |
| LIST [] 'wave',RIFFWAVE | |
| LIST [] 'wave',RIFFWAVE | |
| LIST [] 'wave',RIFFWAVE | |
| LIST [] 'wave',RIFFWAVE | |
| LIST [] 'wave',RIFFWAVE | |
| INFOLIST | |
| LIST [] 'INFO' | |
| 'icmt' 'One of those crazy comments.' | |
| 'icop' 'Copyright (C) 1996 Sonic Foundry' | |
| */ | |
| /* | |
| FOURCC's used in the DLS file | |
| */ | |
| /* shree */ | |
| //#define FAR | |
| /* shree | |
| #define FOURCC_DLS mmioFOURCC('D','L','S',' ') | |
| #define FOURCC_COLH mmioFOURCC('c','o','l','h') | |
| #define FOURCC_WVPL mmioFOURCC('w','v','p','l') | |
| #define FOURCC_PTBL mmioFOURCC('p','t','b','l') | |
| #define FOURCC_PATH mmioFOURCC('p','a','t','h') | |
| #define FOURCC_wave mmioFOURCC('w','a','v','e') | |
| #define FOURCC_LINS mmioFOURCC('l','i','n','s') | |
| #define FOURCC_INS mmioFOURCC('i','n','s',' ') | |
| #define FOURCC_INSH mmioFOURCC('i','n','s','h') | |
| #define FOURCC_LRGN mmioFOURCC('l','r','g','n') | |
| #define FOURCC_RGN mmioFOURCC('r','g','n',' ') | |
| #define FOURCC_RGNH mmioFOURCC('r','g','n','h') | |
| #define FOURCC_LART mmioFOURCC('l','a','r','t') | |
| #define FOURCC_ART1 mmioFOURCC('a','r','t','1') | |
| #define FOURCC_WLNK mmioFOURCC('w','l','n','k') | |
| #define FOURCC_WSMP mmioFOURCC('w','s','m','p') | |
| #define FOURCC_VERS mmioFOURCC('v','e','r','s') | |
| */ | |
| /* | |
| Articulation connection graph definitions | |
| */ | |
| /* Generic Sources */ | |
| #define CONN_SRC_NONE 0x0000 | |
| #define CONN_SRC_LFO 0x0001 | |
| #define CONN_SRC_KEYONVELOCITY 0x0002 | |
| #define CONN_SRC_KEYNUMBER 0x0003 | |
| #define CONN_SRC_EG1 0x0004 | |
| #define CONN_SRC_EG2 0x0005 | |
| #define CONN_SRC_PITCHWHEEL 0x0006 | |
| /* Midi Controllers 0-127 */ | |
| #define CONN_SRC_CC1 0x0081 | |
| #define CONN_SRC_CC7 0x0087 | |
| #define CONN_SRC_CC10 0x008a | |
| #define CONN_SRC_CC11 0x008b | |
| /* Registered Parameter Numbers */ | |
| #define CONN_SRC_RPN0 0x0100 | |
| #define CONN_SRC_RPN1 0x0101 | |
| #define CONN_SRC_RPN2 0x0102 | |
| /* Generic Destinations */ | |
| #define CONN_DST_NONE 0x0000 | |
| #define CONN_DST_ATTENUATION 0x0001 | |
| #define CONN_DST_RESERVED 0x0002 | |
| #define CONN_DST_PITCH 0x0003 | |
| #define CONN_DST_PAN 0x0004 | |
| /* LFO Destinations */ | |
| #define CONN_DST_LFO_FREQUENCY 0x0104 | |
| #define CONN_DST_LFO_STARTDELAY 0x0105 | |
| /* EG1 Destinations */ | |
| #define CONN_DST_EG1_ATTACKTIME 0x0206 | |
| #define CONN_DST_EG1_DECAYTIME 0x0207 | |
| #define CONN_DST_EG1_RESERVED 0x0208 | |
| #define CONN_DST_EG1_RELEASETIME 0x0209 | |
| #define CONN_DST_EG1_SUSTAINLEVEL 0x020a | |
| /* EG2 Destinations */ | |
| #define CONN_DST_EG2_ATTACKTIME 0x030a | |
| #define CONN_DST_EG2_DECAYTIME 0x030b | |
| #define CONN_DST_EG2_RESERVED 0x030c | |
| #define CONN_DST_EG2_RELEASETIME 0x030d | |
| #define CONN_DST_EG2_SUSTAINLEVEL 0x030e | |
| #define CONN_TRN_NONE 0x0000 | |
| #define CONN_TRN_CONCAVE 0x0001 | |
| typedef struct _DLSVERSION { | |
| DWORD dwVersionMS; | |
| DWORD dwVersionLS; | |
| }DLSVERSION, FAR *LPDLSVERSION; | |
| typedef struct _CONNECTION { | |
| USHORT usSource; | |
| USHORT usControl; | |
| USHORT usDestination; | |
| USHORT usTransform; | |
| LONG lScale; | |
| }CONNECTION, FAR *LPCONNECTION; | |
| /* Level 1 Articulation Data */ | |
| typedef struct _CONNECTIONLIST { | |
| ULONG cbSize; /* size of the connection list structure */ | |
| ULONG cConnections; /* count of connections in the list */ | |
| } CONNECTIONLIST, FAR *LPCONNECTIONLIST; | |
| /* | |
| Generic type defines for regions and instruments | |
| */ | |
| typedef struct _RGNRANGE { | |
| USHORT usLow; | |
| USHORT usHigh; | |
| }RGNRANGE, FAR * LPRGNRANGE; | |
| #define F_INSTRUMENT_DRUMS 0x80000000 | |
| typedef struct _MIDILOCALE { | |
| ULONG ulBank; | |
| ULONG ulInstrument; | |
| }MIDILOCALE, FAR *LPMIDILOCALE; | |
| /* | |
| Header structures found in an DLS file for collection, instruments, and | |
| regions. | |
| */ | |
| #define F_RGN_OPTION_SELFNONEXCLUSIVE 0x0001 | |
| typedef struct _RGNHEADER { | |
| RGNRANGE RangeKey; /* Key range */ | |
| RGNRANGE RangeVelocity; /* Velocity Range */ | |
| USHORT fusOptions; /* Synthesis options for this range */ | |
| USHORT usKeyGroup; /* Key grouping for non simultaneous play | |
| 0 = no group, 1 up is group | |
| for Level 1 only groups 1-15 are allowed */ | |
| }RGNHEADER, FAR *LPRGNHEADER; | |
| typedef struct _INSTHEADER { | |
| ULONG cRegions; /* Count of regions in this instrument */ | |
| MIDILOCALE Locale; /* Intended MIDI locale of this instrument */ | |
| }INSTHEADER, FAR *LPINSTHEADER; | |
| typedef struct _DLSHEADER { | |
| ULONG cInstruments; /* Count of instruments in the collection */ | |
| }DLSHEADER, FAR *LPDLSHEADER; | |
| /* | |
| definitions for the Wave link structure | |
| */ | |
| /***** For level 1 only WAVELINK_CHANNEL_MONO is valid **** | |
| ulChannel allows for up to 32 channels of audio with each bit position | |
| specifiying a channel of playback */ | |
| #define WAVELINK_CHANNEL_LEFT 0x0001 | |
| #define WAVELINK_CHANNEL_RIGHT 0x0002 | |
| #define F_WAVELINK_PHASE_MASTER 0x0001 | |
| typedef struct _WAVELINK { /* any paths or links are stored right after struct */ | |
| USHORT fusOptions; /* options flags for this wave */ | |
| USHORT usPhaseGroup; /* Phase grouping for locking channels */ | |
| ULONG ulChannel; /* channel placement */ | |
| ULONG ulTableIndex; /* index into the wave pool table, 0 based */ | |
| }WAVELINK, FAR *LPWAVELINK; | |
| #define POOL_CUE_NULL 0xffffffff | |
| typedef struct _POOLCUE { | |
| // ULONG ulEntryIndex; /* Index entry in the list */ | |
| ULONG ulOffset; /* Offset to the entry in the list */ | |
| }POOLCUE, FAR *LPPOOLCUE; | |
| typedef struct _POOLTABLE { | |
| ULONG cbSize; /* size of the pool table structure */ | |
| ULONG cCues; /* count of cues in the list */ | |
| } POOLTABLE, FAR *LPPOOLTABLE; | |
| /* | |
| Structures for the "wsmp" chunk | |
| */ | |
| #define F_WSMP_NO_TRUNCATION 0x0001 | |
| #define F_WSMP_NO_COMPRESSION 0x0002 | |
| typedef struct _rwsmp { | |
| ULONG cbSize; | |
| USHORT usUnityNote; /* MIDI Unity Playback Note */ | |
| SHORT sFineTune; /* Fine Tune in log tuning */ | |
| LONG lAttenuation; /* Overall Attenuation to be applied to data */ | |
| ULONG fulOptions; /* Flag options */ | |
| ULONG cSampleLoops; /* Count of Sample loops, 0 loops is one shot */ | |
| } WSMPL, FAR *LPWSMPL; | |
| /* This loop type is a normal forward playing loop which is continually | |
| played until the envelope reaches an off threshold in the release | |
| portion of the volume envelope */ | |
| #define WLOOP_TYPE_FORWARD 0 | |
| typedef struct _rloop { | |
| ULONG cbSize; | |
| ULONG ulType; /* Loop Type */ | |
| ULONG ulStart; /* Start of loop in samples */ | |
| ULONG ulLength; /* Length of loop in samples */ | |
| } WLOOP, FAR *LPWLOOP; | |
| #endif /* _INC_DLS */ |