javax.sound.midi

クラスTrack

java.lang.Object

javax.sound.midi.Track

public class Track
extends Object

MIDIトラックは、標準のMIDIファイルにほかのトラックとともに保存できる、MIDIイベント(タイムスタンプの付いたMIDIデータ)の独立したストリームです。MIDIの仕様で許容されるMIDIデータは16チャネルだけですが、トラックを使用することでこの制限を回避できます。1つのMIDIファイルには、16チャネルまでのMIDIデータの独自のストリームを含んだトラックを任意の数だけ格納できます。

Trackは、Sequencerで演奏されるデータの階層で中間の位置を占めます。つまり、シーケンサが演奏するシーケンスにはトラックが含まれ、トラックにはMIDIイベントが含まれています。シーケンサには、個々のトラックをミュートまたはソロにするコントロールが用意されている場合があります。

トラックのタイミング情報や解像度は、そのトラックを格納しているシーケンスによって制御および保存されます。特定のTrackは、そのタイミングを維持している特定のSequenceに属するものと見なされます。そのため、新しい(空の)トラックを作成するには、Trackコンストラクタを直接呼び出すのではなく、Sequence.createTrack()メソッドを呼び出します。

Trackクラスでは、MidiEventオブジェクトを追加または削除することでトラックを編集するメソッドが提供されます。これらの操作を行なっても、イベント・リストの時間順は正しく保たれます。また、トラックのサイズをそのトラックに含まれるイベント数、またはティック単位でのデュレーションで取得するメソッドも含まれています。

関連項目:

Sequencer.setTrackMute(int, boolean), Sequencer.setTrackSolo(int, boolean)

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	add(MidiEvent event) トラックに新しいイベントを追加します。
MidiEvent	get(int index) 指定したインデックスのイベントを取得します。
boolean	remove(MidiEvent event) 指定したイベントをトラックから削除します。
int	size() このトラックに含まれるイベントの数を取得します。
long	ticks() トラックの長さをMIDIティック単位で取得します。

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

add

public boolean add(MidiEvent event)

トラックに新しいイベントを追加します。ただし、そのイベントがすでにそのトラックに含まれている場合は、ふたたび追加することはできません。イベントのリストは時間順に維持されるため、イベントはリストの必ずしも最後ではなく、適切な場所に挿入されます。

パラメータ:

event - 追加するイベント

戻り値:

そのイベントがそのトラックに含まれておらず、かつ追加された場合はtrue、そうでない場合はfalse

remove

public boolean remove(MidiEvent event)

指定したイベントをトラックから削除します。

パラメータ:

event - 削除するイベント

戻り値:

そのイベントがそのトラックに存在し、かつ削除された場合はtrue、そうでない場合はfalse

get

public MidiEvent get(int index)
              throws ArrayIndexOutOfBoundsException

指定したインデックスのイベントを取得します。

パラメータ:

index - 取得するイベントのイベント・ベクターによる位置

戻り値:

指定したインデックスのイベント

例外:

ArrayIndexOutOfBoundsException - 指定したインデックスが負、またはこのトラックの現在のサイズ以上である場合。

関連項目:

size()

size

public int size()

このトラックに含まれるイベントの数を取得します。

戻り値:

このトラックのイベント・ベクターのサイズ

ticks

public long ticks()

トラックの長さをMIDIティック単位で取得します。(1ティックの秒単位でのデュレーションは、このトラックを格納しているSequenceのタイミング解像度と、シーケンサで設定した音楽のテンポによって決まります)。

戻り値:

ティック単位でのデュレーション

関連項目:

Sequence.Sequence(float, int), Sequencer.setTempoInBPM(float), Sequencer.getTickPosition()