MetaMessage (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

javax.sound.midi
클래스 MetaMessage

java.lang.Object 
  javax.sound.midi.MidiMessage 
      javax.sound.midi.MetaMessage

모든 구현된 인터페이스:: Cloneable

public class MetaMessage
extends MidiMessage
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`

필드의 상세

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()

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