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

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable