api/include/dmdls.h

/************************************************************************
*                                                                       *
*   dmdls.h -- DLS download definitions for DirectMusic API's           *
*                                                                       *
*   Copyright (c) 1998-1999 Microsoft Corporation                       *
*                                                                       *
************************************************************************/

#ifndef _DMDLS_
#define _DMDLS_

#include "dls1.h"

typedef long PCENT;     /* Pitch cents */
typedef long GCENT;     /* Gain cents */
typedef long TCENT;     /* Time cents */
typedef long PERCENT;   /* Per.. cent! */

typedef LONGLONG REFERENCE_TIME;
typedef REFERENCE_TIME *LPREFERENCE_TIME;

#ifndef MAKE_FOURCC
#define MAKEFOURCC(ch0, ch1, ch2, ch3)                              \
                ((DWORD)(BYTE)(ch0) | ((DWORD)(BYTE)(ch1) << 8) |   \
                ((DWORD)(BYTE)(ch2) << 16) | ((DWORD)(BYTE)(ch3) << 24 ))


typedef DWORD           FOURCC;         /* a four character code */
#endif

typedef struct _DMUS_DOWNLOADINFO
{
    DWORD dwDLType;                     /* Instrument or Wave */
    DWORD dwDLId;                       /* Unique identifier to tag this download. */
    DWORD dwNumOffsetTableEntries;      /* Number of index in the offset address table. */
    DWORD cbSize;                       /* Total size of this memory chunk. */
} DMUS_DOWNLOADINFO;

#define DMUS_DOWNLOADINFO_INSTRUMENT        1
#define DMUS_DOWNLOADINFO_WAVE              2
#define DMUS_DOWNLOADINFO_INSTRUMENT2       3   /* New version for better DLS2 support. */

/* Support for oneshot and streaming wave data 
 */
#define DMUS_DOWNLOADINFO_WAVEARTICULATION  4   /* Wave articulation data */
#define DMUS_DOWNLOADINFO_STREAMINGWAVE     5   /* One chunk of a streaming */
#define DMUS_DOWNLOADINFO_ONESHOTWAVE       6

#define DMUS_DEFAULT_SIZE_OFFSETTABLE   1

/* Flags for DMUS_INSTRUMENT's ulFlags member */
 
#define DMUS_INSTRUMENT_GM_INSTRUMENT   (1 << 0)

typedef struct _DMUS_OFFSETTABLE
{
    ULONG ulOffsetTable[DMUS_DEFAULT_SIZE_OFFSETTABLE];
} DMUS_OFFSETTABLE;

typedef struct _DMUS_INSTRUMENT
{
    ULONG           ulPatch;
    ULONG           ulFirstRegionIdx;             
    ULONG           ulGlobalArtIdx;         /* If zero the instrument does not have an articulation */
    ULONG           ulFirstExtCkIdx;        /* If zero no 3rd party entenstion chunks associated with the instrument */
    ULONG           ulCopyrightIdx;         /* If zero no Copyright information associated with the instrument */
    ULONG           ulFlags;                        
} DMUS_INSTRUMENT;

typedef struct _DMUS_REGION
{
    RGNRANGE        RangeKey;
    RGNRANGE        RangeVelocity;
    USHORT          fusOptions;
    USHORT          usKeyGroup;
    ULONG           ulRegionArtIdx;         /* If zero the region does not have an articulation */
    ULONG           ulNextRegionIdx;        /* If zero no more regions */
    ULONG           ulFirstExtCkIdx;        /* If zero no 3rd party entenstion chunks associated with the region */
    WAVELINK        WaveLink;
    WSMPL           WSMP;                   /*  If WSMP.cSampleLoops > 1 then a WLOOP is included */
    WLOOP           WLOOP[1];
} DMUS_REGION;

typedef struct _DMUS_LFOPARAMS
{
    PCENT       pcFrequency;
    TCENT       tcDelay;
    GCENT       gcVolumeScale;
    PCENT       pcPitchScale;
    GCENT       gcMWToVolume;
    PCENT       pcMWToPitch;
} DMUS_LFOPARAMS;

typedef struct _DMUS_VEGPARAMS
{
    TCENT       tcAttack;
    TCENT       tcDecay;
    PERCENT     ptSustain;
    TCENT       tcRelease;
    TCENT       tcVel2Attack;
    TCENT       tcKey2Decay;
} DMUS_VEGPARAMS;

