jp.kshoji.javax.sound.midi

Class MidiSystem

java.lang.Object

jp.kshoji.javax.sound.midi.MidiSystem

public final class MidiSystem
extends Object

MidiSystem porting for Android

Author:

K.Shoji

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MidiSystem.MidiSystemUtils Utilities for MidiSystem

Method Summary

Modifier and Type	Method and Description
static void	addMidiDevice(MidiDevice midiDevice) Add a MidiDevice to the MidiSystem
static void	addSynthesizer(Synthesizer synthesizer) Add a Synthesizer to the MidiSystem
static MidiDevice	getMidiDevice(MidiDevice.Info info) Get MidiDevice by device information
static MidiDevice.Info[]	getMidiDeviceInfo() Get all connected MidiDevice.Info as array
static MidiFileFormat	getMidiFileFormat(File file) Get the MidiFileFormat information of the specified File.
static MidiFileFormat	getMidiFileFormat(InputStream stream) Get the MidiFileFormat information in the specified input stream.
static MidiFileFormat	getMidiFileFormat(URL url) Get the MidiFileFormat information in the specified URL.
static int[]	getMidiFileTypes() Get the set of SMF types that the library can write
static int[]	getMidiFileTypes(Sequence sequence) Get the set of SMF types that the library can write from the Sequence
static Receiver	getReceiver() Get the first detected Receiver
static Sequence	getSequence(File file) Get a Sequence from the specified File.
static Sequence	getSequence(InputStream stream) Get a Sequence from the specified input stream.
static Sequence	getSequence(URL url) Get a Sequence from the specified URL.
static Sequencer	getSequencer() Get the default Sequencer, connected to a default device.
static Sequencer	getSequencer(boolean connected) Get the default Sequencer, optionally connected to a default device.
static Soundbank	getSoundbank(File file) Obtain Soundbank from File not implemented.
static Soundbank	getSoundbank(InputStream stream) Obtain Soundbank from InputStream not implemented.
static Soundbank	getSoundbank(URL url) Obtain Soundbank from URL not implemented.
static Synthesizer	getSynthesizer() Obtain Synthesizer registered by registerSynthesizer(Synthesizer)
static Transmitter	getTransmitter() Get the first detected Transmitter
static boolean	isFileTypeSupported(int fileType) Check if the specified SMF fileType is available
static boolean	isFileTypeSupported(int fileType, Sequence sequence) Check if the specified SMF fileType is available from the Sequence
static void	registerSynthesizer(Synthesizer synthesizer) Register the Synthesizer instance to the MidiSystem.
static void	removeMidiDevice(MidiDevice midiDevice) Remove a MidiDevice from the MidiSystem
static void	removeSynthesizer(Synthesizer synthesizer) Remove a Synthesizer from the MidiSystem
static int	write(Sequence sequence, int fileType, File file) Write sequence to the specified File as SMF
static int	write(Sequence sequence, int fileType, OutputStream outputStream) Write sequence to the specified OutputStream as SMF

Methods inherited from class java.lang.Object

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

Method Detail

addMidiDevice

public static void addMidiDevice(@NonNull
                                 MidiDevice midiDevice)

Add a MidiDevice to the MidiSystem

Parameters:

midiDevice - the device to add

removeMidiDevice

public static void removeMidiDevice(@NonNull
                                    MidiDevice midiDevice)

Remove a MidiDevice from the MidiSystem

Parameters:

midiDevice - the device to remove

addSynthesizer

public static void addSynthesizer(@NonNull
                                  Synthesizer synthesizer)

Add a Synthesizer to the MidiSystem

Parameters:

synthesizer - the device to add

removeSynthesizer

public static void removeSynthesizer(@NonNull
                                     Synthesizer synthesizer)

Remove a Synthesizer from the MidiSystem

Parameters:

synthesizer - the device to remove

getMidiDeviceInfo

@NonNull
public static MidiDevice.Info[] getMidiDeviceInfo()

Get all connected MidiDevice.Info as array

Returns:

device information

getMidiDevice

@NonNull
public static MidiDevice getMidiDevice(@NonNull
                                                 MidiDevice.Info info)
                                          throws MidiUnavailableException,
                                                 IllegalArgumentException

Get MidiDevice by device information

Parameters:

info - the device information

Returns:

MidiDevice

Throws:

MidiUnavailableException

IllegalArgumentException - if the device not found.

getReceiver

@Nullable
public static Receiver getReceiver()
                                       throws MidiUnavailableException

Get the first detected Receiver

Returns:

Receiver

Throws:

MidiUnavailableException

getTransmitter

@Nullable
public static Transmitter getTransmitter()
                                             throws MidiUnavailableException

Get the first detected Transmitter

Returns:

Transmitter

Throws:

MidiUnavailableException

getSequence

@NonNull
public static Sequence getSequence(@NonNull
                                             File file)
                                      throws InvalidMidiDataException,
                                             IOException

Get a Sequence from the specified File.

Parameters:

file - the SMF

Returns:

the Sequence

Throws:

InvalidMidiDataException

IOException

getSequence

@NonNull
public static Sequence getSequence(@NonNull
                                             InputStream stream)
                                      throws InvalidMidiDataException,
                                             IOException

