fiore@0: /*  
fiore@0:  CCmI Editor - A Collaborative Cross-Modal Diagram Editing Tool
fiore@0:   
fiore@0:  Copyright (C) 2011  Queen Mary University of London (http://ccmi.eecs.qmul.ac.uk/)
fiore@0: 
fiore@0:  This program is free software: you can redistribute it and/or modify
fiore@0:  it under the terms of the GNU General Public License as published by
fiore@0:  the Free Software Foundation, either version 3 of the License, or
fiore@0:  (at your option) any later version.
fiore@0: 
fiore@0:  This program is distributed in the hope that it will be useful,
fiore@0:  but WITHOUT ANY WARRANTY; without even the implied warranty of
fiore@0:  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
fiore@0:  GNU General Public License for more details.
fiore@0: 
fiore@0:  You should have received a copy of the GNU General Public License
fiore@0:  along with this program.  If not, see <http://www.gnu.org/licenses/>.
fiore@0: */  
fiore@0: 
fiore@0: package uk.ac.qmul.eecs.ccmi.sound;
fiore@0: 
fiore@0: import java.io.InputStream;
fiore@0: 
fiore@0: /**
fiore@0:  * An object implementing the {@code Sound} interface can be used to play sound 
fiore@0:  * samples either just once or in a continuous loop. The client class needs to provide 
fiore@0:  * a reference to an {@code InputStream} to the sample source.
fiore@0:  * Furthermore, prebuilt sounds
fiore@0:  * associated to the events defined by the {@code SoundEvent} enumeration can be played.
fiore@0:  *
fiore@0:  */
fiore@0: public interface Sound {
fiore@0: 
fiore@0: 	public void play(SoundEvent evt);
fiore@0: 
fiore@0: 	public void play(SoundEvent evt, PlayerListener listener);
fiore@0: 
fiore@0: 	public void play(InputStream sound);
fiore@0: 
fiore@0: 	public void play(InputStream sound, PlayerListener listener);
fiore@0: 	
fiore@0: 	public void stop();
fiore@0: 	
fiore@0: 	public void setMuted(boolean mute);
fiore@0: 
fiore@0: 	public void loadSound(InputStream sound);
fiore@0: 
fiore@0: 	public void startLoop(SoundEvent evt);
fiore@0: 
fiore@0: 	public void stopLoop(SoundEvent evt);
fiore@0: 
fiore@3: 	public void setDefaultPlayerListener(PlayerListener listener,
fiore@0: 			SoundEvent type);
fiore@0: 
fiore@0: 	public void dispose();
fiore@0: 
fiore@0: }