org.rjung.util.launchpad

Class Launchpad

java.lang.Object

org.rjung.util.launchpad.Launchpad

public class Launchpad
extends Object

The Launchpad provides access to a Launchpad via the midi-device. To create an instance provide the device-file as a File or String with the path. As this requires a read-thread, you need to start() the Launchpad after you created it. To get a notication when a button is pressed on the Launchpad you can add a LaunchpadHandler with addHandler(LaunchpadHandler) (see LaunchpadHandler on more information on building a LaunchpadHandler.

Constructor Summary

Constructors

Constructor and Description
Launchpad(File device) The communication with the device uses a character-device.
Launchpad(String device) The communication with the device uses a character-device.

Method Summary

Modifier and Type	Method and Description
void	addHandler(LaunchpadHandler handler) Adds a LaunchpadHandler to the Launchpad instance.
boolean	isAlive() Verify if the asynchronous Thread to read is alive.
boolean	isInterrupted() Verify if the asynchronous Thread to read is interrupted.
void	off(int x, int y) Switch a LED at a coordinates to off.
void	send(MidiCommand command) Send a MidiCommand to the Launchpad.
void	set(int x, int y, Color c) Switch a LED at a coordinates to a Color.
void	start() Start the asynchronous Thread to read events of the Launchpad.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Launchpad

public Launchpad(File device)
          throws FileNotFoundException

The communication with the device uses a character-device. Usually it's one of `/proc/midi*`.

Parameters:

device - File pointing to the blockdevice of a midi controller.

Throws:

FileNotFoundException - This exception is raised, when the device can not be found or accessed

Launchpad

public Launchpad(String device)
          throws FileNotFoundException

The communication with the device uses a character-device. Usually it's one of `/proc/midi*`.

Parameters:

device - String of the path pointing to the blockdevice of a midi controller.

Throws:

FileNotFoundException - This exception is raised, when the device can not be found or accessed

Method Detail

start

public void start()

Start the asynchronous Thread to read events of the Launchpad.

isAlive

public boolean isAlive()

Verify if the asynchronous Thread to read is alive.

Returns:

True, if the asynchronous Thread to read is alive.

isInterrupted

public boolean isInterrupted()

Verify if the asynchronous Thread to read is interrupted.

Returns:

True, if the asynchronous Thread to read is interrupted.

addHandler

public void addHandler(LaunchpadHandler handler)

Adds a LaunchpadHandler to the Launchpad instance. The LaunchpadHandler is now notified whenever a event is sent from the Launchpad.

Parameters:

handler - The LaunchpadHandler to be informed of events from the Launchpad.

send

public void send(MidiCommand command)
          throws IOException

Send a MidiCommand to the Launchpad.

Parameters:

command - The MidiCommand to be sent to the Launchpad.

Throws:

IOException - Information on why a MidiCommand could not be sent.

off

public void off(int x,
                int y)
         throws IOException

Switch a LED at a coordinates to off.

Parameters:

x - The x-coordinate of the LED to be switched off (0-16).

y - The y-coordinate of the LED to be switched off (0-16).

Throws:

IOException - Information on why a MidiCommand could not be sent.

set

public void set(int x,
                int y,
                Color c)
         throws IOException

Switch a LED at a coordinates to a Color.

Parameters:

x - The x-coordinate of the LED to be switched off (0-16).

y - The y-coordinate of the LED to be switched off (0-16).

Throws:

IOException - Information on why a MidiCommand could not be sent.