#region Copyright & License Information /* * Copyright 2007-2011 The OpenRA Developers (see AUTHORS) * This file is part of OpenRA, which is free software. It is made * available to you under the terms of the GNU General Public License * as published by the Free Software Foundation. For more information, * see COPYING. */ #endregion using System; using System.Collections.Generic; using System.Linq; using OpenRA.FileFormats; using OpenRA.GameRules; using OpenRA.Traits; using Tao.OpenAl; namespace OpenRA { public static class Sound { static ISoundEngine soundEngine; static Cache sounds; static ISoundSource rawSource; static ISound music; static ISound video; static MusicInfo currentMusic; static ISoundSource LoadSound(string filename) { if (!FileSystem.Exists(filename)) { Log.Write("sound", "LoadSound, file does not exist: {0}", filename); return null; } if (filename.ToLowerInvariant().EndsWith("wav")) return LoadWave(new WavLoader(FileSystem.Open(filename))); else return LoadSoundRaw(AudLoader.LoadSound(FileSystem.Open(filename))); } static ISoundSource LoadWave(WavLoader wave) { return soundEngine.AddSoundSourceFromMemory(wave.RawOutput, wave.Channels, wave.BitsPerSample, wave.SampleRate); } static ISoundSource LoadSoundRaw(byte[] rawData) { return soundEngine.AddSoundSourceFromMemory(rawData, 1, 16, 22050); } static ISoundEngine CreateEngine(string engine) { engine = Game.Settings.Server.Dedicated ? "Null" : engine; switch (engine) { /* TODO: if someone cares about pluggable crap here, ship this out */ case "AL": return new OpenAlSoundEngine(); case "Null": return new NullSoundEngine(); default: throw new InvalidOperationException("Unsupported sound engine: {0}".F (engine)); } } public static void Create(string engine) { soundEngine = CreateEngine(engine); } public static void Initialize() { sounds = new Cache(LoadSound); music = null; currentMusic = null; video = null; } public static SoundDevice[] AvailableDevices() { var defaultDevices = new [] { new SoundDevice("AL", null, "Default Output"), new SoundDevice("Null", null, "Output Disabled") }; var alDevices = OpenAlSoundEngine.AvailableDevices() .Select(d => new SoundDevice("AL", d, d)); return defaultDevices.Concat(alDevices).ToArray(); } public static void SetListenerPosition(WPos position) { soundEngine.SetListenerPosition(position); } static ISound Play(Player player, string name, bool headRelative, WPos pos, float volumeModifier) { if (String.IsNullOrEmpty(name)) return null; if (player != null && player != player.World.LocalPlayer) return null; return soundEngine.Play2D(sounds[name], false, headRelative, pos, InternalSoundVolume * volumeModifier, true); } public static ISound Play(string name) { return Play(null, name, true, WPos.Zero, 1); } public static ISound Play(string name, WPos pos) { return Play(null, name, false, pos, 1); } public static ISound Play(string name, float volumeModifier) { return Play(null, name, true, WPos.Zero, volumeModifier); } public static ISound Play(string name, WPos pos, float volumeModifier) { return Play(null, name, false, pos, volumeModifier); } public static ISound PlayToPlayer(Player player, string name) { return Play(player, name, true, WPos.Zero, 1); } public static ISound PlayToPlayer(Player player, string name, WPos pos) { return Play(player, name, false, pos, 1); } public static void PlayVideo(byte[] raw) { rawSource = LoadSoundRaw(raw); video = soundEngine.Play2D(rawSource, false, true, WPos.Zero, InternalSoundVolume, false); } public static void PlayVideo() { if (video != null) soundEngine.PauseSound(video, false); } public static void PauseVideo() { if (video != null) soundEngine.PauseSound(video, true); } public static void StopVideo() { if (video != null) soundEngine.StopSound(video); } public static void Tick() { // Song finished if (MusicPlaying && !music.Playing) { StopMusic(); OnMusicComplete(); } } static Action OnMusicComplete; public static bool MusicPlaying { get; private set; } public static MusicInfo CurrentMusic { get { return currentMusic; } } public static void PlayMusic(MusicInfo m) { PlayMusicThen(m, () => { }); } public static void PlayMusicThen(MusicInfo m, Action then) { if (m == null || !m.Exists) return; OnMusicComplete = then; if (m == currentMusic && music != null) { soundEngine.PauseSound(music, false); MusicPlaying = true; return; } StopMusic(); var sound = sounds[m.Filename]; if (sound == null) return; music = soundEngine.Play2D(sound, false, true, WPos.Zero, MusicVolume, false); currentMusic = m; MusicPlaying = true; } public static void PlayMusic() { if (music == null) return; MusicPlaying = true; soundEngine.PauseSound(music, false); } public static void StopSound(ISound sound) { if (sound != null) soundEngine.StopSound(sound); } public static void StopMusic() { if (music != null) soundEngine.StopSound(music); MusicPlaying = false; currentMusic = null; } public static void PauseMusic() { if (music == null) return; MusicPlaying = false; soundEngine.PauseSound(music, true); } public static float GlobalVolume { get { return soundEngine.Volume; } set { soundEngine.Volume = value; } } static float soundVolumeModifier = 1.0f; public static float SoundVolumeModifier { get { return soundVolumeModifier; } set { soundVolumeModifier = value; soundEngine.SetSoundVolume(InternalSoundVolume, music, video); } } static float InternalSoundVolume { get { return SoundVolume * soundVolumeModifier; } } public static float SoundVolume { get { return Game.Settings.Sound.SoundVolume; } set { Game.Settings.Sound.SoundVolume = value; soundEngine.SetSoundVolume(InternalSoundVolume, music, video); } } public static float MusicVolume { get { return Game.Settings.Sound.MusicVolume; } set { Game.Settings.Sound.MusicVolume = value; if (music != null) music.Volume = value; } } public static float VideoVolume { get { return Game.Settings.Sound.VideoVolume; } set { Game.Settings.Sound.VideoVolume = value; if (video != null) video.Volume = value; } } public static float MusicSeekPosition { get { return (music != null) ? music.SeekPosition : 0; } } public static float VideoSeekPosition { get { return (video != null) ? video.SeekPosition : 0; } } // Returns true if played successfully public static bool PlayPredefined(Player p, Actor voicedUnit, string type, string definition, string variant, bool attenuateVolume) { if (definition == null) return false; if (Rules.Voices == null) return false; if (Rules.Notifications == null) return false; var rules = (voicedUnit != null) ? Rules.Voices[type] : Rules.Notifications[type]; if (rules == null) return false; var ID = (voicedUnit != null) ? voicedUnit.ActorID : 0; string clip; var suffix = rules.DefaultVariant; var prefix = rules.DefaultPrefix; if (voicedUnit != null) { if (!rules.VoicePools.Value.ContainsKey("Attack")) rules.VoicePools.Value.Add("Attack", rules.VoicePools.Value["Move"]); if (!rules.VoicePools.Value.ContainsKey("AttackMove")) rules.VoicePools.Value.Add("AttackMove", rules.VoicePools.Value["Move"]); if (!rules.VoicePools.Value.ContainsKey(definition)) throw new InvalidOperationException("Can't find {0} in voice pool.".F(definition)); clip = rules.VoicePools.Value[definition].GetNext(); } else { if (!rules.NotificationsPools.Value.ContainsKey(definition)) throw new InvalidOperationException("Can't find {0} in notification pool.".F(definition)); clip = rules.NotificationsPools.Value[definition].GetNext(); } if (String.IsNullOrEmpty(clip)) return false; if (variant != null) { if (rules.Variants.ContainsKey(variant) && !rules.DisableVariants.Contains(definition)) suffix = rules.Variants[variant][ID % rules.Variants[variant].Length]; if (rules.Prefixes.ContainsKey(variant) && !rules.DisablePrefixes.Contains(definition)) prefix = rules.Prefixes[variant][ID % rules.Prefixes[variant].Length]; } var name = prefix + clip + suffix; if (!String.IsNullOrEmpty(name) && (p == null || p == p.World.LocalPlayer)) soundEngine.Play2D(sounds[name], false, true, WPos.Zero, InternalSoundVolume, attenuateVolume); return true; } public static bool PlayVoice(string phrase, Actor voicedUnit, string variant) { if (voicedUnit == null) return false; if (phrase == null) return false; var mi = voicedUnit.Info.Traits.GetOrDefault(); if (mi == null) return false; if (mi.Voice == null) return false; var type = mi.Voice.ToLowerInvariant(); return PlayPredefined(null, voicedUnit, type, phrase, variant, true); } public static bool PlayNotification(Player player, string type, string notification, string variant) { if (type == null) return false; if (notification == null) return false; return PlayPredefined(player, null, type.ToLowerInvariant(), notification, variant, false); } } interface ISoundEngine { ISoundSource AddSoundSourceFromMemory(byte[] data, int channels, int sampleBits, int sampleRate); ISound Play2D(ISoundSource sound, bool loop, bool relative, WPos pos, float volume, bool attenuateVolume); float Volume { get; set; } void PauseSound(ISound sound, bool paused); void StopSound(ISound sound); void SetAllSoundsPaused(bool paused); void StopAllSounds(); void SetListenerPosition(WPos position); void SetSoundVolume(float volume, ISound music, ISound video); } public class SoundDevice { public readonly string Engine; public readonly string Device; public readonly string Label; public SoundDevice(string engine, string device, string label) { Engine = engine; Device = device; Label = label; // Limit label to 32 characters if (Label.Length > 32) Label = "..." + Label.Substring(Label.Length - 32); } } interface ISoundSource { } public interface ISound { float Volume { get; set; } float SeekPosition { get; } bool Playing { get; } } class OpenAlSoundEngine : ISoundEngine { class PoolSlot { public bool isActive; public int frameStarted; public WPos pos; public bool isRelative; public ISoundSource sound; } float volume = 1f; Dictionary sourcePool = new Dictionary(); const int POOL_SIZE = 32; static string[] QueryDevices(string label, int type) { // Clear error bit Al.alGetError(); var devices = Alc.alcGetStringv(IntPtr.Zero, type); if (Al.alGetError() != Al.AL_NO_ERROR) { Log.Write("sound", "Failed to query OpenAL device list using {0}", label); return new string[] {}; } return devices; } public static string[] AvailableDevices() { // Returns all devices under windows vista and newer if (Alc.alcIsExtensionPresent(IntPtr.Zero, "ALC_ENUMERATE_ALL_EXT") == Alc.ALC_TRUE) return QueryDevices("ALC_ENUMERATE_ALL_EXT", Alc.ALC_ALL_DEVICES_SPECIFIER); if (Alc.alcIsExtensionPresent(IntPtr.Zero, "ALC_ENUMERATION_EXT") == Alc.ALC_TRUE) return QueryDevices("ALC_ENUMERATION_EXT", Alc.ALC_DEVICE_SPECIFIER); return new string[] {}; } public OpenAlSoundEngine() { Console.WriteLine("Using OpenAL sound engine"); if (Game.Settings.Sound.Device != null) Console.WriteLine("Using device `{0}`", Game.Settings.Sound.Device); else Console.WriteLine("Using default device"); var dev = Alc.alcOpenDevice(Game.Settings.Sound.Device); if (dev == IntPtr.Zero) { Console.WriteLine("Failed to open device. Falling back to default"); dev = Alc.alcOpenDevice(null); if (dev == IntPtr.Zero) throw new InvalidOperationException("Can't create OpenAL device"); } var ctx = Alc.alcCreateContext(dev, IntPtr.Zero); if (ctx == IntPtr.Zero) throw new InvalidOperationException("Can't create OpenAL context"); Alc.alcMakeContextCurrent(ctx); for (var i = 0; i < POOL_SIZE; i++) { var source = 0; Al.alGenSources(1, out source); if (0 != Al.alGetError()) { Log.Write("sound", "Failed generating OpenAL source {0}", i); return; } sourcePool.Add(source, new PoolSlot() { isActive = false }); } } int GetSourceFromPool() { foreach (var kvp in sourcePool) { if (!kvp.Value.isActive) { sourcePool[kvp.Key].isActive = true; return kvp.Key; } } List freeSources = new List(); foreach (int key in sourcePool.Keys) { int state; Al.alGetSourcei(key, Al.AL_SOURCE_STATE, out state); if (state != Al.AL_PLAYING && state != Al.AL_PAUSED) freeSources.Add(key); } if (freeSources.Count == 0) return -1; foreach (int i in freeSources) sourcePool[i].isActive = false; sourcePool[freeSources[0]].isActive = true; return freeSources[0]; } public ISoundSource AddSoundSourceFromMemory(byte[] data, int channels, int sampleBits, int sampleRate) { return new OpenAlSoundSource(data, channels, sampleBits, sampleRate); } const int maxInstancesPerFrame = 3; const int groupDistance = 2730; const int groupDistanceSqr = groupDistance * groupDistance; public ISound Play2D(ISoundSource sound, bool loop, bool relative, WPos pos, float volume, bool attenuateVolume) { if (sound == null) { Log.Write("sound", "Attempt to Play2D a null `ISoundSource`"); return null; } var world = Game.orderManager.world; int currFrame = world != null ? world.FrameNumber : 0; float atten = 1f; // Check if max # of instances-per-location reached: if (attenuateVolume) { int instances = 0, activeCount = 0; foreach (var s in sourcePool.Values) { if (!s.isActive) continue; if (s.isRelative != relative) continue; ++activeCount; if (s.sound != sound) continue; if (currFrame - s.frameStarted >= 5) continue; // Too far away to count? var lensqr = (s.pos - pos).LengthSquared; if (lensqr >= groupDistanceSqr) continue; // If we are starting too many instances of the same sound within a short time then stop this one: if (++instances == maxInstancesPerFrame) return null; } // Attenuate a little bit based on number of active sounds: atten = 0.66f * ((POOL_SIZE - activeCount * 0.5f) / POOL_SIZE); } int source = GetSourceFromPool(); if (source == -1) return null; var slot = sourcePool[source]; slot.pos = pos; slot.frameStarted = currFrame; slot.sound = sound; slot.isRelative = relative; return new OpenAlSound(source, (sound as OpenAlSoundSource).buffer, loop, relative, pos, volume * atten); } public float Volume { get { return volume; } set { Al.alListenerf(Al.AL_GAIN, volume = value); } } public void PauseSound(ISound sound, bool paused) { if (sound == null) return; int key = ((OpenAlSound)sound).source; int state; Al.alGetSourcei(key, Al.AL_SOURCE_STATE, out state); if (state == Al.AL_PLAYING && paused) Al.alSourcePause(key); else if (state == Al.AL_PAUSED && !paused) Al.alSourcePlay(key); } public void SetAllSoundsPaused(bool paused) { foreach (int key in sourcePool.Keys) { int state; Al.alGetSourcei(key, Al.AL_SOURCE_STATE, out state); if (state == Al.AL_PLAYING && paused) Al.alSourcePause(key); else if (state == Al.AL_PAUSED && !paused) Al.alSourcePlay(key); } } public void SetSoundVolume(float volume, ISound music, ISound video) { var sounds = sourcePool.Select(s => s.Key).Where(b => { int state; Al.alGetSourcei(b, Al.AL_SOURCE_STATE, out state); return ((state == Al.AL_PLAYING || state == Al.AL_PAUSED) && ((music == null) || b != ((OpenAlSound)music).source) && ((video == null) || b != ((OpenAlSound)video).source)); }).ToList(); foreach (var s in sounds) { Al.alSourcef(s, Al.AL_GAIN, volume); } } public void StopSound(ISound sound) { if (sound == null) return; int key = ((OpenAlSound)sound).source; int state; Al.alGetSourcei(key, Al.AL_SOURCE_STATE, out state); if (state == Al.AL_PLAYING || state == Al.AL_PAUSED) Al.alSourceStop(key); } public void StopAllSounds() { foreach (int key in sourcePool.Keys) { int state; Al.alGetSourcei(key, Al.AL_SOURCE_STATE, out state); if (state == Al.AL_PLAYING || state == Al.AL_PAUSED) Al.alSourceStop(key); } } public void SetListenerPosition(WPos position) { // Move the listener out of the plane so that sounds near the middle of the screen aren't too positional Al.alListener3f(Al.AL_POSITION, position.X, position.Y, position.Z + 2133); var orientation = new[] { 0f, 0f, 1f, 0f, -1f, 0f }; Al.alListenerfv(Al.AL_ORIENTATION, ref orientation[0]); Al.alListenerf(Al.AL_METERS_PER_UNIT, .01f); } } class OpenAlSoundSource : ISoundSource { public readonly int buffer; static int MakeALFormat(int channels, int bits) { if (channels == 1) return bits == 16 ? Al.AL_FORMAT_MONO16 : Al.AL_FORMAT_MONO8; else return bits == 16 ? Al.AL_FORMAT_STEREO16 : Al.AL_FORMAT_STEREO8; } public OpenAlSoundSource(byte[] data, int channels, int sampleBits, int sampleRate) { Al.alGenBuffers(1, out buffer); Al.alBufferData(buffer, MakeALFormat(channels, sampleBits), data, data.Length, sampleRate); } } class OpenAlSound : ISound { public readonly int source = -1; float volume = 1f; public OpenAlSound(int source, int buffer, bool looping, bool relative, WPos pos, float volume) { if (source == -1) return; this.source = source; Al.alSourcef(source, Al.AL_PITCH, 1f); Volume = volume; Al.alSource3f(source, Al.AL_POSITION, pos.X, pos.Y, pos.Z); Al.alSource3f(source, Al.AL_VELOCITY, 0f, 0f, 0f); Al.alSourcei(source, Al.AL_BUFFER, buffer); Al.alSourcei(source, Al.AL_LOOPING, looping ? Al.AL_TRUE : Al.AL_FALSE); Al.alSourcei(source, Al.AL_SOURCE_RELATIVE, relative ? 1 : 0); Al.alSourcef(source, Al.AL_REFERENCE_DISTANCE, 6826); Al.alSourcef(source, Al.AL_MAX_DISTANCE, 136533); Al.alSourcePlay(source); } public float Volume { get { return volume; } set { if (source != -1) Al.alSourcef(source, Al.AL_GAIN, volume = value); } } public float SeekPosition { get { float pos; Al.alGetSourcef(source, Al.AL_SAMPLE_OFFSET, out pos); return pos / 22050f; } } public bool Playing { get { int state; Al.alGetSourcei(source, Al.AL_SOURCE_STATE, out state); return state == Al.AL_PLAYING; } } } class NullSoundEngine : ISoundEngine { public NullSoundEngine() { Console.WriteLine("Using Null sound engine which disables SFX completely"); } public ISoundSource AddSoundSourceFromMemory(byte[] data, int channels, int sampleBits, int sampleRate) { return new NullSoundSource(); } public ISound Play2D(ISoundSource sound, bool loop, bool relative, WPos pos, float volume, bool attenuateVolume) { return new NullSound(); } public void PauseSound(ISound sound, bool paused) {} public void StopSound(ISound sound) {} public void SetAllSoundsPaused(bool paused) {} public void StopAllSounds() {} public void SetListenerPosition(WPos position) {} public void SetSoundVolume(float volume, ISound music, ISound video) {} public float Volume { get; set; } } class NullSoundSource : ISoundSource {} class NullSound : ISound { public float Volume { get; set; } public float SeekPosition { get { return 0; } } public bool Playing { get { return false; } } } }