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
クラスの説明にある変換コードを使用できます。
- 関連項目:
SysexMessage
、MetaMessage
-
フィールドのサマリー
フィールド修飾子と型フィールド説明static int
アクティブ・センシング・メッセージのステータス・バイト(0xFEまたは254)です。static int
チャネル圧力のコマンド値(アフター・タッチ) message (0xD0または208)。static int
コンティニュー・メッセージのステータス・バイト(0xFBまたは251)です。static int
コントロール・チェンジ・メッセージのコマンド値(0xB0または176).です。static int
エンド・オブ・システム・エクスクルーシブ・メッセージのステータス・バイト(0xF7または247)です。static int
MIDIタイム・コード・クォータ・フレーム・メッセージのステータス・バイト(0xF1または241)です。static int
ノート・オフメッセージのコマンド値(0x80または128).です。static int
ノート・オンメッセージのコマンド値(0x90または144).です。static int
ピッチ・ベンド・メッセージのコマンド値(0xE0または224).です。static int
Polyphonic Key Pressureのコマンド値(アフタータッチ) message (0xA0、または160)。static int
プログラム・チェンジ・メッセージのコマンド値(0xC0または192).です。static int
ソング・ポジション・ポインタ・メッセージのステータス・バイト(0xF2または242)です。static int
MIDIソング・セレクト・メッセージのステータス・バイト(0xF3または243)です。static int
スタート・メッセージのステータス・バイト(0xFAまたは250)です。static int
ストップ・メッセージのステータス・バイト(0xFCまたは252)です。static int
システム・リセット・メッセージのステータス・バイト(0xFFまたは255)です。static int
タイミング・クロック・メッセージのステータス・バイト(0xF8または248)です。static int
チューン・リクエスト・メッセージのステータス・バイト(0xF6または246)です。クラス javax.sound.midi.MidiMessageで宣言されたフィールド
data, length
-
コンストラクタのサマリー
コンストラクタ修飾子コンストラクタ説明新しいShortMessage
を構築します。protected
ShortMessage(byte[] data)
新しいShortMessage
を構築します。ShortMessage(int status)
データ・バイトを必要としないMIDIメッセージを表すShortMessage
を新しく構築します。ShortMessage(int status, int data1, int data2)
データ・バイト2つで構成されるMIDIメッセージを表すShortMessage
を新しく構築します。ShortMessage(int command, int channel, int data1, int data2)
データ・バイト2つで構成されるチャネルMIDIメッセージを表すShortMessage
を新しく構築します。 -
メソッドのサマリー
修飾子と型メソッド説明clone()
このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。int
このイベントに関連したMIDIチャネルを取得します。int
このイベントに関連した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)
データ・バイト2つで構成されるチャネル・メッセージにショート・メッセージ・パラメータを設定します。クラス javax.sound.midi.MidiMessageで宣言されたメソッド
getLength, getMessage, getStatus, setMessage
-
フィールド詳細
-
MIDI_TIME_CODE
public static final int MIDI_TIME_CODEMIDIタイム・コード・クォータ・フレーム・メッセージのステータス・バイト(0xF1または241)です。 -
SONG_POSITION_POINTER
public static final int SONG_POSITION_POINTERソング・ポジション・ポインタ・メッセージのステータス・バイト(0xF2または242)です。 -
SONG_SELECT
public static final int SONG_SELECTMIDIソング・セレクト・メッセージのステータス・バイト(0xF3または243)です。 -
TUNE_REQUEST
public static final int TUNE_REQUESTチューン・リクエスト・メッセージのステータス・バイト(0xF6または246)です。 -
END_OF_EXCLUSIVE
public static final int END_OF_EXCLUSIVEエンド・オブ・システム・エクスクルーシブ・メッセージのステータス・バイト(0xF7または247)です。 -
TIMING_CLOCK
public static final int TIMING_CLOCKタイミング・クロック・メッセージのステータス・バイト(0xF8または248)です。 -
START
public static final int STARTスタート・メッセージのステータス・バイト(0xFAまたは250)です。 -
CONTINUE
public static final int CONTINUEコンティニュー・メッセージのステータス・バイト(0xFBまたは251)です。 -
STOP
public static final int STOPストップ・メッセージのステータス・バイト(0xFCまたは252)です。 -
ACTIVE_SENSING
public static final int ACTIVE_SENSINGアクティブ・センシング・メッセージのステータス・バイト(0xFEまたは254)です。 -
SYSTEM_RESET
public static final int SYSTEM_RESETシステム・リセット・メッセージのステータス・バイト(0xFFまたは255)です。 -
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_PRESSUREPolyphonic Key Pressureのコマンド値(アフタータッチ) message (0xA0、または160)。- 関連項目:
- 定数フィールド値
-
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チャネル圧力のコマンド値(アフター・タッチ) message (0xD0または208)。- 関連項目:
- 定数フィールド値
-
PITCH_BEND
public static final int PITCH_BENDピッチ・ベンド・メッセージのコマンド値(0xE0または224).です。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
ShortMessage
public ShortMessage()新しいShortMessage
を構築します。 新しいメッセージの内容には、有効なMIDIメッセージが指定されることが保証されます。 構築後にメッセージの内容を設定するには、setMessage
メソッドの1つを使用します。- 関連項目:
setMessage(int)
-
ShortMessage
public ShortMessage(int status) throws InvalidMidiDataExceptionデータ・バイトを必要としないMIDIメッセージを表すShortMessage
を新しく構築します。 メッセージの内容は、setMessage
メソッドの1つを使用して変更できます。- パラメータ:
status
- MIDIステータス・バイト- 例外:
InvalidMidiDataException
-status
で、データ・バイトを必要としないメッセージに対して有効なMIDIステータス・バイトが指定されていない場合- 導入されたバージョン:
- 1.7
- 関連項目:
setMessage(int)
,setMessage(int, int, int)
,setMessage(int, int, int, int)
,MidiMessage.getStatus()
-
ShortMessage
public ShortMessage(int status, int data1, int data2) throws InvalidMidiDataExceptionデータ・バイト2つで構成されるMIDIメッセージを表すShortMessage
を新しく構築します。 データ・バイト1つだけで構成されるメッセージの場合は、2番目のデータ・バイトが無視されます。 データ・バイトなしのメッセージの場合は、両方のデータ・バイトが無視されます。 メッセージの内容は、setMessage
メソッドの1つを使用して変更できます。- パラメータ:
status
- MIDIステータス・バイトdata1
- 第1データ・バイトdata2
- 第2データ・バイト- 例外:
InvalidMidiDataException
- メッセージを構成するステータス・バイトまたはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合- 導入されたバージョン:
- 1.7
- 関連項目:
setMessage(int)
,setMessage(int, int, int)
,setMessage(int, int, int, int)
,MidiMessage.getStatus()
,getData1()
,getData2()
-
ShortMessage
public ShortMessage(int command, int channel, int data1, int data2) throws InvalidMidiDataExceptionデータ・バイト2つで構成されるチャネルMIDIメッセージを表すShortMessage
を新しく構築します。 データ・バイト1つだけで構成されるメッセージの場合は、2番目のデータ・バイトが無視されます。 データ・バイトなしのメッセージの場合は、両方のデータ・バイトが無視されます。 メッセージの内容は、setMessage
メソッドの1つを使用して変更できます。- パラメータ:
command
- このメッセージで表されるMIDIコマンドchannel
- メッセージに関連したチャネルdata1
- 第1データ・バイトdata2
- 第2データ・バイト- 例外:
InvalidMidiDataException
- メッセージを構成するコマンド値、チャネル値、またはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合- 導入されたバージョン:
- 1.7
- 関連項目:
setMessage(int)
,setMessage(int, int, int)
,setMessage(int, int, int, int)
,getCommand()
,getChannel()
,getData1()
,getData2()
-
ShortMessage
protected ShortMessage(byte[] data)新しいShortMessage
を構築します。- パラメータ:
data
- 詳細なメッセージを含むバイトの配列。 メッセージ・データはsetMessage
メソッドを使って変更できる。- 関連項目:
setMessage(int)
-
-
メソッドの詳細
-
setMessage
public void setMessage(int status) throws InvalidMidiDataExceptionデータ・バイトを必要としないMIDIメッセージのパラメータを設定します。- パラメータ:
status
- MIDIステータス・バイト- 例外:
InvalidMidiDataException
-status
で、データ・バイトを必要としないメッセージに対して有効なMIDIステータス・バイトが指定されていない場合- 関連項目:
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番目のデータ・バイトが無視され、データ・バイトなしのメッセージの場合は両方のデータ・バイトが無視されます。- パラメータ:
status
- MIDIステータス・バイトdata1
- 第1データ・バイトdata2
- 第2データ・バイト- 例外:
InvalidMidiDataException
- ステータス・バイト、またはメッセージに属するすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合- 関連項目:
setMessage(int, int, int, int)
,setMessage(int)
-
setMessage
public void setMessage(int command, int channel, int data1, int data2) throws InvalidMidiDataExceptionデータ・バイト2つで構成されるチャネル・メッセージにショート・メッセージ・パラメータを設定します。 データ・バイト1つだけで構成されるメッセージの場合は2番目のデータ・バイトが無視され、データ・バイトなしのメッセージの場合は両方のデータ・バイトが無視されます。- パラメータ:
command
- このメッセージで表されるMIDIコマンドchannel
- メッセージに関連したチャネルdata1
- 第1データ・バイトdata2
- 第2データ・バイト- 例外:
InvalidMidiDataException
- メッセージを構成するステータス・バイトまたはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合- 関連項目:
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チャネル・メッセージでない場合には、戻り値は意味のあるものにはなりません。- 戻り値:
- このイベントに関連した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()このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。- 定義:
clone
、クラス:MidiMessage
- 戻り値:
- このインスタンスの複製
- 関連項目:
Cloneable
-
getDataLength
protected final int getDataLength(int status) throws InvalidMidiDataException特定のステータス・バイト値に関連したデータ・バイト数を取得します。- パラメータ:
status
- ショートMIDIメッセージを表すステータス・バイト値- 戻り値:
- バイト単位のデータ長(0、1、または2)
- 例外:
InvalidMidiDataException
-status
引数でショート・メッセージのステータス・バイトを指定していない場合
-