![[bottom]](../icons/bottom.png){kind=icon}
![[previous]](../icons/n_left.png){kind=icon}
![[next]](../icons/n_right.png){kind=icon}
![[first]](../icons/n_first.png){kind=icon}
![[last]](../icons/n_last.png){kind=icon}
![[top]](../icons/n_top.png){kind=icon}
![[index]](../icons/index.png){kind=icon}
![[help]](../icons/help.png){kind=icon}
*/
1 #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 by Hannu Savolainen 1993-1996
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions are
13 * met: 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer. 2.
15 * Redistributions in binary form must reproduce the above copyright notice,
16 * this list of conditions and the following disclaimer in the documentation
17 * and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY
20 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
23 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * SUCH DAMAGE.
30 */
31
32
33 /*
34 * Private events for Gravis Ultrasound (GUS)
35 *
36 * Format:
37 * byte 0 - SEQ_PRIVATE (0xfe)
38 * byte 1 - Synthesizer device number (0-N)
39 * byte 2 - Command (see below)
40 * byte 3 - Voice number (0-31)
41 * bytes 4 and 5 - parameter P1 (unsigned short)
42 * bytes 6 and 7 - parameter P2 (unsigned short)
43 *
44 * Commands:
45 * Each command affects one voice defined in byte 3.
46 * Unused parameters (P1 and/or P2 *MUST* be initialized to zero).
47 * _GUS_NUMVOICES - Sets max. number of concurrent voices (P1=14-31, default 16)
48 * _GUS_VOICESAMPLE- ************ OBSOLETE *************
49 * _GUS_VOICEON - Starts voice (P1=voice mode)
50 * _GUS_VOICEOFF - Stops voice (no parameters)
51 * _GUS_VOICEFADE - Stops the voice smoothly.
52 * _GUS_VOICEMODE - Alters the voice mode, don't start or stop voice (P1=voice mode)
53 * _GUS_VOICEBALA - Sets voice balence (P1, 0=left, 7=middle and 15=right, default 7)
54 * _GUS_VOICEFREQ - Sets voice (sample) playback frequency (P1=Hz)
55 * _GUS_VOICEVOL - Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off)
56 * _GUS_VOICEVOL2 - Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off)
57 * (Like GUS_VOICEVOL but doesn't change the hw
58 * volume. It just updates volume in the voice table).
59 *
60 * _GUS_RAMPRANGE - Sets limits for volume ramping (P1=low volume, P2=high volume)
61 * _GUS_RAMPRATE - Sets the speed for volume ramping (P1=scale, P2=rate)
62 * _GUS_RAMPMODE - Sets the volume ramping mode (P1=ramping mode)
63 * _GUS_RAMPON - Starts volume ramping (no parameters)
64 * _GUS_RAMPOFF - Stops volume ramping (no parameters)
65 * _GUS_VOLUME_SCALE - Changes the volume calculation constants
66 * for all voices.
67 */
68
69 #define _GUS_NUMVOICES 0x00
70 #define _GUS_VOICESAMPLE 0x01 /* OBSOLETE */
71 #define _GUS_VOICEON 0x02
72 #define _GUS_VOICEOFF 0x03
73 #define _GUS_VOICEMODE 0x04
74 #define _GUS_VOICEBALA 0x05
75 #define _GUS_VOICEFREQ 0x06
76 #define _GUS_VOICEVOL 0x07
77 #define _GUS_RAMPRANGE 0x08
78 #define _GUS_RAMPRATE 0x09
79 #define _GUS_RAMPMODE 0x0a
80 #define _GUS_RAMPON 0x0b
81 #define _GUS_RAMPOFF 0x0c
82 #define _GUS_VOICEFADE 0x0d
83 #define _GUS_VOLUME_SCALE 0x0e
84 #define _GUS_VOICEVOL2 0x0f
85 #define _GUS_VOICE_POS 0x10
86
87 /*
88 * GUS API macros
89 */
90
91 #define _GUS_CMD(chn, voice, cmd, p1, p2) \
92 {_SEQ_NEEDBUF(8); _seqbuf[_seqbufptr] = SEQ_PRIVATE;\
93 _seqbuf[_seqbufptr+1] = (chn); _seqbuf[_seqbufptr+2] = cmd;\
94 _seqbuf[_seqbufptr+3] = voice;\
95 *(unsigned short*)&_seqbuf[_seqbufptr+4] = p1;\
96 *(unsigned short*)&_seqbuf[_seqbufptr+6] = p2;\
97 _SEQ_ADVBUF(8);}
98
99 #define GUS_NUMVOICES(chn, p1) _GUS_CMD(chn, 0, _GUS_NUMVOICES, (p1), 0)
100 #define GUS_VOICESAMPLE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICESAMPLE, (p1), 0) /* OBSOLETE */
101 #define GUS_VOICEON(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEON, (p1), 0)
102 #define GUS_VOICEOFF(chn, voice) _GUS_CMD(chn, voice, _GUS_VOICEOFF, 0, 0)
103 #define GUS_VOICEFADE(chn, voice) _GUS_CMD(chn, voice, _GUS_VOICEFADE, 0, 0)
104 #define GUS_VOICEMODE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEMODE, (p1), 0)
105 #define GUS_VOICEBALA(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEBALA, (p1), 0)
106 #define GUS_VOICEFREQ(chn, voice, p) _GUS_CMD(chn, voice, _GUS_VOICEFREQ, \
107 (p) & 0xffff, ((p) >> 16) & 0xffff)
108 #define GUS_VOICEVOL(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEVOL, (p1), 0)
109 #define GUS_VOICEVOL2(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEVOL2, (p1), 0)
110 #define GUS_RAMPRANGE(chn, voice, low, high) _GUS_CMD(chn, voice, _GUS_RAMPRANGE, (low), (high))
111 #define GUS_RAMPRATE(chn, voice, p1, p2) _GUS_CMD(chn, voice, _GUS_RAMPRATE, (p1), (p2))
112 #define GUS_RAMPMODE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_RAMPMODE, (p1), 0)
113 #define GUS_RAMPON(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_RAMPON, (p1), 0)
114 #define GUS_RAMPOFF(chn, voice) _GUS_CMD(chn, voice, _GUS_RAMPOFF, 0, 0)
115 #define GUS_VOLUME_SCALE(chn, voice, p1, p2) _GUS_CMD(chn, voice, _GUS_VOLUME_SCALE, (p1), (p2))
116 #define GUS_VOICE_POS(chn, voice, p) _GUS_CMD(chn, voice, _GUS_VOICE_POS, \
117 (p) & 0xffff, ((p) >> 16) & 0xffff)
118
119 #endif
![[top]](../icons/top.png){kind=icon}
![[bottom]](../icons/n_bottom.png){kind=icon}
*/