You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
269 lines
7.9 KiB
269 lines
7.9 KiB
/*
|
|
|
|
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 */
|