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 클래스의 설명에 있는변환 코드를 사용할 수 있습니다.

관련 항목:

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) 데이터 바이트 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번째의 데이터 바이트가 무시되어 데이터 바이트 없음의 메세지의 경우는 양쪽 모두의 데이터 바이트가 무시됩니다.

파라미터:

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 

데이터 바이트 2개 로 구성되는 채널 메세지에 쇼트 메세지 파라미터를 설정합니다. 데이터 바이트 1개 만으로 구성되는 메세지의 경우는 2번째의 데이터 바이트가 무시되어 데이터 바이트 없음의 메세지의 경우는 양쪽 모두의 데이터 바이트가 무시됩니다.

파라미터:

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

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

getDataLength

protected final int getDataLength(int status)
                           throws InvalidMidiDataException 

특정의 스테이터스 바이트값에 관련한 데이터 바이트의 수를 취득합니다.

파라미터:

status - 쇼트 MIDI 메세지를 나타내는 스테이터스 바이트값

반환값:

바이트 단위의 데이터 길이 (0, 1, 또는 2)

예외:

InvalidMidiDataException - status인수로 쇼트 메세지의 스테이터스 바이트를 지정하고 있지 않는 경우

InvalidMidiDataException