Blame view

include/sound/sfnt_info.h 7.26 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
  #ifndef __SOUND_SFNT_INFO_H
  #define __SOUND_SFNT_INFO_H
  
  /*
   *  Patch record compatible with AWE driver on OSS
   *
   *  Copyright (C) 1999-2000 Takashi Iwai
   *
   *   This program is free software; you can redistribute it and/or modify
   *   it under the terms of the GNU General Public License as published by
   *   the Free Software Foundation; either version 2 of the License, or
   *   (at your option) any later version.
   *
   *   This program is distributed in the hope that it will be useful,
   *   but WITHOUT ANY WARRANTY; without even the implied warranty of
   *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   *   GNU General Public License for more details.
   *
   *   You should have received a copy of the GNU General Public License
   *   along with this program; if not, write to the Free Software
   *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
   *
   */
  
  #include <sound/asound.h>
  
  /*
   * patch information record
   */
  
  #ifdef SNDRV_BIG_ENDIAN
  #define SNDRV_OSS_PATCHKEY(id) (0xfd00|id)
  #else
  #define SNDRV_OSS_PATCHKEY(id) ((id<<8)|0xfd)
  #endif
  
  /* patch interface header: 16 bytes */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
38
  struct soundfont_patch_info {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
  	unsigned short key;		/* use the key below */
  #define SNDRV_OSS_SOUNDFONT_PATCH		SNDRV_OSS_PATCHKEY(0x07)
  
  	short device_no;		/* synthesizer number */
  	unsigned short sf_id;		/* file id (should be zero) */
  	short optarg;			/* optional argument */
  	int len;			/* data length (without this header) */
  
  	short type;			/* patch operation type */
  #define SNDRV_SFNT_LOAD_INFO		0	/* awe_voice_rec */
  #define SNDRV_SFNT_LOAD_DATA		1	/* awe_sample_info */
  #define SNDRV_SFNT_OPEN_PATCH	2	/* awe_open_parm */
  #define SNDRV_SFNT_CLOSE_PATCH	3	/* none */
  	/* 4 is obsolete */
  #define SNDRV_SFNT_REPLACE_DATA	5	/* awe_sample_info (optarg=#channels)*/
  #define SNDRV_SFNT_MAP_PRESET	6	/* awe_voice_map */
  	/* 7 is not used */
  #define SNDRV_SFNT_PROBE_DATA		8	/* optarg=sample */
  #define SNDRV_SFNT_REMOVE_INFO		9	/* optarg=(bank<<8)|instr */
  
  	short reserved;			/* word alignment data */
  
  	/* the actual patch data begins after this */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
62
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
63
64
65
66
67
68
69
  
  
  /*
   * open patch
   */
  
  #define SNDRV_SFNT_PATCH_NAME_LEN	32
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
70
  struct soundfont_open_parm {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
71
72
73
74
75
76
77
78
79
  	unsigned short type;		/* sample type */
  #define SNDRV_SFNT_PAT_TYPE_MISC	0
  #define SNDRV_SFNT_PAT_TYPE_GUS	6
  #define SNDRV_SFNT_PAT_TYPE_MAP	7
  #define SNDRV_SFNT_PAT_LOCKED	0x100	/* lock the samples */
  #define SNDRV_SFNT_PAT_SHARED	0x200	/* sample is shared */
  
  	short reserved;
  	char name[SNDRV_SFNT_PATCH_NAME_LEN];
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
80
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
81
82
83
84
85
86
87
  
  
  /*
   * raw voice information record
   */
  
  /* wave table envelope & effect parameters to control EMU8000 */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
88
  struct soundfont_voice_parm {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
  	unsigned short moddelay;	/* modulation delay (0x8000) */
  	unsigned short modatkhld;	/* modulation attack & hold time (0x7f7f) */
  	unsigned short moddcysus;	/* modulation decay & sustain (0x7f7f) */
  	unsigned short modrelease;	/* modulation release time (0x807f) */
  	short modkeyhold, modkeydecay;	/* envelope change per key (not used) */
  	unsigned short voldelay;	/* volume delay (0x8000) */
  	unsigned short volatkhld;	/* volume attack & hold time (0x7f7f) */
  	unsigned short voldcysus;	/* volume decay & sustain (0x7f7f) */
  	unsigned short volrelease;	/* volume release time (0x807f) */
  	short volkeyhold, volkeydecay;	/* envelope change per key (not used) */
  	unsigned short lfo1delay;	/* LFO1 delay (0x8000) */
  	unsigned short lfo2delay;	/* LFO2 delay (0x8000) */
  	unsigned short pefe;		/* modulation pitch & cutoff (0x0000) */
  	unsigned short fmmod;		/* LFO1 pitch & cutoff (0x0000) */
  	unsigned short tremfrq;		/* LFO1 volume & freq (0x0000) */
  	unsigned short fm2frq2;		/* LFO2 pitch & freq (0x0000) */
  	unsigned char cutoff;		/* initial cutoff (0xff) */
  	unsigned char filterQ;		/* initial filter Q [0-15] (0x0) */
  	unsigned char chorus;		/* chorus send (0x00) */
  	unsigned char reverb;		/* reverb send (0x00) */
  	unsigned short reserved[4];	/* not used */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
110
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
111
112
113
  
  
  /* wave table parameters: 92 bytes */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
114
  struct soundfont_voice_info {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
  	unsigned short sf_id;		/* file id (should be zero) */
  	unsigned short sample;		/* sample id */
  	int start, end;			/* sample offset correction */
  	int loopstart, loopend;		/* loop offset correction */
  	short rate_offset;		/* sample rate pitch offset */
  	unsigned short mode;		/* sample mode */
  #define SNDRV_SFNT_MODE_ROMSOUND		0x8000
  #define SNDRV_SFNT_MODE_STEREO		1
  #define SNDRV_SFNT_MODE_LOOPING		2
  #define SNDRV_SFNT_MODE_NORELEASE		4	/* obsolete */
  #define SNDRV_SFNT_MODE_INIT_PARM		8
  
  	short root;			/* midi root key */
  	short tune;			/* pitch tuning (in cents) */
  	unsigned char low, high;	/* key note range */
  	unsigned char vellow, velhigh;	/* velocity range */
  	signed char fixkey, fixvel;	/* fixed key, velocity */
  	signed char pan, fixpan;	/* panning, fixed panning */
  	short exclusiveClass;		/* exclusive class (0 = none) */
  	unsigned char amplitude;	/* sample volume (127 max) */
  	unsigned char attenuation;	/* attenuation (0.375dB) */
  	short scaleTuning;		/* pitch scale tuning(%), normally 100 */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
137
  	struct soundfont_voice_parm parm;	/* voice envelope parameters */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
138
  	unsigned short sample_mode;	/* sample mode_flag (set by driver) */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
139
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
140
141
142
  
  
  /* instrument info header: 4 bytes */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
143
  struct soundfont_voice_rec_hdr {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
144
145
146
147
148
149
150
  	unsigned char bank;		/* midi bank number */
  	unsigned char instr;		/* midi preset number */
  	char nvoices;			/* number of voices */
  	char write_mode;		/* write mode; normally 0 */
  #define SNDRV_SFNT_WR_APPEND		0	/* append anyway */
  #define SNDRV_SFNT_WR_EXCLUSIVE		1	/* skip if already exists */
  #define SNDRV_SFNT_WR_REPLACE		2	/* replace if already exists */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
151
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
152
153
154
155
156
157
158
  
  
  /*
   * sample wave information
   */
  
  /* wave table sample header: 32 bytes */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
159
  struct soundfont_sample_info {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
  	unsigned short sf_id;		/* file id (should be zero) */
  	unsigned short sample;		/* sample id */
  	int start, end;			/* start & end offset */
  	int loopstart, loopend;		/* loop start & end offset */
  	int size;			/* size (0 = ROM) */
  	short dummy;			/* not used */
  	unsigned short mode_flags;	/* mode flags */
  #define SNDRV_SFNT_SAMPLE_8BITS		1	/* wave data is 8bits */
  #define SNDRV_SFNT_SAMPLE_UNSIGNED	2	/* wave data is unsigned */
  #define SNDRV_SFNT_SAMPLE_NO_BLANK	4	/* no blank loop is attached */
  #define SNDRV_SFNT_SAMPLE_SINGLESHOT	8	/* single-shot w/o loop */
  #define SNDRV_SFNT_SAMPLE_BIDIR_LOOP	16	/* bidirectional looping */
  #define SNDRV_SFNT_SAMPLE_STEREO_LEFT	32	/* stereo left sound */
  #define SNDRV_SFNT_SAMPLE_STEREO_RIGHT	64	/* stereo right sound */
  #define SNDRV_SFNT_SAMPLE_REVERSE_LOOP	128	/* reverse looping */
  	unsigned int truesize;		/* used memory size (set by driver) */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
176
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
177
178
179
180
181
  
  
  /*
   * voice preset mapping (aliasing)
   */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
182
  struct soundfont_voice_map {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
183
184
  	int map_bank, map_instr, map_key;	/* key = -1 means all keys */
  	int src_bank, src_instr, src_key;
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
185
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
186
187
188
189
190
191
192
193
194
  
  
  /*
   * ioctls for hwdep
   */
  
  #define SNDRV_EMUX_HWDEP_NAME	"Emux WaveTable"
  
  #define SNDRV_EMUX_VERSION	((1 << 16) | (0 << 8) | 0)	/* 1.0.0 */
03da312ac   Takashi Iwai   [ALSA] Remove xxx...
195
  struct snd_emux_misc_mode {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
196
197
198
199
200
  	int port;	/* -1 = all */
  	int mode;
  	int value;
  	int value2;	/* reserved */
  };
78a05b522   Takashi Iwai   ALSA: Use define ...
201
202
203
204
205
206
  #define SNDRV_EMUX_IOCTL_VERSION	_IOR('H', 0x80, unsigned int)
  #define SNDRV_EMUX_IOCTL_LOAD_PATCH	_IOWR('H', 0x81, struct soundfont_patch_info)
  #define SNDRV_EMUX_IOCTL_RESET_SAMPLES	_IO('H', 0x82)
  #define SNDRV_EMUX_IOCTL_REMOVE_LAST_SAMPLES _IO('H', 0x83)
  #define SNDRV_EMUX_IOCTL_MEM_AVAIL	_IOW('H', 0x84, int)
  #define SNDRV_EMUX_IOCTL_MISC_MODE	_IOWR('H', 0x84, struct snd_emux_misc_mode)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
207
208
  
  #endif /* __SOUND_SFNT_INFO_H */