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 또는 160)입니다.
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 또는 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

채널 압력 (애프터 터치) 메세지의 커멘드치 (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