javax.sound.midi
クラス ShortMessage

java.lang.Object
  |
  +--javax.sound.midi.MidiMessage
        |
        +--javax.sound.midi.ShortMessage

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

Cloneable

public class ShortMessage

extends MidiMessage

ShortMessage には、ステータスバイトのあとに続く 2 バイトまでのデータバイトを持つ MIDI メッセージが格納されます。これに該当する MIDI メッセージには、チャネルボイス、チャネルモード、システムコモン、システムリアルタイムの各タイプ、つまりシステムエクスクルーシブとメタイベントを除くすべてが含まれます。ShortMessage クラスでは、MIDI メッセージの内容を取得および設定するメソッドが提供されます。

多くの ShortMessage メソッドには、MIDI のステータスバイトまたはデータバイトを指定するための整数型パラメータがあります。数値がわかっている場合は、それを直接明示できます。システムコモンおよびシステムリアルタイムメッセージでは、多くの場合 SYSTEM_RESET などの、対応する ShortMessage のフィールドを使用できます。チャネルメッセージでは、ステータスバイトの上位 4 ビットはコマンド値によって指定され、下位 4 ビットは MIDI チャネル番号によって指定されます。Java の符号付きバイト形式で受信された MIDI データバイトを変換するには、MidiMessage クラス記述にある conversion code を使用できます。

関連項目:

SysexMessage, MetaMessage

フィールドの概要

static int	ACTIVE_SENSING アクティブセンシングメッセージのステータスバイト (0xFE または 254)
static int	CHANNEL_PRESSURE チャネルプレッシャ (アフタータッチ) メッセージのコマンド値 (0xD0 または 208)
static int	CONTINUE コンティニュメッセージのステータスバイト (0xFB または 251)
static int	CONTROL_CHANGE コントロールチェンジメッセージのコマンド値 (0xB0 または 176)
static int	END_OF_EXCLUSIVE システムエンドオブエクスクルーシブメッセージのステータスバイト (0xF7 または 247)
static int	MIDI_TIME_CODE MIDI タイムコードクォータフレームメッセージのステータスバイト (0xF1 または 241)
static int	NOTE_OFF ノート・オフメッセージのコマンド値 (0x80 または 128)
static int	NOTE_ON ノート・オンメッセージのコマンド値 (0x90 または 144)
static int	PITCH_BEND ピッチベンドメッセージのコマンド値 (0xE0 または 224)
static int	POLY_PRESSURE ポリフォニックキープレッシャ (アフタータッチ) メッセージのコマンド値 (0xA0 または 128)
static int	PROGRAM_CHANGE プログラムチェンジメッセージのコマンド値 (0xC0 または 192)
static int	SONG_POSITION_POINTER ソングポジションポインタメッセージのステータスバイト (0xF2 または 242)
static int	SONG_SELECT MIDI ソングセレクトメッセージのステータスバイト (0xF3 または 243)
static int	START スタートメッセージのステータスバイト (0xFA または 250)
static int	STOP ストップメッセージのステータスバイト (0xFC または 252)
static int	SYSTEM_RESET システムリセットメッセージのステータスバイト (0xFF または 255)
static int	TIMING_CLOCK タイミングクロックメッセージのステータスバイト (0xF8 または 248)
static int	TUNE_REQUEST チューンリクエストメッセージのステータスバイト (0xF6 または 246)

クラス javax.sound.midi.MidiMessage から継承したフィールド

data, length

コンストラクタの概要

	ShortMessage() 新しい ShortMessage を構築します。
protected	ShortMessage(byte[] data) 新しい ShortMessage を構築します。

メソッドの概要

Object	clone() このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
int	getChannel() このイベントに関連した MIDI チャネルを取得します。
int	getCommand() このイベントに関連した MIDI コマンドを取得します。
int	getData1() メッセージの第 1 データバイトを取得します。
int	getData2() メッセージの第 2 データバイトを取得します。
protected int	getDataLength(int status) 特定のステータスバイト値に関連したデータバイトの数を取得します。
void	setMessage(int status) データバイトを必要としない MIDI メッセージのパラメータを設定します。
void	setMessage(int status, int data1, int data2) 1 または 2 バイトのデータバイトを必要とする MIDI メッセージのパラメータを設定します。
void	setMessage(int command, int channel, int data1, int data2) 1 または 2 バイトのデータバイトを必要とするチャネルメッセージのショートメッセージパラメータを設定します。

クラス javax.sound.midi.MidiMessage から継承したメソッド

getLength, getMessage, getStatus, setMessage

クラス java.lang.Object から継承したメソッド

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

フィールドの詳細

MIDI_TIME_CODE

public static final int MIDI_TIME_CODE

MIDI タイムコードクォータフレームメッセージのステータスバイト (0xF1 または 241)

関連項目:

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

SONG_POSITION_POINTER

public static final int SONG_POSITION_POINTER

ソングポジションポインタメッセージのステータスバイト (0xF2 または 242)

関連項目:

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

SONG_SELECT

public static final int SONG_SELECT

MIDI ソングセレクトメッセージのステータスバイト (0xF3 または 243)

関連項目:

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

TUNE_REQUEST

public static final int TUNE_REQUEST

チューンリクエストメッセージのステータスバイト (0xF6 または 246)

関連項目:

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

END_OF_EXCLUSIVE

public static final int END_OF_EXCLUSIVE

システムエンドオブエクスクルーシブメッセージのステータスバイト (0xF7 または 247)

関連項目:

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

TIMING_CLOCK

public static final int TIMING_CLOCK

タイミングクロックメッセージのステータスバイト (0xF8 または 248)

関連項目:

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

START

public static final int START

スタートメッセージのステータスバイト (0xFA または 250)

