javax.sound.midi
클래스 MetaMessage

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

모든 구현 인터페이스:

Cloneable

public class MetaMessage

extends MidiMessage

MetaMessage 는 신디사이저에 있어서는 의미가 없는 MidiMessage 입니다만, MIDI 파일에 저장된 시퀀서 프로그램에 의해 해석됩니다 (MidiMessage 클래스의 설명을 참조). 표준 MIDI 파일의 사양에 의해 순차 순서 번호, 가사, 연주 지시점, 템포의 설정 등 다양한 타입의 메타이벤트가 정의됩니다. 또, 가사, 저작권, 템포 지시, 박자 기호 및 조기호, 마커등의 정보의 메타이벤트도 있습니다. 상세한 것에 대하여는 MIDI Manufacturer's Association (http://www.midi.org ) 발행의 「Complete MIDI 1.0 Detailed Specification」에 거둘 수 있고 있는 「Standard MIDI Files 1.0」의 사양을 참조해 주세요.

MIDI 와이어 프로토콜을 사용해 데이터가 송신되고 있을 때, 상태치 0xFF 의 ShortMessage 는 시스템 리셋트 메세지를 나타내고 있습니다. MIDI 파일에서는 이 같은 상태치로 MetaMessage 를 나타냅니다. 메타멧세이지의 형태는 스테이터스 바이트 0xFF 에 계속되는 최초의 바이트에 의해 각각 구별됩니다. 후속의 바이트는 데이터 바이트입니다. 시스템 독자적인 메세지의 경우와 같게,MetaMessage 의 형태에 의해, 데이터 바이트수는 바뀝니다.

관련 항목:

MetaEventListener

필드의 개요

static int

META MetaMessage (0xFF 즉 255)의 스테이터스 바이트는 MIDI 파일로 사용됩니다.

클래스 javax.sound.midi. MidiMessage 에서 상속받은 필드

data , length

생성자의 개요

	MetaMessage () 새로운 MetaMessage 를 구축합니다.
protected	MetaMessage (byte[] data) 새로운 MetaMessage 를 구축합니다.

메소드의 개요

Object	clone () 이 오브젝트와 같은 클래스에서, 같은 내용의 새로운 오브젝트를 작성합니다.
byte[]	getData () 메타멧세이지의 데이터의 카피를 취득합니다.
int	getType () MetaMessage 의 형태를 취득합니다.
void	setMessage (int type, byte[] data, int length) MetaMessage 의 메세지 파라미터를 설정합니다.

클래스 javax.sound.midi. MidiMessage 에서 상속받은 메소드

getLength , getMessage , getStatus , setMessage

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

META

public static final int META

MetaMessage (0xFF 즉 255)의 스테이터스 바이트는 MIDI 파일로 사용됩니다. 이 스테이터스 바이트는 리얼타임의 「MIDI 와이어」프로토콜로 사용되는 SYSTEM_RESET 와 같은 값을 보관 유지합니다.

관련 항목:

MidiMessage.getStatus() , 정수 필드치

생성자의 상세

MetaMessage

public MetaMessage()

새로운 MetaMessage 를 구축합니다. 메세지의 내용은 여기에서는 설정되지 않습니다. 계속되어 setMessage 를 사용해 메세지 내용을 설정합니다.

MetaMessage

protected MetaMessage(byte[] data)

새로운 MetaMessage 를 구축합니다.

파라미터:

data - 상세한 메세지를 포함한 바이트의 배열. 메세지 데이터는 setMessage 메소드를 사용해 변경할 수 있는

관련 항목:

setMessage(int, byte[], int)

메소드의 상세

setMessage

public void setMessage(int type,
                       byte[] data,
                       int length)
                throws InvalidMidiDataException 

MetaMessage 의 메세지 파라미터를 설정합니다. 메타멧세이지에는 유일 0xFF 라고 하는 스테이터스 바이트치만이 가능해서, 여기서 지정할 필요는 없습니다. getStatus 를 호출하면(자), 전메타멧세이지가 0xFF 에 돌아옵니다.

MetaMessage 에서는 type 인수가 스테이터스 바이트에 계속되는 바이트의 유효치가 됩니다. data 인수는 MetaMessage 의 전후속 바이트를 포함합니다. 바꾸어 말하면(자),MetaMessage 의 형태를 지정하는 바이트는 데이터 바이트라고는 보이지 않습니다.

파라미터:

type - 메타멧세이지의 형태 (128 미만)

data - MIDI 메세지의 데이터 바이트

length - data 바이트 배열의 바이트수

예외:

InvalidMidiDataException - 파라미터치가 유효한 MIDI 메타멧세이지를 지정하지 않는 경우

InvalidMidiDataException

getType

public int getType()

MetaMessage 의 형태를 취득합니다.

반환값:

MetaMessage 의 형태를 나타내는 정수형

getData

public byte[] getData()

메타멧세이지의 데이터의 카피를 취득합니다. 바이트의 귀가 배열에는 스테이터스 바이트 또는 메세지장 데이터는 포함되지 않습니다. 메타멧세이지의 데이터의 길이가 배열의 길이입니다. 메세지 전체의 길이는 스테이터스 바이트 및 메타멧세이지형 바이트를 포함하기 (위해)때문에, 귀가 배열보다 길어지는 경우가 있습니다.

반환값:

메타멧세이지데이타를 포함한 배열

관련 항목:

MidiMessage.getLength()

clone

public Object  clone()

이 오브젝트와 같은 클래스에서, 같은 내용의 새로운 오브젝트를 작성합니다.

정의:

클래스 MidiMessage 내의 clone

반환값:

이 인스턴스의 복제