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