javax.sound.midi

クラスMidiMessage

java.lang.Object

javax.sound.midi.MidiMessage

すべての実装されたインタフェース:

Cloneable

直系の既知のサブクラス:

MetaMessage、ShortMessage、SysexMessage

public abstract class MidiMessage
extends Object
implements Cloneable

MidiMessageはMIDIメッセージの基底クラスです。MidiMessageは、シンセサイザが応答できる標準のMIDIメッセージだけでなく、シーケンサ・プログラムが使用できる「メタイベント」も含みます。また、歌詞、著作権、テンポ指示、拍子記号および調記号、マーカーなどの情報のメタイベントがあります。詳細については、MIDI Manufacturer's Association (http://www.midi.org)発行の『Complete MIDI 1.0 Detailed Specification』に収められている「Standard MIDI Files 1.0」の仕様を参照してください。

基底MidiMessageクラスは、MIDIメッセージに関する3種類の情報へのアクセスを提供します。

• メッセージのステータス・バイト
• バイト表示によるメッセージの全長(ステータス・バイトとデータ・バイト)
• まとまったメッセージを含むバイト配列

MidiMessageは取得のメソッドを含みますが、これらの値は設定しません。これらの値の設定はサブクラスにより行われます。

MIDI標準ではMIDIデータをバイトで表現します。しかし、Java^TMは符号付きバイトを使用しているため、Java Sound APIは、MIDIデータを表現する際にバイトではなく整数型を使用します。たとえば、MidiMessageのgetStatus()メソッドはMIDIステータス・バイトを整数型として返します。Java Soundの外部で符号付きバイトとしてエンコードされたMIDIデータを処理する場合は、次の変換式を使ってバイトを整数型に変換できます。

int i = (int)(byte & 0xFF)

単に既知のMIDIバイト値をメソッド・パラメータとして渡す必要があるだけの場合は、10進表記法または16進表記法を使用して、そのMIDIバイト値を整数型として直接表すことができます。たとえば、「アクティブ・センシング」ステータス・バイトを最初の引数としてShortMessageのsetMessage(int)メソッドに渡す場合は、このステータス・バイトを254または0xFEとして表すことができます。

関連項目:

Track、Sequence、Receiver

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected byte[]	data MIDIメッセージ・データです。
protected int	length MIDIメッセージのバイト数で、ステータス・バイトとデータ・バイトを含みます。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	MidiMessage(byte[] data) 新しいMidiMessageを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
abstract Object	clone() このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
int	getLength() MIDIメッセージの全長をバイトで取得します。
byte[]	getMessage() MIDIメッセージ・データを取得します。
int	getStatus() MIDIメッセージのステータス・バイトを取得します。
protected void	setMessage(byte[] data, int length) MIDIメッセージのデータを設定します。

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

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

フィールドの詳細

data

protected byte[] data

MIDIメッセージ・データです。最初のバイトはメッセージのステータス・バイトです。メッセージの長さまでの後続のバイトが、このメッセージのデータ・バイトです。

関連項目:

getLength()

length

protected int length

MIDIメッセージのバイト数で、ステータス・バイトとデータ・バイトを含みます。

関連項目:

getLength()

コンストラクタの詳細

MidiMessage

protected MidiMessage(byte[] data)

新しいMidiMessageを構築します。このprotectedコンストラクタは具象サブクラスによって呼び出され、その具象サブクラスでは有効なMIDIメッセージ全体をデータ配列に指定します。

パラメータ:

data - 詳細なメッセージを含むバイトの配列。メッセージ・データはsetMessageメソッドを使って変更できる。

関連項目:

setMessage(byte[], int)

メソッドの詳細

setMessage

protected void setMessage(byte[] data,
                          int length)
                   throws InvalidMidiDataException

MIDIメッセージのデータを設定します。このprotectedメソッドは具象サブクラスによって呼び出され、その具象サブクラスでは有効なMIDIメッセージ全体をデータ配列に指定します。

パラメータ:

data - MIDIメッセージのデータ・バイト

length - dataバイト配列のバイト数

例外:

InvalidMidiDataException - パラメータ値が有効なMIDIメタ・メッセージを指定していない場合

getMessage

public byte[] getMessage()

MIDIメッセージ・データを取得します。返されるバイト配列の最初のバイトはメッセージのステータス・バイトです。メッセージの長さまでの後続のバイトが、データ・バイトです。バイト配列の長さは実際のメッセージより長くなる場合があります。バイト単位でのメッセージの全長は、getLength()メソッドによって報告されます。

戻り値:

まとまったMidiMessageデータを含むバイト配列

getStatus

public int getStatus()

MIDIメッセージのステータス・バイトを取得します。ステータス「バイト」は整数型として表されます。MidiMessageクラスの説明を参照してください。

戻り値:

このイベントのステータス・バイトの整数型表示

getLength

public int getLength()

MIDIメッセージの全長をバイトで取得します。MIDIメッセージは1つのステータス・バイトとゼロまたはそれ以上のデータ・バイトで構成されます。戻り値は、システム・リアルタイム・メッセージを示す1、チャネル・メッセージを示す2または3、メタ・メッセージおよびシステム・エクスクルーシブ・メッセージを示すその他の値になります。

戻り値:

バイト表示によるメッセージの長さ

clone

public abstract Object clone()

このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。

オーバーライド:

clone、クラス: Object

戻り値:

このインスタンスの複製。

関連項目:

Cloneable