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
ControllerEventListenerinterface should be implemented by classes whose instances need to be notified when aSequencerhas 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.AnInvalidMidiDataExceptionindicates that inappropriate MIDI data was encountered.TheMetaEventListenerinterface should be implemented by classes whose instances need to be notified when aSequencerhas processed aMetaMessage.AMetaMessageis aMidiMessagethat is not meaningful to synthesizers, but that can be stored in a MIDI file and interpreted by a sequencer program.AMidiChannelobject represents a single MIDI channel.MidiDeviceis the base interface for all MIDI devices.AMidiDevice.Infoobject contains assorted data about aMidiDevice, including its name, the company who created it, and descriptive text.MidiDeviceReceiveris aReceiverwhich represents a MIDI input connector of aMidiDevice(seeMidiDevice.getReceiver()).MidiDeviceTransmitteris aTransmitterwhich 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 aSequenceobject.AMidiFileFormatobject encapsulates a MIDI file's type, as well as its length and timing information.MidiMessageis the base class for MIDI messages.TheMidiSystemclass provides access to the installed MIDI system resources, including devices such as synthesizers, sequencers, and MIDI input and output ports.AMidiUnavailableExceptionis thrown when a requested MIDI component cannot be opened or created because it is unavailable.APatchobject represents a location, on a MIDI synthesizer, into which a single instrument is stored (loaded).AReceiverreceivesMidiEventobjects and typically does something useful in response, such as interpreting them to generate sound or raw MIDI output.ASequenceis a data structure containing musical information (often an entire song or composition) that can be played back by aSequencerobject.A hardware or software device that plays back a MIDIsequenceis known as a sequencer.ASyncModeobject represents one of the ways in which a MIDI sequencer's notion of time can be synchronized with a master or slave device.AShortMessagecontains a MIDI message that has at most two data bytes following its status byte.ASoundbankcontains a set ofInstrumentsthat can be loaded into aSynthesizer.ASoundbankResourcerepresents any audio resource stored in aSoundbank.ASynthesizergenerates sound.ASysexMessageobject 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.AVoiceStatusobject contains information about the current status of one of the voices produced by aSynthesizer.