typedef struct _DMUS_PEGPARAMS
{
    TCENT       tcAttack;
    TCENT       tcDecay;
    PERCENT     ptSustain;
    TCENT       tcRelease;
    TCENT       tcVel2Attack;
    TCENT       tcKey2Decay;
    PCENT       pcRange;
} DMUS_PEGPARAMS;

typedef struct _DMUS_MSCPARAMS
{
    PERCENT     ptDefaultPan;
} DMUS_MSCPARAMS;

typedef struct _DMUS_ARTICPARAMS
{
    DMUS_LFOPARAMS   LFO;
    DMUS_VEGPARAMS   VolEG;
    DMUS_PEGPARAMS   PitchEG;
    DMUS_MSCPARAMS   Misc;
} DMUS_ARTICPARAMS;

typedef struct _DMUS_ARTICULATION           /* Articulation chunk for DMUS_DOWNLOADINFO_INSTRUMENT format. */
{
    ULONG           ulArt1Idx;              /* DLS Level 1 articulation chunk */
    ULONG           ulFirstExtCkIdx;        /* 3rd party extenstion chunks associated with the articulation */
} DMUS_ARTICULATION;

typedef struct _DMUS_ARTICULATION2          /* Articulation chunk for DMUS_DOWNLOADINFO_INSTRUMENT2 format. */
{
    ULONG           ulArtIdx;               /* DLS Level 1/2 articulation chunk */
    ULONG           ulFirstExtCkIdx;        /* 3rd party extenstion chunks associated with the articulation */
    ULONG           ulNextArtIdx;           /* Additional articulation chunks */
} DMUS_ARTICULATION2;

#define DMUS_MIN_DATA_SIZE 4       
/*  The actual number is determined by cbSize of struct _DMUS_EXTENSIONCHUNK */

typedef struct _DMUS_EXTENSIONCHUNK
{
    ULONG           cbSize;                      /*  Size of extension chunk  */
    ULONG           ulNextExtCkIdx;              /*  If zero no more 3rd party entenstion chunks */
    FOURCC          ExtCkID;                                      
    BYTE            byExtCk[DMUS_MIN_DATA_SIZE]; /*  The actual number that follows is determined by cbSize */
} DMUS_EXTENSIONCHUNK;

/*  The actual number is determined by cbSize of struct _DMUS_COPYRIGHT */

typedef struct _DMUS_COPYRIGHT
{
    ULONG           cbSize;                             /*  Size of copyright information */
    BYTE            byCopyright[DMUS_MIN_DATA_SIZE];    /*  The actual number that follows is determined by cbSize */
} DMUS_COPYRIGHT;

typedef struct _DMUS_WAVEDATA
{
    ULONG           cbSize;
    BYTE            byData[DMUS_MIN_DATA_SIZE]; 
} DMUS_WAVEDATA;

typedef struct _DMUS_WAVE
{
    ULONG           ulFirstExtCkIdx;    /* If zero no 3rd party entenstion chunks associated with the wave */
    ULONG           ulCopyrightIdx;     /* If zero no Copyright information associated with the wave */
    ULONG           ulWaveDataIdx;      /* Location of actual wave data. */
    WAVEFORMATEX    WaveformatEx;       
} DMUS_WAVE;

typedef struct _DMUS_NOTERANGE *LPDMUS_NOTERANGE;
typedef struct _DMUS_NOTERANGE
{
    DWORD           dwLowNote;  /* Sets the low note for the range of MIDI note events to which the instrument responds.*/
    DWORD           dwHighNote; /* Sets the high note for the range of MIDI note events to which the instrument responds.*/
} DMUS_NOTERANGE;

typedef struct _DMUS_WAVEARTDL
{
    ULONG               ulDownloadIdIdx;    /* Download ID's of each buffer */
    ULONG               ulBus;              /* Playback bus */
    ULONG               ulBuffers;          /* Buffers */
    ULONG               ulMasterDLId;       /* Download ID of master voice of slave group */
    USHORT              usOptions;          /* Same as DLS2 region options */
}   DMUS_WAVEARTDL,
    *LPDMUS_WAVEARTDL;

typedef struct _DMUS_WAVEDL
{
    ULONG               cbWaveData;         /* Bytes of wave data */
}   DMUS_WAVEDL,
    *LPDMUS_WAVEDL;

#endif 


