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 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 ワイヤー」プロトコルで使用される 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 メタメッセージを指定していない場合

InvalidMidiDataException

getType

public int getType()

MetaMessage の型を取得します。

戻り値:

MetaMessage の型を示す整数型

getData

public byte[] getData()

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

戻り値:

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

関連項目:

MidiMessage.getLength()

clone

public Object clone()

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

定義:

clone、クラス: MidiMessage

戻り値:

このインスタンスの複製

関連項目:

Cloneable