関連項目:

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

CONTINUE

public static final int CONTINUE

コンティニュメッセージのステータスバイト (0xFB または 251)

関連項目:

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

STOP

public static final int STOP

ストップメッセージのステータスバイト (0xFC または 252)

関連項目:

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

ACTIVE_SENSING

public static final int ACTIVE_SENSING

アクティブセンシングメッセージのステータスバイト (0xFE または 254)

関連項目:

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

SYSTEM_RESET

public static final int SYSTEM_RESET

システムリセットメッセージのステータスバイト (0xFF または 255)

関連項目:

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

NOTE_OFF

public static final int NOTE_OFF

ノート・オフメッセージのコマンド値 (0x80 または 128)

関連項目:

定数フィールド値

NOTE_ON

public static final int NOTE_ON

ノート・オンメッセージのコマンド値 (0x90 または 144)

関連項目:

定数フィールド値

POLY_PRESSURE

public static final int POLY_PRESSURE

ポリフォニックキープレッシャ (アフタータッチ) メッセージのコマンド値 (0xA0 または 128)

関連項目:

定数フィールド値

CONTROL_CHANGE

public static final int CONTROL_CHANGE

コントロールチェンジメッセージのコマンド値 (0xB0 または 176)

関連項目:

定数フィールド値

PROGRAM_CHANGE

public static final int PROGRAM_CHANGE

プログラムチェンジメッセージのコマンド値 (0xC0 または 192)

関連項目:

定数フィールド値

CHANNEL_PRESSURE

public static final int CHANNEL_PRESSURE

チャネルプレッシャ (アフタータッチ) メッセージのコマンド値 (0xD0 または 208)

関連項目:

定数フィールド値

PITCH_BEND

public static final int PITCH_BEND

ピッチベンドメッセージのコマンド値 (0xE0 または 224)

関連項目:

定数フィールド値

コンストラクタの詳細

ShortMessage

public ShortMessage()

新しい ShortMessage を構築します。新しいメッセージの内容には、有効な MIDI メッセージが確実に指定されます。構築後にメッセージの内容を設定するには、setMessage メソッドの 1 つを使用します。

関連項目:

setMessage(int)

ShortMessage

protected ShortMessage(byte[] data)

新しい ShortMessage を構築します。

パラメータ:

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

関連項目:

setMessage(int)

メソッドの詳細

setMessage

public void setMessage(int status)
                throws InvalidMidiDataException

データバイトを必要としない MIDI メッセージのパラメータを設定します。

パラメータ:

status - MIDI ステータスバイト

例外:

InvalidMidiDataException - status で、データバイトを必要としないメッセージに対する有効な MIDI ステータスバイトが指定されていない場合

InvalidMidiDataException

関連項目:

setMessage(int, int, int), setMessage(int, int, int, int)

setMessage

public void setMessage(int status,
                       int data1,
                       int data2)
                throws InvalidMidiDataException

1 または 2 バイトのデータバイトを必要とする MIDI メッセージのパラメータを設定します。メッセージで必要とされるデータバイトが 1 つだけの場合、第 2 のデータバイトに渡す値は 0 でなければなりません。

パラメータ:

status - MIDI ステータスバイト

data1 - 第 1 データバイト

data2 - 第 2 データバイト

例外:

InvalidMidiDataException - ステータスバイトまたはデータバイトで有効な MIDI メッセージを指定していない場合

InvalidMidiDataException

関連項目:

setMessage(int, int, int, int), setMessage(int)

setMessage

public void setMessage(int command,
                       int channel,
                       int data1,
                       int data2)
                throws InvalidMidiDataException

1 または 2 バイトのデータバイトを必要とするチャネルメッセージのショートメッセージパラメータを設定します。メッセージで必要とされるデータバイトが 1 つだけの場合、渡される第 2 データバイトの値は 0 でなければなりません。

パラメータ:

command - このメッセージで表される MIDI コマンド

channel - メッセージに関連したチャネル

data1 - 第 1 データバイト

data2 - 第 2 データバイト

例外:

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

InvalidMidiDataException

関連項目:

setMessage(int, int, int), setMessage(int), getCommand(), getChannel(), getData1(), getData2()

getChannel

public int getChannel()

このイベントに関連した MIDI チャネルを取得します。このメソッドでは、イベントが MIDI チャネルメッセージであることが想定されています。イベントが MIDI チャネルメッセージでない場合には、戻り値は意味のあるものにはなりません。

戻り値:

メッセージに関連した MIDI チャネル

関連項目:

setMessage(int, int, int, int)

getCommand

public int getCommand()

このイベントに関連した MIDI コマンドを取得します。このメソッドでは、イベントが MIDI チャネルメッセージであることが想定されています。イベントが MIDI チャネルメッセージでない場合には、戻り値は意味のあるものにはなりません。

関連項目:

setMessage(int, int, int, int)

getData1

public int getData1()

メッセージの第 1 データバイトを取得します。

戻り値:

data1 フィールドの値

関連項目:

setMessage(int, int, int)

getData2

public int getData2()

メッセージの第 2 データバイトを取得します。

戻り値:

data2 フィールドの値

関連項目:

setMessage(int, int, int)

clone

public Object clone()

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

定義:

クラス MidiMessage 内の clone

戻り値:

このインスタンスの複製

getDataLength

protected final int getDataLength(int status)
                           throws InvalidMidiDataException

特定のステータスバイト値に関連したデータバイトの数を取得します。

パラメータ:

status - ショート MIDI メッセージを表すステータスバイト値

戻り値:

バイト単位のデータ長 (0、1、または 2)

例外:

InvalidMidiDataException - status 引数でショートメッセージのステータスバイトを指定していない場合

InvalidMidiDataException