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
の型によってデータ・バイト数は異なります。
- 関連項目:
-
フィールドのサマリー
フィールドクラス javax.sound.midi.MidiMessageで宣言されたフィールド
data, length
-
コンストラクタのサマリー
コンストラクタ修飾子コンストラクタ説明新しいMetaMessage
を構築します。protected
MetaMessage
(byte[] data) 新しいMetaMessage
を構築します。MetaMessage
(int type, byte[] data, int length) MetaMessage
を新しく構築し、メッセージ・パラメータを設定します。 -
メソッドのサマリー
修飾子と型メソッド説明clone()
このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。byte[]
getData()
メタ・メッセージのデータのコピーを取得します。int
getType()
MetaMessage
の型を取得します。void
setMessage
(int type, byte[] data, int length) MetaMessage
のメッセージ・パラメータを設定します。クラス javax.sound.midi.MidiMessageで宣言されたメソッド
getLength, getMessage, getStatus, setMessage
-
フィールド詳細
-
META
public static final int METAMetaMessage
(0xFFつまり255)のステータス・バイトは、MIDIファイルで使用されます。 これはリアルタイム"MIDIワイヤー"プロトコルで使用されるShortMessage.SYSTEM_RESET
と同じ値を持ちます。
-
-
コンストラクタの詳細
-
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
- 関連項目:
-
MetaMessage
protected MetaMessage(byte[] data) 新しいMetaMessage
を構築します。- パラメータ:
data
- 詳細なメッセージを含むバイトの配列。 メッセージ・データはsetMessage
メソッドを使って変更できる。- 関連項目:
-
-
メソッドの詳細
-
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()メタ・メッセージのデータのコピーを取得します。 バイトの戻り配列には、ステータス・バイトまたはメッセージ長データは含まれません。 メタ・メッセージのデータの長さが配列の長さです。 メッセージ全体の長さはステータス・バイトおよびメタ・メッセージ型バイトを含むため、戻り配列より長くなる場合があります。- 戻り値:
- メタ・メッセージ・データを含む配列
- 関連項目:
-
clone
public Object clone()このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。- 定義:
clone
、クラスMidiMessage
- 戻り値:
- このインスタンスの複製
- 関連項目:
-