Thread: [Japi-cvs] SF.net SVN: japi:[686] libs

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Revision: 686
          http://japi.svn.sourceforge.net/japi/?rev=686&view=rev
Author:   christianhujer
Date:     2008-10-07 20:31:57 +0000 (Tue, 07 Oct 2008)

Log Message:
-----------
Added midi library.

Added Paths:
-----------
    libs/midi/
    libs/midi/branches/
    libs/midi/tags/
    libs/midi/trunk/
    libs/midi/trunk/midi.iml
    libs/midi/trunk/src/
    libs/midi/trunk/src/doc/
    libs/midi/trunk/src/prj/
    libs/midi/trunk/src/prj/net/
    libs/midi/trunk/src/prj/net/sf/
    libs/midi/trunk/src/prj/net/sf/japi/
    libs/midi/trunk/src/prj/net/sf/japi/midi/
    libs/midi/trunk/src/prj/net/sf/japi/midi/DeviceComparator.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.properties
    libs/midi/trunk/src/prj/net/sf/japi/midi/IntervalTrainer.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/Interval_de.properties
    libs/midi/trunk/src/prj/net/sf/japi/midi/MidiUtils.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/MonitorReceiver.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/MultiReceiver.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/OutputConfiguration.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/gui/
    libs/midi/trunk/src/prj/net/sf/japi/midi/gui/MidiDeviceListCellRenderer.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/gui/OutputConfigurator.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/gui/SpinnerChannelModel.java
    libs/midi/trunk/src/prj/net/sf/japi/midi/gui/action.properties
    libs/midi/trunk/src/tst/

Added: libs/midi/trunk/midi.iml
===================================================================

--- libs/midi/trunk/midi.iml	                        (rev 0)
+++ libs/midi/trunk/midi.iml	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module relativePaths="true" type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src/doc" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/prj" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/tst" isTestSource="true" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" name="annotations" level="project" />
+    <orderEntry type="library" name="junit" level="project" />
+    <orderEntry type="module" module-name="libs-swing-action" />
+    <orderEntryProperties />
+  </component>
+</module>
+


