JavaTM 2
Platform
Std. Ed. v1.4.0

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

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.