Module java.desktop
Package javax.sound.midi
package javax.sound.midi
Provides interfaces and classes for I/O, sequencing, and synthesis of MIDI
(Musical Instrument Digital Interface) data.
Related Documentation
For more information on using Java Sound see: Please note: In thejavax.sound.midi
APIs, a null
reference
parameter to methods is incorrect unless explicitly documented on the method
as having a meaningful interpretation. Usage to the contrary is incorrect
coding and may result in a run time exception either immediately or at some
later time. NullPointerException
is an example of typical and
acceptable run time exception for such cases.- Since:
- 1.3
-
ClassDescriptionThe
ControllerEventListener
interface should be implemented by classes whose instances need to be notified when aSequencer
has processed a requested type of MIDI control-change event.An instrument is a sound-synthesis algorithm with certain parameter settings, usually designed to emulate a specific real-world musical instrument or to achieve a specific sort of sound effect.AnInvalidMidiDataException
indicates that inappropriate MIDI data was encountered.TheMetaEventListener
interface should be implemented by classes whose instances need to be notified when aSequencer
has processed aMetaMessage
.AMetaMessage
is aMidiMessage
that is not meaningful to synthesizers, but that can be stored in a MIDI file and interpreted by a sequencer program.AMidiChannel
object represents a single MIDI channel.MidiDevice
is the base interface for all MIDI devices.AMidiDevice.Info
object contains assorted data about aMidiDevice
, including its name, the company who created it, and descriptive text.MidiDeviceReceiver
is aReceiver
which represents a MIDI input connector of aMidiDevice
(seeMidiDevice.getReceiver()
).MidiDeviceTransmitter
is aTransmitter
which represents a MIDI input connector of aMidiDevice
(seeMidiDevice.getTransmitter()
).MIDI events contain a MIDI message and a corresponding time-stamp expressed in ticks, and can represent the MIDI event information stored in a MIDI file or aSequence
object.AMidiFileFormat
object encapsulates a MIDI file's type, as well as its length and timing information.MidiMessage
is the base class for MIDI messages.TheMidiSystem
class provides access to the installed MIDI system resources, including devices such as synthesizers, sequencers, and MIDI input and output ports.AMidiUnavailableException
is thrown when a requested MIDI component cannot be opened or created because it is unavailable.APatch
object represents a location, on a MIDI synthesizer, into which a single instrument is stored (loaded).AReceiver
receivesMidiEvent
objects and typically does something useful in response, such as interpreting them to generate sound or raw MIDI output.ASequence
is a data structure containing musical information (often an entire song or composition) that can be played back by aSequencer
object.A hardware or software device that plays back a MIDIsequence
is known as a sequencer.ASyncMode
object represents one of the ways in which a MIDI sequencer's notion of time can be synchronized with a master or slave device.AShortMessage
contains a MIDI message that has at most two data bytes following its status byte.ASoundbank
contains a set ofInstruments
that can be loaded into aSynthesizer
.ASoundbankResource
represents any audio resource stored in aSoundbank
.ASynthesizer
generates sound.ASysexMessage
object represents a MIDI system exclusive message.A MIDI track is an independent stream of MIDI events (time-stamped MIDI data) that can be stored along with other tracks in a standard MIDI file.AVoiceStatus
object contains information about the current status of one of the voices produced by aSynthesizer
.