Property changes on: libs/midi/trunk/midi.iml
___________________________________________________________________
Added: svn:mime-type
   + text/xml
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/DeviceComparator.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/DeviceComparator.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/DeviceComparator.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,24 @@
+package net.sf.japi.midi;
+
+import java.util.Comparator;
+import javax.sound.midi.MidiDevice;
+
+/** Comparator for MidiDevices which compares them by name.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class DeviceComparator implements Comparator<MidiDevice> {
+
+    private static Comparator<? super MidiDevice> instance = new DeviceComparator();
+
+    /** {@inheritDoc} */
+    public int compare(final MidiDevice o1, final MidiDevice o2) {
+        return o1.getDeviceInfo().getName().compareTo(o2.getDeviceInfo().getName());
+    }
+
+    /** Returns a default instance.
+     * @return Default instance.
+     */
+    public static Comparator<? super MidiDevice> getInstance() {
+        return instance;
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/DeviceComparator.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,29 @@
+package net.sf.japi.midi;
+
+import java.util.Locale;
+import java.util.ResourceBundle;
+import org.jetbrains.annotations.NotNull;
+
+/** An Interval, used for the {@link IntervalTrainer}.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class Interval {
+
+    /** The distance of this interval, e.g. 0 for prime, 12 for octave. */
+    private int distance;
+
+    /** Returns the names of this interval in the current locale.
+     * @return The names of this interval in the current locale.
+     */
+    public String[] getNames() {
+        return ResourceBundle.getBundle("Interval").getString("I_" + distance + ".names").split(",");
+    }
+
+    /** Returns the names of this interval in the specified locale.
+     * @param locale Locale in which to return the names.
+     * @return The names of this interval in the specified locale.
+     */
+    public String[] getNames(@NotNull final Locale locale) {
+        return ResourceBundle.getBundle("Interval", locale).getString("I_" + distance + ".names").split(",");
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.properties
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.properties	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.properties	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,13 @@
+I_0.names=Prime
+I_1.names=Kleine Sekunde,\xDCberm\xE4\xDFige Prime
+I_2.names=Gro\xDFe Sekunde,Verminderte Terz
+I_3.names=Kleine Terz
+I_4.names=Gro\xDFe Terz
+I_5.names=Quarte,\xDCberm\xE4\xDFige Terz
+I_6.names=Tritonus,\xDCberm\xE4\xDFige Quarte,Verminderte Quinte
+I_7.names=Quinte,Verminderte Sexte
+I_8.names=Kleine Sexte,\xDCberm\xE4\xDFige Quinte
+I_9.names=Gro\xDFe Sexte,Verminderte Septime
+I_10.names=Kleine Septime,\xDCberm\xE4\xDFige Sexte
+I_11.names=Gro\xDFe Septime,Verminderte Oktave
+I_12.names=Oktave,\xDCberm\xE4\xDFige Septime


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/Interval.properties
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/IntervalTrainer.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/IntervalTrainer.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/IntervalTrainer.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,10 @@
+package net.sf.japi.midi;
+
+/** Training program for intervals.
+ * Plays intervals and asks the user to tell the correct kind of interval.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class IntervalTrainer {
+
+}
+


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/IntervalTrainer.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/Interval_de.properties
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/Interval_de.properties	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/Interval_de.properties	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,13 @@
+I_0.names=Prime
+I_1.names=Kleine Sekunde,\xDCberm\xE4\xDFige Prime
+I_2.names=Gro\xDFe Sekunde,Verminderte Terz
+I_3.names=Kleine Terz
+I_4.names=Gro\xDFe Terz
+I_5.names=Quarte,\xDCberm\xE4\xDFige Terz
+I_6.names=Tritonus,\xDCberm\xE4\xDFige Quarte,Verminderte Quinte
+I_7.names=Quinte,Verminderte Sexte
+I_8.names=Kleine Sexte,\xDCberm\xE4\xDFige Quinte
+I_9.names=Gro\xDFe Sexte,Verminderte Septime
+I_10.names=Kleine Septime,\xDCberm\xE4\xDFige Sexte
+I_11.names=Gro\xDFe Septime,Verminderte Oktave
+I_12.names=Oktave,\xDCberm\xE4\xDFige Septime


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/Interval_de.properties
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/MidiUtils.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/MidiUtils.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/MidiUtils.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,136 @@
+package net.sf.japi.midi;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import javax.sound.midi.InvalidMidiDataException;
+import javax.sound.midi.MidiDevice;
+import javax.sound.midi.MidiSystem;
+import javax.sound.midi.MidiUnavailableException;
+import javax.sound.midi.Receiver;
+import javax.sound.midi.SysexMessage;
+import javax.sound.midi.Transmitter;
+import org.jetbrains.annotations.NotNull;
+
+/** Utility functions for working with MIDI.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class MidiUtils {
+
+    /** Utility class - do not instanciate. */
+    private MidiUtils() {
+    }
+
+    /** Returns all {@link MidiDevice}s which provide {@link Receiver}s.
+     * @return All {@link MidiDevice}s which provide {@link Receiver}s.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static MidiDevice[] getAllReceivingDevices() throws MidiUnavailableException {
+        return getReceivingDevices(MidiSystem.getMidiDeviceInfo());
+    }
+
+    /** Returns all {@iink MidiDevice}s which provide {@link Transmitter}s.
+     * @return All {@link MidiDevice}s which provide {@link Transmitter}s.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static MidiDevice[] getAllTransmittingDevices() throws MidiUnavailableException {
+        return getTransmittingDevices(MidiSystem.getMidiDeviceInfo());
+    }
+
+    /** Returns those {@link MidiDevice}s which provide {@link Receiver}s.
+     * @param infos Device informations of which to return devices.
+     * @return Those {@link MidiDevice}s from <var>infos</var> which provide {@link Receiver}s.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static MidiDevice[] getReceivingDevices(final MidiDevice.Info... infos) throws MidiUnavailableException {
+        final List<MidiDevice> receivingDevices = new ArrayList<MidiDevice>();
+        for (final MidiDevice.Info deviceInfo : infos) {
+            final MidiDevice device = MidiSystem.getMidiDevice(deviceInfo);
+            if (device.getMaxReceivers() != 0) {
+                receivingDevices.add(device);
+            }
+        }
+        Collections.sort(receivingDevices, DeviceComparator.getInstance());
+        return receivingDevices.toArray(new MidiDevice[receivingDevices.size()]);
+    }
+
+    /** Returns those {@link MidiDevice}s which provide {@link Transmitter}s.
+     * @param infos Device informations of which to return devices.
+     * @return Those {@link MidiDevice}s from <var>infos</var> which provide {@link Transmitter}s.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static MidiDevice[] getTransmittingDevices(final MidiDevice.Info... infos) throws MidiUnavailableException {
+        final List<MidiDevice> transmittingDevices = new ArrayList<MidiDevice>();
+        for (final MidiDevice.Info deviceInfo : infos) {
+            final MidiDevice device = MidiSystem.getMidiDevice(deviceInfo);
+            if (device.getMaxTransmitters() != 0) {
+                transmittingDevices.add(device);
+            }
+        }
+        Collections.sort(transmittingDevices, DeviceComparator.getInstance());
+        return transmittingDevices.toArray(new MidiDevice[transmittingDevices.size()]);
+    }
+
+    /** Creates a Sysex message from a String.
+     * @param data String from which to create the Sysex message.
+     * @return Sysex message created from <var>data</var>.
+     * @throws InvalidMidiDataException if <var>data</var> does not denote a valid Sysex message (the first byte must be 0xF0 or 0xF7).
+     */
+    public static SysexMessage createSysexMessage(@NotNull final String data) throws InvalidMidiDataException {
+        final SysexMessage message = new SysexMessage();
+        final byte[] realData = new byte[data.length() / 2];
+        for (int i = 0; i < realData.length; i++) {
+            realData[i] = (byte) Integer.parseInt(data.substring(i * 2, i * 2 + 2), 16);
+        }
+        System.out.format("%n");
+        message.setMessage(realData, realData.length);
+        return message;
+    }
+
+    /** Returns the first device found in the system with the specified name that provides Receivers.
+     * @param name Name of the receiving device to return.
+     * @return The requested device or <code>null</code> if the requested device was not found.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static MidiDevice getReceivingDevice(@NotNull final String name) throws MidiUnavailableException {
+        for (final MidiDevice.Info deviceInfo : MidiSystem.getMidiDeviceInfo()) {
+            if (deviceInfo.getName().equals(name)) {
+                final MidiDevice device = MidiSystem.getMidiDevice(deviceInfo);
+                if (device.getMaxReceivers() != 0) {
+                    return device;
+                }
+            }
+        }
+        return null;
+    }
+
+    /** Returns the first device found in the system with the specified name that provides Transmitters.
+     * @param name Name of the receiving device to return.
+     * @return The requested device or <code>null</code> if the requested device was not found.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static MidiDevice getTransmittingDevice(@NotNull final String name) throws MidiUnavailableException {
+        for (final MidiDevice.Info deviceInfo : MidiSystem.getMidiDeviceInfo()) {
+            if (deviceInfo.getName().equals(name)) {
+                final MidiDevice device = MidiSystem.getMidiDevice(deviceInfo);
+                if (device.getMaxTransmitters() != 0) {
+                    return device;
+                }
+            }
+        }
+        return null;
+    }
+
+    /** Returns a device by its name.
+     * @param name Name of the device to return.
+     * @return The first device found that matches <var>name</var> or <code>null</code> if the requested device was not found.
+     */
+    public static MidiDevice getDeviceByName(@NotNull final String name) throws MidiUnavailableException {
+        for (final MidiDevice.Info deviceInfo : MidiSystem.getMidiDeviceInfo()) {
+            if (deviceInfo.getName().equals(name)) {
+                return MidiSystem.getMidiDevice(deviceInfo);
+            }
+        }
+        return null;
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/MidiUtils.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/MonitorReceiver.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/MonitorReceiver.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/MonitorReceiver.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,76 @@
+package net.sf.japi.midi;
+
+import java.io.Closeable;
+import java.io.IOException;
+import java.util.Formatter;
+import javax.sound.midi.MidiMessage;
+import javax.sound.midi.Receiver;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/** A MonitorReceiver is a Receiver that prints messages to System.out.
+ * It optionally can delegate to another receiver.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class MonitorReceiver implements Receiver {
+
+    /** The Receiver to which to delegate. */
+    @Nullable private final Receiver receiver;
+
+    /** The prefix for messages printed by this MonitorReceiver. */
+    private final String prefix;
+
+    /** The Appendable to which messages are printed. */
+    private final Appendable out;
+
+    /** The Formatter that is used to format messages to {@link #out}. */
+    private final Formatter format;
+
+    /** Create a MonitorReceiver.
+     * @param prefix Prefix for messages printed by this MonitorReceiver.
+     */
+    public MonitorReceiver(@NotNull final String prefix) {
+        this(prefix, null);
+    }
+
+    /** Create a MonitorReceiver.
+     * @param prefix Prefix for messages printed by this MonitorReceiver.
+     * @param receiver Receiver to which messages shall be delegated.
+     */
+    public MonitorReceiver(@NotNull final String prefix, @Nullable final Receiver receiver) {
+        this.prefix = prefix;
+        out = System.out;
+        format = new Formatter(out);
+        this.receiver = receiver;
+    }
+
+    /** {@inheritDoc} */
+    public void send(final MidiMessage message, final long timeStamp) {
+        format.format("[%s] %08x ", prefix, timeStamp);
+        final byte[] msg = message.getMessage();
+        for (final byte b : msg) {
+            format.format("%02x", b);
+        }
+        format.format("%n");
+        format.flush();
+        if (receiver != null) {
+            receiver.send(message, timeStamp);
+        }
+    }
+
+    /** {@inheritDoc} */
+    public void close() {
+        if (receiver != null) {
+            receiver.close();
+        }
+        format.flush();
+        if (out instanceof Closeable) {
+            try {
+                ((Closeable) out).close();
+            } catch (final IOException e) {
+                // ignore
+            }
+        }
+    }
+
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/MonitorReceiver.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/MultiReceiver.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/MultiReceiver.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/MultiReceiver.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,44 @@
+package net.sf.japi.midi;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import javax.sound.midi.MidiMessage;
+import javax.sound.midi.Receiver;
+import org.jetbrains.annotations.NotNull;
+
+/** A Midi Receiver which sends its received message to an arbitrary number of other receivers.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class MultiReceiver implements Receiver {
+
+    /** The Receivers. */
+    private final Collection<Receiver> receivers = new ArrayList<Receiver>();
+
+    /** Adds a Receiver.
+     * @param receiver Receiver to add.
+     */
+    public void addReceiver(@NotNull final Receiver receiver) {
+        receivers.add(receiver);
+    }
+
+    /** Removes a Receiver.
+     * @param receiver Receiver to remove.
+     */
+    public void removeReceiver(@NotNull final Receiver receiver) {
+        receivers.remove(receiver);
+    }
+
+    /** {@inheritDoc} */
+    public void send(final MidiMessage message, final long timeStamp) {
+        for (final Receiver receiver : receivers) {
+            receiver.send(message, timeStamp);
+        }
+    }
+
+    /** {@inheritDoc} */
+    public void close() {
+        for (final Receiver receiver : receivers) {
+            receiver.close();
+        }
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/MultiReceiver.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/OutputConfiguration.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/OutputConfiguration.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/OutputConfiguration.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,44 @@
+package net.sf.japi.midi;
+
+import javax.sound.midi.MidiDevice;
+import org.jetbrains.annotations.NotNull;
+
+/** OutputConfiguration describes a MIDI target, which is the combination of device and channel.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class OutputConfiguration {
+
+    /** The device. */
+    @NotNull private final MidiDevice device;
+
+    /** The channel. */
+    private final int channel;
+
+    /** Creates an OutputConfiguration.
+     * @param device MidiDevice.
+     * @param channel Midi Channel.
+     */
+    public OutputConfiguration(@NotNull final MidiDevice device, final int channel) {
+        this.device = device;
+        this.channel = channel;
+    }
+
+    /** Returns the MidiDevice.
+     * @return The MidiDevice.
+     */
+    @NotNull public MidiDevice getDevice() {
+        return device;
+    }
+
+    /** Returns the Midi Channel.
+     * @return The Midi Channel.
+     */
+    public int getChannel() {
+        return channel;
+    }
+
+    /** {@inheritDoc} */
+    @Override public String toString() {
+        return device.getDeviceInfo().getName() + ": " + channel;
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/OutputConfiguration.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/gui/MidiDeviceListCellRenderer.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/gui/MidiDeviceListCellRenderer.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/gui/MidiDeviceListCellRenderer.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,22 @@
+package net.sf.japi.midi.gui;
+
+import java.awt.Component;
+import javax.sound.midi.MidiDevice;
+import javax.swing.DefaultListCellRenderer;
+import javax.swing.JList;
+
+/** ListCellRenderer for Midi Devices.
+ * Class Description.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class MidiDeviceListCellRenderer extends DefaultListCellRenderer {
+
+    /** {@inheritDoc} */
+    @Override public Component getListCellRendererComponent(final JList list, final Object value, final int index, final boolean isSelected, final boolean cellHasFocus) {
+        final Component c = super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
+        if (value instanceof MidiDevice) {
+            setText(((MidiDevice) value).getDeviceInfo().getName());
+        }
+        return c;
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/gui/MidiDeviceListCellRenderer.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/gui/OutputConfigurator.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/gui/OutputConfigurator.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/gui/OutputConfigurator.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,95 @@
+package net.sf.japi.midi.gui;
+
+import java.awt.BorderLayout;
+import java.awt.Component;
+import java.awt.Container;
+import java.awt.FlowLayout;
+import javax.sound.midi.MidiDevice;
+import javax.sound.midi.MidiUnavailableException;
+import javax.swing.JComponent;
+import javax.swing.JLabel;
+import javax.swing.JList;
+import javax.swing.JOptionPane;
+import javax.swing.JPanel;
+import javax.swing.JScrollPane;
+import javax.swing.JSpinner;
+import javax.swing.SpinnerNumberModel;
+import net.sf.japi.midi.MidiUtils;
+import net.sf.japi.midi.OutputConfiguration;
+import net.sf.japi.swing.ActionBuilder;
+import net.sf.japi.swing.ActionBuilderFactory;
+import org.jetbrains.annotations.Nullable;
+
+/** UI component for configuring a midi output.
+ * The user can choose of one of the receiving devices and select a channel.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class OutputConfigurator extends JComponent {
+
+    private static final ActionBuilder ACTION_BUILDER = ActionBuilderFactory.getInstance().getActionBuilder(OutputConfigurator.class);
+
+    /** The List of Devices from which to choose. */
+    private final JList deviceList;
+
+    /** The Spinner for selecting the channel. */
+    private final JSpinner channelSpinner;
+
+    /** Creates an OutputConfigurator with no initial configuration.
+     * The first device and channel 0 will be selected as defaults.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public OutputConfigurator() throws MidiUnavailableException {
+        setLayout(new BorderLayout());
+        deviceList = new JList(MidiUtils.getAllReceivingDevices());
+        deviceList.setCellRenderer(new MidiDeviceListCellRenderer());
+        deviceList.setSelectedIndex(0);
+        channelSpinner = new JSpinner(new SpinnerNumberModel(0, 0x0, 0xF, 1));
+        //channelSpinner = new JSpinner(new SpinnerChannelModel());
+        add(new JScrollPane(deviceList));
+        final Container spinnerPanel = new JPanel();
+        spinnerPanel.setLayout(new FlowLayout());
+        spinnerPanel.add(new JLabel(ACTION_BUILDER.getString("Channel.label")));
+        spinnerPanel.add(channelSpinner);
+        add(spinnerPanel, BorderLayout.SOUTH);
+    }
+
+    /** Shows a dialog where the user can choose a receiving device and channel once.
+     * @param parent Parent component on which to show the dialog.
+     * @return OutputConfiguration or <code>null</code> if the user chose to abort the dialog.
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    @Nullable public static OutputConfiguration showDialog(@Nullable final Component parent) throws MidiUnavailableException {
+        final OutputConfigurator configurator = new OutputConfigurator();
+        final int result = JOptionPane.showConfirmDialog(parent, configurator, ACTION_BUILDER.getString("Dialog.title"), JOptionPane.OK_CANCEL_OPTION, JOptionPane.QUESTION_MESSAGE);
+        return result == JOptionPane.OK_OPTION ? configurator.getConfiguration() : null;
+    }
+
+    /** Returns the selected configuration.
+     * @return The selected configuration.
+     */
+    public OutputConfiguration getConfiguration() {
+        return new OutputConfiguration(getSelectedDevice(), getSelectedChannel());
+    }
+
+    /** Returns the selected device.
+     * @return The selected device.
+     */
+    public MidiDevice getSelectedDevice() {
+        return (MidiDevice) deviceList.getSelectedValue();
+    }
+
+    /** Returns the selected channel.
+     * @return The selected channel.
+     */
+    public int getSelectedChannel() {
+        return (Integer) channelSpinner.getValue();
+    }
+
+    /** Main program of OutputConfigurator, used for trying the most common use cases.
+     * @param args Command line arguments (ignored).
+     * @throws MidiUnavailableException if one of the requested devices is unavailable due to resource restrictions.
+     */
+    public static void main(final String... args) throws MidiUnavailableException {
+        System.out.println(showDialog(null));
+    }
+}


Property changes on: libs/midi/trunk/src/prj/net/sf/japi/midi/gui/OutputConfigurator.java
___________________________________________________________________
Added: svn:mime-type
   + text/plain
Added: svn:eol-style
   + LF

Added: libs/midi/trunk/src/prj/net/sf/japi/midi/gui/SpinnerChannelModel.java
===================================================================
--- libs/midi/trunk/src/prj/net/sf/japi/midi/gui/SpinnerChannelModel.java	                        (rev 0)
+++ libs/midi/trunk/src/prj/net/sf/japi/midi/gui/SpinnerChannelModel.java	2008-10-07 20:31:57 UTC (rev 686)
@@ -0,0 +1,42 @@
+package net.sf.japi.midi.gui;
+
+import javax.swing.AbstractSpinnerModel;
+
+/** A SpinnerModel for MIDI Channels.
+ * @author <a href="mailto:ch...@ri...">Christian Hujer</a>
+ */
+public class SpinnerChannelModel extends AbstractSpinnerModel {
+
+    /** The current channel. */
+    private int value;
+
+    /** Creates a SpinnerChannelModel which initially selects channel 0. */
+    public SpinnerChannelModel() {
+        value = 0;
+    }
+
+    /** {@inheritDoc} */
+    public Object getValue() {
+        return value;
+    }
+
+    /** {@inheritDoc} */
+    public void setValue(final Object value) {
+        final int newValue = (Integer) value;
+        if (newValue < 0x0 || newValue > 0xF) {
+            throw new IllegalArgumentException("Not a valid MIDI channel.");
+        }
+        this.value = newValue;
+        fireStateChanged();
+    }
+
+    /** {@inheritDoc} */
+    public Object getNextValue() {...
 
[truncated message content]

Thread: [Japi-cvs] SF.net SVN: japi:[686] libs

japi-cvs