MidiMessage (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

javax.sound.midi
클래스 MidiMessage

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

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

직계의 기존의 서브 클래스:: MetaMessage , ShortMessage , SysexMessage

public abstract class MidiMessage
extends Object
implements Cloneable

MidiMessage 는 MIDI 메세지의 base class입니다. MetaMessage 는 신디사이저를 응답할 수 있는 표준의 MIDI 메세지 사나워지고가 아니고, 시퀀서 프로그램을 사용할 수 있는 「메타이벤트」도 포함합니다. 가사, 저작권, 템포 지시, 박자 기호 및 악곡의 조를 나타내는 기호, 마커등의 정보의 메타이벤트가 있습니다. 상세한 것에 대하여는 MIDI Manufacturer's Association (http://www.midi.org )로부터 발행되고 있는 「Complete MIDI 1.0 Detailed Specification」에 거둘 수 있고 있는 「Standard MIDI Files 1.0」의 사양을 참조해 주세요.

기저 MidiMessage 클래스는 MIDI 메세지에 관한 3 종류의 정보에의 액세스를 제공합니다.

메세지의 스테이터스 바이트
바이트 표시에 의한 메세지의 전체 길이 (스테이터스 바이트와 데이터 바이트)
결정된 메세지를 포함한 바이트 배열

MidiMessage 는 취득의 메소드를 포함합니다만, 이러한 값은 설정하지 않습니다. 이러한 값의 설정은 서브 클래스에 의해 행해집니다.

MIDI 표준은 MIDI 데이터를 바이트로 표시합니다. 그러나, Java^TM 는 부호 첨부 바이트를 사용하고 있기 (위해)때문에, Java Sound API 는 MIDI 데이터를 표시할 때에 바이트는 아니고 정수형을 사용합니다. 예를 들어,MidiMessage 의 getStatus() 메소드는 MIDI 스테이터스 바이트를 정수형으로서 돌려줍니다. Java Sound 의 외부에서 발생해 부호 첨부 바이트로서 encode 된 MIDI 데이터를 처리하는 경우는 다음의 변환식을 사용해 바이트를 정수형으로 변환할 수 있습니다.

int i = (int)(byte & 0xFF)

단지 기존의 MIDI 바이트치를 메소드 파라미터로서 건네줄 필요가 있을 뿐(만큼)의 경우는 10 진표기법 또는 16 진표기법을 사용해, 그 MIDI 바이트치를 정수형으로서 직접 나타낼 수가 있습니다. 예를 들어, 「액티브 센싱」스테이터스 바이트를 최초의 인수로서 ShortMessage 의 setMessage(int) 메소드에 건네주는 경우는 이 스테이터스 바이트를 254 또는 0xFE 로서 나타낼 수가 있습니다.

관련 항목:: Track , Sequence , Receiver

필드의 개요

protected byte[] data
          MIDI 메세지 데이터입니다.

protected int length
          MIDI 메세지의 바이트수로, 스테이터스 바이트와 데이터 바이트를 포함합니다.

생성자의 개요

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

메소드의 개요

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

int getLength ()
          MIDI 메세지의 전체 길이를 바이트로 취득합니다.

byte[] getMessage ()
          MIDI 메세지 데이터를 취득합니다.

int getStatus ()
          MIDI 메세지의 스테이터스 바이트를 취득합니다.

protected void setMessage (byte[] data, int length)
          MIDI 메세지의 데이터를 설정합니다.

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

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

필드의 상세

data

protected byte[] data

MIDI 메세지 데이터입니다. 최초의 바이트는 메세지의 스테이터스 바이트입니다. 메세지의 길이까지의 후속의 바이트가, 이 메세지의 데이터 바이트입니다.

관련 항목:: getLength()

length

protected int length

MIDI 메세지의 바이트수로, 스테이터스 바이트와 데이터 바이트를 포함합니다.

관련 항목:: getLength()

생성자의 상세

MidiMessage

protected MidiMessage(byte[] data)

새로운 MidiMessage 를 구축합니다. 이 protected constructor 은 구상 서브 클래스에 의해 불려 가 구상 서브 클래스는 데이터 배열에, 정리가 있는 유효한 MIDI 메세지를 지정시킵니다.
파라미터:: data - 상세한 메세지를 포함한 바이트의 배열. 메세지 데이터는 setMessage 메소드를 사용해 변경할 수 있는
관련 항목:: setMessage(byte[], int)

메소드의 상세

setMessage

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

MIDI 메세지의 데이터를 설정합니다. 이 protected 메소드는 구상 서브 클래스에 의해 불려 가 구상 서브 클래스는 데이터 배열에, 정리가 있는 유효한 MIDI 메세지를 지정시킵니다.

InvalidMidiDataException

getMessage

public byte[] getMessage()

MIDI 메세지 데이터를 취득합니다. 돌려주어진 바이트 배열의 최초의 바이트는 메세지의 스테이터스 바이트입니다. 메세지의 길이까지의 후속의 바이트가, 데이터 바이트입니다. 바이트 배열은 실제의 메세지보다 길이가 길어지는 경우가 있습니다. 바이트 표시에 의한 메세지의 전체 길이는 getLength() 메소드에 의해 보고됩니다.

반환값:: 결정된 MidiMessage 데이터를 포함한 바이트 배열

getStatus

public int getStatus()

MIDI 메세지의 스테이터스 바이트를 취득합니다. 스테이터스 「바이트」는 정수형으로서 나타내집니다. MidiMessage 클래스의 discussion 를 참조해 주세요.

반환값:: 이 이벤트의 스테이터스 바이트의 정수형 표시

getLength

public int getLength()

MIDI 메세지의 전체 길이를 바이트로 취득합니다. MIDI 메세지는 1 개의 스테이터스 바이트와 제로 또는 그 이상의 데이터 바이트로 구성됩니다. 반환값은 시스템 리얼타임 메세지를 나타내는 1, 채널 메세지를 나타내는 2 또는 3, 메타멧세이지 및 시스템에크스크루시브멧세이지를 나타내는 그 외의 값이 됩니다.

반환값:: 바이트 표시에 의한 메세지의 길이

clone

public abstract Object  clone()

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

오버라이드(override):: 클래스 Object 내의 clone

반환값:: 이 인스턴스의 복제
관련 항목:: Cloneable

개요