diff options
Diffstat (limited to 'libjava/classpath/javax/sound/midi/Sequence.java')
-rw-r--r-- | libjava/classpath/javax/sound/midi/Sequence.java | 80 |
1 files changed, 40 insertions, 40 deletions
diff --git a/libjava/classpath/javax/sound/midi/Sequence.java b/libjava/classpath/javax/sound/midi/Sequence.java index 2ea201cb2a4..833150afe80 100644 --- a/libjava/classpath/javax/sound/midi/Sequence.java +++ b/libjava/classpath/javax/sound/midi/Sequence.java @@ -42,9 +42,9 @@ import java.util.Iterator; import java.util.Vector; /** - * Objects of this type represent sequences of MIDI messages that can be + * Objects of this type represent sequences of MIDI messages that can be * played back by a Sequencer. - * + * * @author Anthony Green (green@redhat.com) * @since 1.3 * @@ -52,69 +52,69 @@ import java.util.Vector; public class Sequence { /** - * The timing division type for this sequence (PPQ or SMPTE*) + * The timing division type for this sequence (PPQ or SMPTE*) */ protected float divisionType; - + /** - * The timing resolution in ticks/beat or ticks/frame, depending on the - * division type. + * The timing resolution in ticks/beat or ticks/frame, depending on the + * division type. */ protected int resolution; - + /** - * The MIDI tracks used by this sequence. + * The MIDI tracks used by this sequence. */ protected Vector<Track> tracks; - + /** * Tempo-based timing. Resolution is specified in ticks per beat. */ public static final float PPQ = 0.0f; - + /** * 24 frames/second timing. Resolution is specific in ticks per frame. */ public static final float SMPTE_24 = 24.0f; - + /** * 25 frames/second timing. Resolution is specific in ticks per frame. */ public static final float SMPTE_25 = 25.0f; - + /** * 30 frames/second timing. Resolution is specific in ticks per frame. */ public static final float SMPTE_30 = 30.0f; - + /** * 29.97 frames/second timing. Resolution is specific in ticks per frame. */ public static final float SMPTE_30DROP = 29.97f; - + // Private helper class private void init(float divisionType, int resolution, int numTracks) throws InvalidMidiDataException { if (divisionType != PPQ - && divisionType != SMPTE_24 + && divisionType != SMPTE_24 && divisionType != SMPTE_25 && divisionType != SMPTE_30 && divisionType != SMPTE_30DROP) - throw new InvalidMidiDataException("Invalid division type (" + throw new InvalidMidiDataException("Invalid division type (" + divisionType + ")"); this.divisionType = divisionType; this.resolution = resolution; - + tracks = new Vector<Track>(numTracks); while (numTracks > 0) tracks.set(--numTracks, new Track()); } - + /** * Create a MIDI sequence object with no initial tracks. - * + * * @param divisionType the division type (must be one of PPQ or SMPTE_*) * @param resolution the timing resolution * @throws InvalidMidiDataException if the division type is invalid @@ -127,7 +127,7 @@ public class Sequence /** * Create a MIDI seqence object. - * + * * @param divisionType the division type (must be one of PPQ or SMPTE_*) * @param resolution the timing resolution * @param numTracks the number of initial tracks @@ -138,30 +138,30 @@ public class Sequence { init(divisionType, resolution, 0); } - + /** * The division type of this sequence. - * + * * @return division type of this sequence */ public float getDivisionType() { return divisionType; } - + /** * The timing resolution for this sequence, relative to the division type. - * + * * @return the timing resolution for this sequence */ public int getResolution() { return resolution; } - + /** * Create a new empty MIDI track and add it to this sequence. - * + * * @return the newly create MIDI track */ public Track createTrack() @@ -170,10 +170,10 @@ public class Sequence tracks.add(track); return track; } - + /** * Remove the specified MIDI track from this sequence. - * + * * @param track the track to remove * @return true if track was removed and false othewise */ @@ -181,33 +181,33 @@ public class Sequence { return tracks.remove(track); } - + /** * Get an array of MIDI tracks used in this sequence. - * + * * @return a possibly empty array of tracks */ public Track[] getTracks() { return tracks.toArray(new Track[tracks.size()]); } - + /** * The length of this sequence in microseconds. - * + * * @return the length of this sequence in microseconds */ public long getMicrosecondLength() { long tickLength = getTickLength(); - + if (divisionType == PPQ) { // FIXME // How can this possible be computed? PPQ is pulses per quarter-note, // which is dependent on the tempo of the Sequencer. - throw new - UnsupportedOperationException("Can't compute PPQ based lengths yet"); + throw new + UnsupportedOperationException("Can't compute PPQ based lengths yet"); } else { @@ -215,10 +215,10 @@ public class Sequence return (long) ((tickLength * 1000000) / (divisionType * resolution)); } } - + /** * The length of this sequence in MIDI ticks. - * + * * @return the length of this sequence in MIDI ticks */ public long getTickLength() @@ -234,15 +234,15 @@ public class Sequence } return length; } - + /** * Get an array of patches used in this sequence. - * + * * @return an array of patches used in this sequence */ public Patch[] getPatchList() { - // FIXE: not quite sure how to do this yet. + // FIXE: not quite sure how to do this yet. throw new UnsupportedOperationException("Can't get patch list yet"); } } |