Sequence JDK 1.6)

Description

public class Sequence

A Sequence is a data structure containing musical information (often an entire song or composition) that can be played back by a Sequencer object.

A Sequence is a data structure containing musical information (often an entire song or composition) that can be played back by a Sequencer object. Specifically, the Sequence contains timing information and one or more tracks. Each track consists of a series of MIDI events (such as note-ons, note-offs, program changes, and meta-events). The sequence's timing information specifies the type of unit that is used to time-stamp the events in the sequence.

A Sequence can be created from a MIDI file by reading the file into an input stream and invoking one of the getSequence methods of MidiSystem. A sequence can also be built from scratch by adding new Tracks to an empty Sequence, and adding MidiEvent objects to these Tracks.

See also: Sequencer.setSequence(java.io.InputStream stream) Sequencer.setSequence(Sequence sequence) Track.add(MidiEvent) MidiFileFormat

Constructors

public Sequence (float divisionType, int resolution) throws InvalidMidiDataException

Constructs a new MIDI sequence with the specified timing division type and timing resolution.

Constructs a new MIDI sequence with the specified timing division
type and timing resolution. The division type must be one of the
recognized MIDI timing types. For tempo-based timing,
divisionType is PPQ (pulses per quarter note) and
the resolution is specified in ticks per beat. For SMTPE timing,
divisionType specifies the number of frames per
second and the resolution is specified in ticks per frame.
The sequence will contain no initial tracks. Tracks may be
added to or removed from the sequence using Sequence.createTrack()
and Sequence.deleteTrack(javax.sound.midi.Track).
Parameters:
- divisionType - the timing division type (PPQ or one of the SMPTE types)
- resolution - the timing resolution
Throws:
- InvalidMidiDataException - if divisionType is not valid
See Also: Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30, Sequence.getDivisionType(), Sequence.getResolution(), Sequence.getTracks(),

public Sequence (float divisionType, int resolution, int numTracks) throws InvalidMidiDataException

Constructs a new MIDI sequence with the specified timing division type, timing resolution, and number of tracks.

Constructs a new MIDI sequence with the specified timing division
type, timing resolution, and number of tracks. The division type must be one of the
recognized MIDI timing types. For tempo-based timing,
divisionType is PPQ (pulses per quarter note) and
the resolution is specified in ticks per beat. For SMTPE timing,
divisionType specifies the number of frames per
second and the resolution is specified in ticks per frame.
The sequence will be initialized with the number of tracks specified by
numTracks. These tracks are initially empty (i.e.
they contain only the meta-event End of Track).
The tracks may be retrieved for editing using the Sequence.getTracks()
method. Additional tracks may be added, or existing tracks removed,
using Sequence.createTrack() and Sequence.deleteTrack(javax.sound.midi.Track).
Parameters:
- divisionType - the timing division type (PPQ or one of the SMPTE types)
- resolution - the timing resolution
- numTracks - the initial number of tracks in the sequence.
Throws:
- InvalidMidiDataException - if divisionType is not valid
See Also: Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30, Sequence.getDivisionType(), Sequence.getResolution(),

Methods

Hide/Show inherited methods

public Track createTrack ()

Creates a new, initially empty track as part of this sequence.

Creates a new, initially empty track as part of this sequence.
The track initially contains the meta-event End of Track.
The newly created track is returned. All tracks in the sequence
may be retrieved using Sequence.getTracks(). Tracks may be
removed from the sequence using Sequence.deleteTrack(javax.sound.midi.Track).
Returns: the newly created track

public boolean deleteTrack (Track track)

Removes the specified track from the sequence.

Removes the specified track from the sequence.
Returns: true if the track existed in the track and was removed, otherwise false.
Parameters:
- track - the track to remove
See Also: Sequence.createTrack(), Sequence.getTracks(),

public float getDivisionType ()

Obtains the timing division type for this sequence.

public long getMicrosecondLength ()

Obtains the duration of this sequence, expressed in microseconds.

public Patch getPatchList ()

Obtains a list of patches referenced in this sequence.

Obtains a list of patches referenced in this sequence.
This patch list may be used to load the required
Instrument objects
into a Synthesizer.
Returns: an array of {@link Patch} objects used in this sequence
See Also: Synthesizer.loadInstruments(Soundbank, Patch[]),

public int getResolution ()

Obtains the timing resolution for this sequence.

public long getTickLength ()

Obtains the duration of this sequence, expressed in MIDI ticks.

public Track getTracks ()

Obtains an array containing all the tracks in this sequence.

Fields

Hide/Show inherited fields

protected float divisionType

The timing division type of the sequence.

publicfinalstatic float PPQ = "0.0"

The tempo-based timing type, for which the resolution is expressed in pulses (ticks) per quarter note.

protected int resolution

The timing resolution of the sequence.

publicfinalstatic float SMPTE_24 = "24.0"

The SMPTE-based timing type with 24 frames per second (resolution is expressed in ticks per frame).

publicfinalstatic float SMPTE_25 = "25.0"

The SMPTE-based timing type with 25 frames per second (resolution is expressed in ticks per frame).

publicfinalstatic float SMPTE_30 = "30.0"

The SMPTE-based timing type with 30 frames per second (resolution is expressed in ticks per frame).

publicfinalstatic float SMPTE_30DROP = "29.97"

The SMPTE-based timing type with 29.97 frames per second (resolution is expressed in ticks per frame).

protected Vector<Track> tracks

The MIDI tracks in this sequence.