1 /***********************************************************
2 * Artsoft Retro-Game Library *
3 *----------------------------------------------------------*
4 * (c) 1994-2001 Artsoft Entertainment *
6 * Detmolder Strasse 189 *
9 * e-mail: info@artsoft.org *
10 *----------------------------------------------------------*
12 ***********************************************************/
20 #if defined(PLATFORM_UNIX) && !defined(TARGET_SDL)
21 #define AUDIO_UNIX_NATIVE
24 #if defined(PLATFORM_LINUX) || defined(PLATFORM_FREEBSD) || defined(VOXWARE)
25 #define AUDIO_LINUX_IOCTL
28 #if defined(AUDIO_LINUX_IOCTL) || defined(PLATFORM_NETBSD)
29 #define AUDIO_STREAMING_DSP
32 /* values for platform specific sound initialization */
33 #define AUDIO_SAMPLE_RATE_8000 8000
34 #define AUDIO_SAMPLE_RATE_22050 22050
36 #define AUDIO_FRAGMENT_SIZE_512 512
37 #define AUDIO_FRAGMENT_SIZE_1024 1024
38 #define AUDIO_FRAGMENT_SIZE_2048 2048
39 #define AUDIO_FRAGMENT_SIZE_4096 4096
41 #define AUDIO_NUM_CHANNELS_MONO 1
42 #define AUDIO_NUM_CHANNELS_STEREO 2
44 #define AUDIO_FORMAT_UNKNOWN (0)
45 #define AUDIO_FORMAT_U8 (1 << 0)
46 #define AUDIO_FORMAT_S16 (1 << 1)
47 #define AUDIO_FORMAT_LE (1 << 2)
48 #define AUDIO_FORMAT_BE (1 << 3)
50 #if defined(AUDIO_UNIX_NATIVE) && !defined(AUDIO_STREAMING_DSP)
51 #define DEFAULT_AUDIO_SAMPLE_RATE AUDIO_SAMPLE_RATE_8000
53 #define DEFAULT_AUDIO_SAMPLE_RATE AUDIO_SAMPLE_RATE_22050
56 #if defined(PLATFORM_WIN32)
57 #define DEFAULT_AUDIO_FRAGMENT_SIZE AUDIO_FRAGMENT_SIZE_2048
59 #define DEFAULT_AUDIO_FRAGMENT_SIZE AUDIO_FRAGMENT_SIZE_512
62 #if defined(TARGET_SDL)
63 #define NUM_MIXER_CHANNELS MIX_CHANNELS
65 #define NUM_MIXER_CHANNELS 8
68 #define MUSIC_CHANNEL 0
69 #define FIRST_SOUND_CHANNEL 1
72 /* values for PlaySound(), StopSound() and friends */
73 #define SND_CTRL_NONE (0)
74 #define SND_CTRL_MUSIC (1 << 0)
75 #define SND_CTRL_LOOP (1 << 1)
76 #define SND_CTRL_FADE (1 << 2)
77 #define SND_CTRL_STOP (1 << 3)
78 #define SND_CTRL_ALL_SOUNDS (1 << 4)
79 #define SND_CTRL_RELOAD_SOUNDS (1 << 5)
80 #define SND_CTRL_RELOAD_MUSIC (1 << 6)
82 #define SND_CTRL_PLAY_SOUND (SND_CTRL_NONE)
83 #define SND_CTRL_PLAY_LOOP (SND_CTRL_LOOP)
84 #define SND_CTRL_PLAY_MUSIC (SND_CTRL_LOOP | SND_CTRL_MUSIC)
86 #define SND_CTRL_FADE_SOUND (SND_CTRL_FADE)
87 #define SND_CTRL_FADE_MUSIC (SND_CTRL_FADE | SND_CTRL_MUSIC)
88 #define SND_CTRL_FADE_ALL (SND_CTRL_FADE | SND_CTRL_ALL_SOUNDS)
90 #define SND_CTRL_STOP_SOUND (SND_CTRL_STOP)
91 #define SND_CTRL_STOP_MUSIC (SND_CTRL_STOP | SND_CTRL_MUSIC)
92 #define SND_CTRL_STOP_ALL (SND_CTRL_STOP | SND_CTRL_ALL_SOUNDS)
94 #define IS_MUSIC(x) ((x).state & SND_CTRL_MUSIC)
95 #define IS_LOOP(x) ((x).state & SND_CTRL_LOOP)
96 #define IS_FADING(x) ((x).state & SND_CTRL_FADE)
97 #define IS_STOPPING(x) ((x).state & SND_CTRL_STOP)
98 #define IS_RELOADING(x) ((x).state & (SND_CTRL_RELOAD_SOUNDS |\
99 SND_CTRL_RELOAD_MUSIC))
100 #define ALL_SOUNDS(x) ((x).state & SND_CTRL_ALL_SOUNDS)
102 #define SOUND_MIN_VOLUME 0
103 #if defined(TARGET_SDL)
104 #define SOUND_MAX_VOLUME SDL_MIX_MAXVOLUME
105 #elif defined(TARGET_ALLEGRO)
106 #define SOUND_MAX_VOLUME 255
108 #define SOUND_MAX_VOLUME 128
111 #define SOUND_MAX_LEFT 0
112 #define SOUND_MAX_RIGHT 255
113 #define SOUND_MAX_LEFT2RIGHT 255
114 #define SOUND_MIDDLE (SOUND_MAX_LEFT2RIGHT / 2)
116 /* value for undefined sound effect filename */
117 #define SND_FILE_UNDEFINED "NONE"
120 struct SoundEffectInfo
123 char *default_filename;
128 /* general sound functions */
129 void UnixOpenAudio(void);
130 void UnixCloseAudio(void);
132 /* mixer functions */
133 void Mixer_InitChannels(void);
134 void StartMixer(void);
136 /* sound client functions */
139 void PlaySoundStereo(int, int);
140 void PlaySoundLoop(int);
141 void PlaySoundMusic(int);
142 void PlaySoundExt(int, int, int, int);
143 void FadeMusic(void);
145 void FadeSounds(void);
146 void StopMusic(void);
148 void StopSounds(void);
149 void StopSoundExt(int, int);
150 void InitSoundList(struct SoundEffectInfo *, int);
151 void InitReloadSounds(char *);
152 void InitReloadMusic(char *);
153 void FreeAllSounds(void);
154 void FreeAllMusic(void);