/*
* JSampler - a java front-end for LinuxSampler
*
* Copyright (C) 2005 Grigor Kirilov Iliev
*
* This file is part of JSampler.
*
* JSampler is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2
* as published by the Free Software Foundation.
*
* JSampler is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with JSampler; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA 02111-1307 USA
*/
package org.jsampler;
import java.util.Vector;
import javax.swing.SwingUtilities;
import org.jsampler.event.AudioDeviceEvent;
import org.jsampler.event.AudioDeviceListener;
import org.linuxsampler.lscp.AudioOutputDevice;
/**
* This class provides default implementation of the AudioDeviceModel
interface.
* @author Grigor Iliev
*/
public class DefaultAudioDeviceModel implements AudioDeviceModel {
private AudioOutputDevice audioDevice;
private final Vector listeners = new Vector();
/**
* Creates a new instance of DefaultAudioDeviceModel
using the
* specified non-null audio device.
* @param audioDevice An AudioOutputDevice
instance providing the current
* settings of the audio device which will be represented by this model.
* @throws IllegalArgumentException If audioDevice
is null
.
*/
public
DefaultAudioDeviceModel(AudioOutputDevice audioDevice) {
if(audioDevice == null)
throw new IllegalArgumentException("audioDevice must be non null");
this.audioDevice = audioDevice;
}
/**
* Registers the specified listener to be notified when
* the settings of the audio device are changed.
* @param l The AudioDeviceListener
to register.
*/
public void
addAudioDeviceListener(AudioDeviceListener l) { listeners.add(l); }
/**
* Removes the specified listener.
* @param l The AudioDeviceListener
to remove.
*/
public void
removeAudioDeviceListener(AudioDeviceListener l) { listeners.remove(l); }
/**
* Gets the numerical ID of this audio device.
* @return The numerical ID of this audio device or
* -1 if the device number is not set.
*/
public int
getDeviceID() { return audioDevice.getDeviceID(); }
/**
* Gets the current settings of the audio device represented by this model.
* @return AudioOutputDevice
instance providing
* the current settings of the audio device represented by this model.
*/
public AudioOutputDevice
getDeviceInfo() { return audioDevice; }
/**
* Updates the settings of the audio device represented by this model.
* @param device The new audio device settings.
*/
public void
setDeviceInfo(AudioOutputDevice device) {
audioDevice = device;
fireSettingsChanged();
}
/**
* Sets whether the audio device is enabled or disabled.
* @param active If true
the audio device is enabled,
* else the device is disabled.
*/
public void
setActive(boolean active) {
if(active == getDeviceInfo().isActive()) return;
audioDevice.setActive(active);
fireSettingsChanged();
}
/**
* Determines whether the audio device is active.
* @return true
if the device is enabled and false
otherwise.
*/
public boolean
isActive() { return audioDevice.isActive(); }
/**
* Notifies listeners that the settings of the audio device are changed.
*/
private void
fireSettingsChanged() {
fireSettingsChanged(new AudioDeviceEvent(this, this));
}
/**
* Notifies listeners that the settings of the audio device are changed.
* This method should be invoked from the event-dispatching thread.
*/
private void
fireSettingsChanged(final AudioDeviceEvent e) {
SwingUtilities.invokeLater(new Runnable() {
public void
run() { for(AudioDeviceListener l : listeners) l.settingsChanged(e); }
});
}
}