1 // $Id: sound_manager.h 2353 2005-04-06 23:00:16Z matzebraun $
3 // SuperTux - A Jump'n Run
4 // Copyright (C) 2004 Matthias Braun <matze@braunis.de
6 // This program is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU General Public License
8 // as published by the Free Software Foundation; either version 2
9 // of the License, or (at your option) any later version.
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with this program; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 #ifndef SUPERTUX_SOUND_MANAGER_H
20 #define SUPERTUX_SOUND_MANAGER_H
26 #include "SDL_mixer.h"
27 #include "math/vector.h"
33 * This class handles all sounds that are played
41 /// Play sound (maybe looping), return channel number (or -1 on error)
42 int play_sound(const std::string& sound,int loops=0);
44 /// Play sound relative to two Vectors.
45 int play_sound(const std::string& sound, const Vector& pos,
47 /// Play sound relative to a MovingObject and a Vector.
48 int play_sound(const std::string& sound, const MovingObject* object,
52 * Is used to load the music for a MusicRef.
54 MusicRef load_music(const std::string& file);
57 * If the sound isn't loaded yet try to load it.
58 * Returns an existing instance of the sound, loads a new one and returns that
59 * or returns 0 if loading failed.
61 Mix_Chunk* preload_sound(const std::string& name);
63 /// Test if a certain music file exists.
64 bool exists_music(const std::string& filename);
67 * @param loops: Defaults to -1, which means endless loops.
69 void play_music(const MusicRef& music, int loops = -1);
74 /// Enable/Disable music.
75 void enable_music(bool enable);
80 return m_music_enabled;
83 /// Enable/Disable sound.
84 void enable_sound(bool enable);
89 return m_sound_enabled;
92 /// Is audio available?
93 bool audio_device_available()
98 void set_audio_device_available(bool available)
100 audio_device = available;
104 friend class MusicRef;
107 /// Resource for music.
108 /** Contains the raw music data and
109 information for music reference
116 SoundManager* manager;
121 void free_music(MusicResource* music);
123 typedef std::map<std::string, Mix_Chunk*> Sounds;
126 typedef std::map<std::string, MusicResource> Musics;
129 MusicResource* current_music;
130 bool m_music_enabled;
131 bool m_sound_enabled;
132 bool audio_device; /* true: available and initialized */
135 #endif /*SUPERTUX_SOUND_MANAGER_H*/