1 |
199 |
simons |
#ifndef _ULTRASOUND_H_
|
2 |
|
|
#define _ULTRASOUND_H_
|
3 |
|
|
/*
|
4 |
|
|
* ultrasound.h - Macros for programming the Gravis Ultrasound
|
5 |
|
|
* These macros are extremely device dependent
|
6 |
|
|
* and not portable.
|
7 |
|
|
*/
|
8 |
|
|
/*
|
9 |
|
|
* Copyright (C) by Hannu Savolainen 1993-1996
|
10 |
|
|
*
|
11 |
|
|
* USS/Lite for Linux is distributed under the GNU GENERAL PUBLIC LICENSE (GPL)
|
12 |
|
|
* Version 2 (June 1991). See the "COPYING" file distributed with this software
|
13 |
|
|
* for more info.
|
14 |
|
|
*/
|
15 |
|
|
|
16 |
|
|
|
17 |
|
|
/*
|
18 |
|
|
* Private events for Gravis Ultrasound (GUS)
|
19 |
|
|
*
|
20 |
|
|
* Format:
|
21 |
|
|
* byte 0 - SEQ_PRIVATE (0xfe)
|
22 |
|
|
* byte 1 - Synthesizer device number (0-N)
|
23 |
|
|
* byte 2 - Command (see below)
|
24 |
|
|
* byte 3 - Voice number (0-31)
|
25 |
|
|
* bytes 4 and 5 - parameter P1 (unsigned short)
|
26 |
|
|
* bytes 6 and 7 - parameter P2 (unsigned short)
|
27 |
|
|
*
|
28 |
|
|
* Commands:
|
29 |
|
|
* Each command affects one voice defined in byte 3.
|
30 |
|
|
* Unused parameters (P1 and/or P2 *MUST* be initialized to zero).
|
31 |
|
|
* _GUS_NUMVOICES - Sets max. number of concurrent voices (P1=14-31, default 16)
|
32 |
|
|
* _GUS_VOICESAMPLE- ************ OBSOLETE *************
|
33 |
|
|
* _GUS_VOICEON - Starts voice (P1=voice mode)
|
34 |
|
|
* _GUS_VOICEOFF - Stops voice (no parameters)
|
35 |
|
|
* _GUS_VOICEFADE - Stops the voice smoothly.
|
36 |
|
|
* _GUS_VOICEMODE - Alters the voice mode, don't start or stop voice (P1=voice mode)
|
37 |
|
|
* _GUS_VOICEBALA - Sets voice balence (P1, 0=left, 7=middle and 15=right, default 7)
|
38 |
|
|
* _GUS_VOICEFREQ - Sets voice (sample) playback frequency (P1=Hz)
|
39 |
|
|
* _GUS_VOICEVOL - Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off)
|
40 |
|
|
* _GUS_VOICEVOL2 - Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off)
|
41 |
|
|
* (Like GUS_VOICEVOL but doesn't change the hw
|
42 |
|
|
* volume. It just updates volume in the voice table).
|
43 |
|
|
*
|
44 |
|
|
* _GUS_RAMPRANGE - Sets limits for volume ramping (P1=low volume, P2=high volume)
|
45 |
|
|
* _GUS_RAMPRATE - Sets the speed for volume ramping (P1=scale, P2=rate)
|
46 |
|
|
* _GUS_RAMPMODE - Sets the volume ramping mode (P1=ramping mode)
|
47 |
|
|
* _GUS_RAMPON - Starts volume ramping (no parameters)
|
48 |
|
|
* _GUS_RAMPOFF - Stops volume ramping (no parameters)
|
49 |
|
|
* _GUS_VOLUME_SCALE - Changes the volume calculation constants
|
50 |
|
|
* for all voices.
|
51 |
|
|
*/
|
52 |
|
|
|
53 |
|
|
#define _GUS_NUMVOICES 0x00
|
54 |
|
|
#define _GUS_VOICESAMPLE 0x01 /* OBSOLETE */
|
55 |
|
|
#define _GUS_VOICEON 0x02
|
56 |
|
|
#define _GUS_VOICEOFF 0x03
|
57 |
|
|
#define _GUS_VOICEMODE 0x04
|
58 |
|
|
#define _GUS_VOICEBALA 0x05
|
59 |
|
|
#define _GUS_VOICEFREQ 0x06
|
60 |
|
|
#define _GUS_VOICEVOL 0x07
|
61 |
|
|
#define _GUS_RAMPRANGE 0x08
|
62 |
|
|
#define _GUS_RAMPRATE 0x09
|
63 |
|
|
#define _GUS_RAMPMODE 0x0a
|
64 |
|
|
#define _GUS_RAMPON 0x0b
|
65 |
|
|
#define _GUS_RAMPOFF 0x0c
|
66 |
|
|
#define _GUS_VOICEFADE 0x0d
|
67 |
|
|
#define _GUS_VOLUME_SCALE 0x0e
|
68 |
|
|
#define _GUS_VOICEVOL2 0x0f
|
69 |
|
|
#define _GUS_VOICE_POS 0x10
|
70 |
|
|
|
71 |
|
|
/*
|
72 |
|
|
* GUS API macros
|
73 |
|
|
*/
|
74 |
|
|
|
75 |
|
|
#define _GUS_CMD(chn, voice, cmd, p1, p2) \
|
76 |
|
|
{_SEQ_NEEDBUF(8); _seqbuf[_seqbufptr] = SEQ_PRIVATE;\
|
77 |
|
|
_seqbuf[_seqbufptr+1] = (chn); _seqbuf[_seqbufptr+2] = cmd;\
|
78 |
|
|
_seqbuf[_seqbufptr+3] = voice;\
|
79 |
|
|
*(unsigned short*)&_seqbuf[_seqbufptr+4] = p1;\
|
80 |
|
|
*(unsigned short*)&_seqbuf[_seqbufptr+6] = p2;\
|
81 |
|
|
_SEQ_ADVBUF(8);}
|
82 |
|
|
|
83 |
|
|
#define GUS_NUMVOICES(chn, p1) _GUS_CMD(chn, 0, _GUS_NUMVOICES, (p1), 0)
|
84 |
|
|
#define GUS_VOICESAMPLE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICESAMPLE, (p1), 0) /* OBSOLETE */
|
85 |
|
|
#define GUS_VOICEON(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEON, (p1), 0)
|
86 |
|
|
#define GUS_VOICEOFF(chn, voice) _GUS_CMD(chn, voice, _GUS_VOICEOFF, 0, 0)
|
87 |
|
|
#define GUS_VOICEFADE(chn, voice) _GUS_CMD(chn, voice, _GUS_VOICEFADE, 0, 0)
|
88 |
|
|
#define GUS_VOICEMODE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEMODE, (p1), 0)
|
89 |
|
|
#define GUS_VOICEBALA(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEBALA, (p1), 0)
|
90 |
|
|
#define GUS_VOICEFREQ(chn, voice, p) _GUS_CMD(chn, voice, _GUS_VOICEFREQ, \
|
91 |
|
|
(p) & 0xffff, ((p) >> 16) & 0xffff)
|
92 |
|
|
#define GUS_VOICEVOL(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEVOL, (p1), 0)
|
93 |
|
|
#define GUS_VOICEVOL2(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEVOL2, (p1), 0)
|
94 |
|
|
#define GUS_RAMPRANGE(chn, voice, low, high) _GUS_CMD(chn, voice, _GUS_RAMPRANGE, (low), (high))
|
95 |
|
|
#define GUS_RAMPRATE(chn, voice, p1, p2) _GUS_CMD(chn, voice, _GUS_RAMPRATE, (p1), (p2))
|
96 |
|
|
#define GUS_RAMPMODE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_RAMPMODE, (p1), 0)
|
97 |
|
|
#define GUS_RAMPON(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_RAMPON, (p1), 0)
|
98 |
|
|
#define GUS_RAMPOFF(chn, voice) _GUS_CMD(chn, voice, _GUS_RAMPOFF, 0, 0)
|
99 |
|
|
#define GUS_VOLUME_SCALE(chn, voice, p1, p2) _GUS_CMD(chn, voice, _GUS_VOLUME_SCALE, (p1), (p2))
|
100 |
|
|
#define GUS_VOICE_POS(chn, voice, p) _GUS_CMD(chn, voice, _GUS_VOICE_POS, \
|
101 |
|
|
(p) & 0xffff, ((p) >> 16) & 0xffff)
|
102 |
|
|
|
103 |
|
|
#endif
|