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メタ・メッセージを指定していない場合

getType

public int getType()

MetaMessageの型を取得します。

戻り値:

MetaMessageの型を示す整数型

getData

public byte[] getData()

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

戻り値:

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

関連項目:

MidiMessage.getLength()

clone

public Object clone()

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

定義:

clone、クラス: MidiMessage

戻り値:

このインスタンスの複製

関連項目:

Cloneable