機械翻訳について

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