1	bearsoft	1.1	/************************************************************************
2			* *
3			* dmdls.h -- DLS download definitions for DirectMusic API's *
4			* *
5			* Copyright (c) 1998-1999 Microsoft Corporation *
6			* *
7			************************************************************************/
8
9			#ifndef _DMDLS_
10			#define _DMDLS_
11
12			#include "dls1.h"
13
14			typedef long PCENT; /* Pitch cents */
15			typedef long GCENT; /* Gain cents */
16			typedef long TCENT; /* Time cents */
17			typedef long PERCENT; /* Per.. cent! */
18
19			typedef LONGLONG REFERENCE_TIME;
20			typedef REFERENCE_TIME *LPREFERENCE_TIME;
21
22			#ifndef MAKE_FOURCC
23			#define MAKEFOURCC(ch0, ch1, ch2, ch3) \
24			((DWORD)(BYTE)(ch0) \| ((DWORD)(BYTE)(ch1) << 8) \| \
25			((DWORD)(BYTE)(ch2) << 16) \| ((DWORD)(BYTE)(ch3) << 24 ))
26
27
28			typedef DWORD FOURCC; /* a four character code */
29			#endif
30
31			typedef struct _DMUS_DOWNLOADINFO
32			{
33			DWORD dwDLType; /* Instrument or Wave */
34			DWORD dwDLId; /* Unique identifier to tag this download. */
35			DWORD dwNumOffsetTableEntries; /* Number of index in the offset address table. */
36			DWORD cbSize; /* Total size of this memory chunk. */
37			} DMUS_DOWNLOADINFO;
38
39			#define DMUS_DOWNLOADINFO_INSTRUMENT 1
40			#define DMUS_DOWNLOADINFO_WAVE 2
41			#define DMUS_DOWNLOADINFO_INSTRUMENT2 3 /* New version for better DLS2 support. */
42
43			/* Support for oneshot and streaming wave data
44			*/
45			#define DMUS_DOWNLOADINFO_WAVEARTICULATION 4 /* Wave articulation data */
46			#define DMUS_DOWNLOADINFO_STREAMINGWAVE 5 /* One chunk of a streaming */
47			#define DMUS_DOWNLOADINFO_ONESHOTWAVE 6
48
49			#define DMUS_DEFAULT_SIZE_OFFSETTABLE 1
50
51			/* Flags for DMUS_INSTRUMENT's ulFlags member */
52
53			#define DMUS_INSTRUMENT_GM_INSTRUMENT (1 << 0)
54
55			typedef struct _DMUS_OFFSETTABLE
56			{
57			ULONG ulOffsetTable[DMUS_DEFAULT_SIZE_OFFSETTABLE];
58			} DMUS_OFFSETTABLE;
59
60			typedef struct _DMUS_INSTRUMENT
61			{
62			ULONG ulPatch;
63			ULONG ulFirstRegionIdx;
64			ULONG ulGlobalArtIdx; /* If zero the instrument does not have an articulation */
65			ULONG ulFirstExtCkIdx; /* If zero no 3rd party entenstion chunks associated with the instrument */
66			ULONG ulCopyrightIdx; /* If zero no Copyright information associated with the instrument */
67			ULONG ulFlags;
68			} DMUS_INSTRUMENT;
69
70			typedef struct _DMUS_REGION
71			{
72			RGNRANGE RangeKey;
73			RGNRANGE RangeVelocity;
74			USHORT fusOptions;
75			USHORT usKeyGroup;
76			ULONG ulRegionArtIdx; /* If zero the region does not have an articulation */
77			ULONG ulNextRegionIdx; /* If zero no more regions */
78			ULONG ulFirstExtCkIdx; /* If zero no 3rd party entenstion chunks associated with the region */
79			WAVELINK WaveLink;
80			WSMPL WSMP; /* If WSMP.cSampleLoops > 1 then a WLOOP is included */
81			WLOOP WLOOP[1];
82			} DMUS_REGION;
83
84			typedef struct _DMUS_LFOPARAMS
85			{
86			PCENT pcFrequency;
87			TCENT tcDelay;
88			GCENT gcVolumeScale;
89			PCENT pcPitchScale;
90			GCENT gcMWToVolume;
91			PCENT pcMWToPitch;
92			} DMUS_LFOPARAMS;
93
94			typedef struct _DMUS_VEGPARAMS
95			{
96			TCENT tcAttack;
97			TCENT tcDecay;
98			PERCENT ptSustain;
99			TCENT tcRelease;
100			TCENT tcVel2Attack;
101			TCENT tcKey2Decay;
102			} DMUS_VEGPARAMS;
103
104			typedef struct _DMUS_PEGPARAMS
105			{
106			TCENT tcAttack;
107			TCENT tcDecay;
108			PERCENT ptSustain;
109			TCENT tcRelease;
110			TCENT tcVel2Attack;
111			TCENT tcKey2Decay;
112			PCENT pcRange;
113			} DMUS_PEGPARAMS;
114
115			typedef struct _DMUS_MSCPARAMS
116			{
117			PERCENT ptDefaultPan;
118			} DMUS_MSCPARAMS;
119
120			typedef struct _DMUS_ARTICPARAMS
121			{
122			DMUS_LFOPARAMS LFO;
123			DMUS_VEGPARAMS VolEG;
124			DMUS_PEGPARAMS PitchEG;
125			DMUS_MSCPARAMS Misc;
126			} DMUS_ARTICPARAMS;
127
128			typedef struct _DMUS_ARTICULATION /* Articulation chunk for DMUS_DOWNLOADINFO_INSTRUMENT format. */
129			{
130			ULONG ulArt1Idx; /* DLS Level 1 articulation chunk */
131			ULONG ulFirstExtCkIdx; /* 3rd party extenstion chunks associated with the articulation */
132			} DMUS_ARTICULATION;
133
134			typedef struct _DMUS_ARTICULATION2 /* Articulation chunk for DMUS_DOWNLOADINFO_INSTRUMENT2 format. */
135			{
136			ULONG ulArtIdx; /* DLS Level 1/2 articulation chunk */
137			ULONG ulFirstExtCkIdx; /* 3rd party extenstion chunks associated with the articulation */
138			ULONG ulNextArtIdx; /* Additional articulation chunks */
139			} DMUS_ARTICULATION2;
140
141			#define DMUS_MIN_DATA_SIZE 4
142			/* The actual number is determined by cbSize of struct _DMUS_EXTENSIONCHUNK */
143
144			typedef struct _DMUS_EXTENSIONCHUNK
145			{
146			ULONG cbSize; /* Size of extension chunk */
147			ULONG ulNextExtCkIdx; /* If zero no more 3rd party entenstion chunks */
148			FOURCC ExtCkID;
149			BYTE byExtCk[DMUS_MIN_DATA_SIZE]; /* The actual number that follows is determined by cbSize */
150			} DMUS_EXTENSIONCHUNK;
151
152			/* The actual number is determined by cbSize of struct _DMUS_COPYRIGHT */
153
154			typedef struct _DMUS_COPYRIGHT
155			{
156			ULONG cbSize; /* Size of copyright information */
157			BYTE byCopyright[DMUS_MIN_DATA_SIZE]; /* The actual number that follows is determined by cbSize */
158			} DMUS_COPYRIGHT;
159
160			typedef struct _DMUS_WAVEDATA
161			{
162			ULONG cbSize;
163			BYTE byData[DMUS_MIN_DATA_SIZE];
164			} DMUS_WAVEDATA;
165
166			typedef struct _DMUS_WAVE
167			{
168			ULONG ulFirstExtCkIdx; /* If zero no 3rd party entenstion chunks associated with the wave */
169			ULONG ulCopyrightIdx; /* If zero no Copyright information associated with the wave */
170			ULONG ulWaveDataIdx; /* Location of actual wave data. */
171			WAVEFORMATEX WaveformatEx;
172			} DMUS_WAVE;
173
174			typedef struct _DMUS_NOTERANGE *LPDMUS_NOTERANGE;
175			typedef struct _DMUS_NOTERANGE
176			{
177			DWORD dwLowNote; /* Sets the low note for the range of MIDI note events to which the instrument responds.*/
178			DWORD dwHighNote; /* Sets the high note for the range of MIDI note events to which the instrument responds.*/
179			} DMUS_NOTERANGE;
180
181			typedef struct _DMUS_WAVEARTDL
182			{
183			ULONG ulDownloadIdIdx; /* Download ID's of each buffer */
184			ULONG ulBus; /* Playback bus */
185			ULONG ulBuffers; /* Buffers */
186			ULONG ulMasterDLId; /* Download ID of master voice of slave group */
187			USHORT usOptions; /* Same as DLS2 region options */
188			} DMUS_WAVEARTDL,
189			*LPDMUS_WAVEARTDL;
190
191			typedef struct _DMUS_WAVEDL
192			{
193			ULONG cbWaveData; /* Bytes of wave data */
194			} DMUS_WAVEDL,
195			*LPDMUS_WAVEDL;
196
197			#endif
198
199