javax.sound.midi

Class Sequence

Contents

  • public class Sequence
extends 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

    • Constructor Detail

      • Sequence

        public Sequence(float divisionType,
        int resolution)
         throws InvalidMidiDataException
        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 createTrack() and 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:
        PPQ, SMPTE_24, SMPTE_25, SMPTE_30DROP, SMPTE_30, getDivisionType(), getResolution(), getTracks()

      • Sequence

        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. 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 getTracks() method. Additional tracks may be added, or existing tracks removed, using createTrack() and 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:
        PPQ, SMPTE_24, SMPTE_25, SMPTE_30DROP, SMPTE_30, getDivisionType(), getResolution()

    • Method Detail

      • getResolution

        public int getResolution()
        Obtains the timing resolution for this sequence. If the sequence's division type is PPQ, the resolution is specified in ticks per beat. For SMTPE timing, the resolution is specified in ticks per frame.
        Returns:
        the number of ticks per beat (PPQ) or per frame (SMPTE)
        See Also:
        getDivisionType(), Sequence(float, int), MidiFileFormat.getResolution()

      • createTrack

        public Track createTrack()
        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 getTracks(). Tracks may be removed from the sequence using deleteTrack(javax.sound.midi.Track).
        Returns:
        the newly created track

      • deleteTrack

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

      • getMicrosecondLength

        public long getMicrosecondLength()
        Obtains the duration of this sequence, expressed in microseconds.
        Returns:
        this sequence's duration in microseconds.

      • getTickLength

        public long getTickLength()
        Obtains the duration of this sequence, expressed in MIDI ticks.
        Returns:
        this sequence's length in ticks
        See Also:
        getMicrosecondLength()

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/sound/midi/sequence.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut