mmb.engine.sound.Sounds Maven / Gradle / Ivy

Go to download
/**
 * 
 */
package mmb.engine.sound;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.AudioSystem;
import javax.sound.sampled.UnsupportedAudioFileException;

import mmb.Main;
import mmb.NN;
import mmb.Nil;
import mmb.engine.NotFoundException;
import mmb.engine.debug.Debugger;
import mmb.engine.files.AdvancedFile;
import mmb.engine.mods.ModLoader;

/**
 * A set of sound utilites and a sound library
 * @author oskar
 *
 */
public class Sounds {
	private Sounds() {}
	@NN private static final Debugger debug = new Debugger("SOUNDS");
	
	@NN private static final Map sounds0 = new HashMap<>();
	/** The list of all loaded sounds */
	@NN public static final Map sounds = Collections.unmodifiableMap(sounds0);
	/** A dummy audio format for an empty sound */
	@NN public static final AudioFormat dummyAF = new AudioFormat(48000, 16, 1, false, false);
	/** An empty sound */
	@NN public static final Sound EMPTY = new Sound(new byte[0], dummyAF, 0);
	
	/**
	 * Gets a sound
	 * @param name sound name
	 * @return a sound
	 * @throws NotFoundException when sound does not exist
	 */
	@NN public static Sound getSound(String name) {
		if(!Main.isRunning()) return EMPTY;
		Sound s = sounds0.get(name);
		if(s == null) {
			//Cache miss, load classpath
			try(InputStream in = ModLoader.bcl.getResourceAsStream("sound/"+name)) {
				if(in == null) throw new NotFoundException("Could not find sound "+name);
				s = load(in, name);
				if(s == null) throw new NotFoundException("Could not load sound "+name);
			} catch (IOException e) {
				throw new NotFoundException("Failed to load sound "+name, e);
			}	
		}
		return s;
	}
	/**
	 * Gets a sound or null
	 * @param name sound name
	 * @return a sound or null if not found
	 * @throws NotFoundException when sound exists, but fails to load
	 */
	@Nil public static Sound ngetSound(String name) {
		Sound s = sounds0.get(name);
		if(s == null) {
			//Cache miss, load classpath
			try(InputStream in = ModLoader.bcl.getResourceAsStream("sound/"+name)) {
				if(in == null) return null;
				s = load(in, name);
				if(s == null) throw new NotFoundException("Could not load sound "+name);
			} catch (IOException e) {
				throw new NotFoundException("Failed to load sound "+name, e);
			}	
		}
		return s;
	}
	
	/**
	 * Load the sound data from a file
	 * @param soundData file input stream
	 * @param name sound file name
	 * @return the loaded sound, or null if failed
	 * @throws IOException when sound fails to load
	 */
	public static Sound load(InputStream soundData, String name) throws IOException {
		String ext = AdvancedFile.baseExtension(name)[1];
		Sound loaded = null;
		try(AudioInputStream ais = AudioSystem.getAudioInputStream(new BufferedInputStream(soundData))) {
			switch(ext) {
			case "wav":
				//Wave
				loaded = Sound.load(ais);
				load(loaded, name);
				break;
			case "mp1":
			case "mp2":
			case "mp3":
			case "ogg":
				//MP1/MP2/MP3
				//Ogg Vorbis
		        AudioFormat baseFormat = ais.getFormat();
		        AudioFormat targetFormat = new AudioFormat(AudioFormat.Encoding.PCM_SIGNED, baseFormat.getSampleRate(),
		        16, baseFormat.getChannels(), baseFormat.getChannels() * 2, baseFormat.getSampleRate(), false);
		        AudioInputStream ais2 = AudioSystem.getAudioInputStream(targetFormat, ais);
		        loaded = Sound.load(ais2);
				load(loaded, name);
				break;
			default:
				debug.printl("Unsupported format: "+ext);
			}
		}catch (IOException e) {
			debug.stacktraceError(e, "Failed to load "+ ext.toUpperCase() +" file "+name);
			throw e;
		}catch (UnsupportedAudioFileException e) {
			throw new IOException(e);
		}
		if(loaded != null) load(loaded, name);
		return loaded;
	}
	/**
	 * Adds an existing sound to the audio library
	 * @param sound sound to load
	 * @param name sound name
	 */
	public static void load(Sound sound, String name) {
		debug.printl("Loading a sound: "+name);
		sounds0.put(name, sound);
	}


}