Get a Sequence from the specified input stream.

Parameters:

stream - the input stream of SMF

Returns:

the Sequence

Throws:

InvalidMidiDataException

IOException

getSequence

@NonNull
public static Sequence getSequence(@NonNull
                                             URL url)
                                      throws InvalidMidiDataException,
                                             IOException

Get a Sequence from the specified URL.

Parameters:

url - the URL of SMF

Returns:

the Sequence

Throws:

InvalidMidiDataException

IOException

getSequencer

@NonNull
public static Sequencer getSequencer()
                                        throws MidiUnavailableException

Get the default Sequencer, connected to a default device.

Returns:

Sequencer must call the MidiDevice.open() method.

Throws:

MidiUnavailableException

getSequencer

@NonNull
public static Sequencer getSequencer(boolean connected)
                                        throws MidiUnavailableException

Get the default Sequencer, optionally connected to a default device.

Parameters:

connected - ignored

Returns:

Sequencer must call the MidiDevice.open() method.

Throws:

MidiUnavailableException

getSoundbank

@NonNull
public static Soundbank getSoundbank(@NonNull
                                               File file)
                                        throws InvalidMidiDataException,
                                               IOException

Obtain Soundbank from File
not implemented.

Parameters:

file - the Soundbank file

Returns:

Soundbank

Throws:

InvalidMidiDataException

IOException

getSoundbank

@NonNull
public static Soundbank getSoundbank(@NonNull
                                               InputStream stream)
                                        throws InvalidMidiDataException,
                                               IOException

Obtain Soundbank from InputStream
not implemented.

Parameters:

stream - the input stream of Soundbank

Returns:

Soundbank

Throws:

InvalidMidiDataException

IOException

getSoundbank

@NonNull
public static Soundbank getSoundbank(@NonNull
                                               URL url)
                                        throws InvalidMidiDataException,
                                               IOException

Obtain Soundbank from URL
not implemented.

Parameters:

url - the URL of Soundbank

Returns:

Soundbank

Throws:

InvalidMidiDataException

IOException

getSynthesizer

@Nullable
public static Synthesizer getSynthesizer()
                                             throws MidiUnavailableException

Obtain Synthesizer registered by registerSynthesizer(Synthesizer)

Returns:

a Synthesizer, null if instance has not registered

Throws:

MidiUnavailableException

registerSynthesizer

public static void registerSynthesizer(@NonNull
                                       Synthesizer synthesizer)

Register the Synthesizer instance to the MidiSystem.

Parameters:

synthesizer - the Synthesizer instance

getMidiFileFormat

@NonNull
public static MidiFileFormat getMidiFileFormat(@NonNull
                                                         File file)
                                                  throws InvalidMidiDataException,
                                                         IOException

Get the MidiFileFormat information of the specified File.

Parameters:

file - the SMF

Returns:

the MidiFileFormat information

Throws:

InvalidMidiDataException

IOException

getMidiFileFormat

@NonNull
public static MidiFileFormat getMidiFileFormat(@NonNull
                                                         InputStream stream)
                                                  throws InvalidMidiDataException,
                                                         IOException

Get the MidiFileFormat information in the specified input stream.

Parameters:

stream - the the input stream of SMF

Returns:

the MidiFileFormat information

Throws:

InvalidMidiDataException

IOException

getMidiFileFormat

@NonNull
public static MidiFileFormat getMidiFileFormat(@NonNull
                                                         URL url)
                                                  throws InvalidMidiDataException,
                                                         IOException

Get the MidiFileFormat information in the specified URL.

Parameters:

url - the URL of SMF

Returns:

the MidiFileFormat information

Throws:

InvalidMidiDataException

IOException

getMidiFileTypes

@NonNull
public static int[] getMidiFileTypes()

Get the set of SMF types that the library can write

Returns:

the set of SMF types

getMidiFileTypes

@NonNull
public static int[] getMidiFileTypes(@NonNull
                                               Sequence sequence)

Get the set of SMF types that the library can write from the Sequence

Parameters:

sequence - the Sequence

Returns:

the set of SMF types

isFileTypeSupported

public static boolean isFileTypeSupported(int fileType)

Check if the specified SMF fileType is available

Parameters:

fileType - the fileType of SMF

Returns:

true if the fileType is available

isFileTypeSupported

public static boolean isFileTypeSupported(int fileType,
                                          @NonNull
                                          Sequence sequence)

Check if the specified SMF fileType is available from the Sequence

Parameters:

fileType - the fileType of Sequence

sequence - the Sequence

Returns:

true if the fileType is available

write

public static int write(@NonNull
                        Sequence sequence,
                        int fileType,
                        @NonNull
                        File file)
                 throws IOException

Write sequence to the specified File as SMF

Parameters:

sequence - the Sequence

fileType - the fileType of Sequence

file - the File to write

Returns:

the file length

Throws:

IOException

write

public static int write(@NonNull
                        Sequence sequence,
                        int fileType,
                        @NonNull
                        OutputStream outputStream)
                 throws IOException

Write sequence to the specified OutputStream as SMF

Parameters:

sequence - the Sequence

fileType - the fileType of Sequence

outputStream - the OutputStream to write

Returns:

the file length

Throws:

IOException