モジュール java.desktop

パッケージ javax.sound.midi

クラスMetaMessage

java.lang.Object

javax.sound.midi.MidiMessage

javax.sound.midi.MetaMessage

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

Cloneable

public class MetaMessage extends MidiMessage

MetaMessageは、シンセサイザには意味がないMidiMessageですが、MIDIファイルに格納してシーケンサ・プログラムによって解釈できます。 (MidiMessageクラスの説明を参照。) 標準MIDIファイルの仕様によってシーケンス番号、歌詞、演奏指示点、テンポの設定など、様々なタイプのメタイベントが定義されています。 また、歌詞、著作権、テンポ指示、拍子記号および調記号、マーカーなどの情報のメタイベントもあります。詳細については、MIDI Manufacturer's Association (http://www.midi.org)発行の『Complete MIDI 1.0 Detailed Specification』に収められている「Standard MIDI Files 1.0」の仕様を参照してください。

MIDIワイヤー・プロトコルを使用してデータを転送する場合、ステータス値が0xFFのShortMessageは、システム・リセット・メッセージを表します。 MIDIファイルでは、この同じ状態値がMetaMessageを表します。 メタ・メッセージの型は、ステータス・バイト0xFFに続く最初のバイトによってそれぞれ区別されます。 後続のバイトはデータ・バイトです。 システム・エクスクルーシブ・メッセージの場合と同様に、MetaMessageの型によってデータ・バイト数は異なります。

関連項目:

• MetaEventListener

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	META	MetaMessage (0xFFつまり255)のステータス・バイトは、MIDIファイルで使用されます。

クラスjavax.sound.midi.MidiMessageで宣言されたフィールド

data, length

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

コンストラクタ

修飾子	コンストラクタ	説明
	MetaMessage()	新しいMetaMessageを構築します。
protected	MetaMessage(byte[] data)	新しいMetaMessageを構築します。
	MetaMessage(int type, byte[] data, int length)	MetaMessageを新しく構築し、メッセージ・パラメータを設定します。

メソッドのサマリー

修飾子と型	メソッド	説明
Object	clone()	このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
byte[]	getData()	メタ・メッセージのデータのコピーを取得します。
int	getType()	MetaMessageの型を取得します。
void	setMessage(int type, byte[] data, int length)	MetaMessageのメッセージ・パラメータを設定します。

クラスjavax.sound.midi.MidiMessageで宣言されたメソッド

getLength, getMessage, getStatus, setMessage

クラスjava.lang.Objectで宣言されたメソッド

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

フィールド詳細

META

public static final int META

MetaMessage (0xFFつまり255)のステータス・バイトは、MIDIファイルで使用されます。 これは、リアルタイムの"MIDIワイヤー"プロトコルで使用されるShortMessage.SYSTEM_RESETと同じ値を持ちます。

関連項目:

• MidiMessage.getStatus()
• 定数フィールド値

コンストラクタの詳細

MetaMessage

public MetaMessage()

新しいMetaMessageを構築します。 メッセージの内容はここでは設定されません。続いてsetMessageを使用してメッセージの内容を設定します。

MetaMessage

public MetaMessage(int type, byte[] data, int length) throws InvalidMidiDataException

MetaMessageを新しく構築し、メッセージ・パラメータを設定します。 メッセージの内容は、setMessageメソッドを使用して変更できます。

パラメータ:

type - メタ・メッセージの型(128未満のこと)

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

length - dataバイト配列のバイト容量。負の値を指定することはできず、data.length以下

例外:

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

導入されたバージョン:

1.7

関連項目:

• setMessage(int, byte[], int)
• getType()
• getData()

MetaMessage

protected MetaMessage(byte[] data)

新しいMetaMessageを構築します。

パラメータ:

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

関連項目:

• setMessage(int, byte[], int)

メソッドの詳細

setMessage

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

MetaMessageのメッセージ・パラメータを設定します。 メタ・メッセージには唯一0xFFというステータス・バイト値だけが可能なので、ここで指定する必要はありません。 getStatusをコールすると、すべてのメタ・メッセージに対して0xFFが返されます。

MetaMessageでは、type引数がステータス・バイトに続くバイトの有効値となります。 data引数はMetaMessageのすべての後続バイトを含みます。 言い換えると、MetaMessageの型を指定するバイトはデータ・バイトとは見なされません。

パラメータ:

type - メタ・メッセージの型(128未満のこと)

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

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

例外:

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

getType

public int getType()

MetaMessageの型を取得します。

戻り値:

MetaMessageの型を示す整数型

getData

public byte[] getData()

メタ・メッセージのデータのコピーを取得します。 バイトの戻り配列には、ステータス・バイトまたはメッセージ長データは含まれません。 メタ・メッセージのデータの長さが配列の長さです。 メッセージ全体の長さはステータス・バイトおよびメタ・メッセージ型バイトを含むため、戻り配列より長くなる場合があります。

戻り値:

メタ・メッセージ・データを含む配列

関連項目:

• MidiMessage.getLength()

clone

public Object clone()

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

定義:

clone、クラスMidiMessage

戻り値:

このインスタンスの複製

関連項目:

• Cloneable