javax.sound.midi
인터페이스 MidiChannel

public interface MidiChannel

MidiChannel 오브젝트는 단일의 MIDI 채널을 나타냅니다. 통상, 각 MidiChannel 메소드는 MIDI 사양으로 정의된 「채널 음성」, 「채널 모드」등의 MIDI 의 메세지를 처리합니다. 다만,MidiChannel 에는 표준 MIDI 채널 메세지의 1 개에 의해 가장 최근 설정된 값을 검색하는 「취득」메소드도 있습니다. 같이 채널별 솔로 메소드 및 뮤트 메소드도 추가되고 있습니다.

Synthesizer 오브젝트에는 MidiChannel 의 콜렉션이 있어, 통상은 MIDI 1.0 사양에 의해 16 채널의 각각 1 kr씩 규정되고 있습니다. Synthesizer 은 MidiChannel 가 noteOn 메세지를 수신했을 경우에 사운드를 생성합니다.

MIDI 채널 메세지의 규정 동작에 대해서는 여기에서는 자세하게 말하지 않으므로, 「MIDI 1.0 Specification」를 참조해 주세요. 사양은 「MIDI Reference: The Complete MIDI 1.0 Detailed Specification」라고 하는 타이틀로, MIDI Manufacturer's Association ( http://www.midi.org )로부터 발행되고 있습니다.

MIDI 는 원래 키보드 뮤지션의 움직임을 전하는 프로토콜이었습니다. 그 원형은 MidiChannel API 에 볼 수가 있습니다. API 에는 키 번호, 키 velocity, 키 압력등의 MIDI 의 개념이 보관 유지되고 있습니다. MIDI 데이터는 반드시 키보드 연주자에 의해 만들어질 필요는 없는 이라고 하는 것을 이해해 둘 필요가 있습니다 (전송원래는 다른 악기의 뮤지션이라도 소프트웨어에서도 괜찮습니다). 노트가 어떻게 만들어졌는지를 관련되지 않고 velocity와 압력에 일정한 값을 생성하는 디바이스도 있습니다. 또, MIDI 사양에서는 구현 측에 적합한 방법으로 신디사이저가 데이터를 사용할 수 있게 되어 있는 부분도 많이 있습니다. 예를 들어, velocity 데이터를 볼륨 또는 밝음, 혹은 그 양쪽 모두에 항상 MAP 할 필요는 없습니다.

관련 항목:

Synthesizer.getChannels()

메소드의 개요

void	allNotesOff () 이 채널로 현재 출력중의 노트를 모두 오프로 합니다.
void	allSoundOff () 이 채널로 출력중의 노트를 모두, 곧바로 오프로 합니다.
void	controlChange (int controller, int value) 지정된 콘트롤러의 값의 변화에 반응합니다.
int	getChannelPressure () 채널의 키보드 압력을 취득합니다.
int	getController (int controller) 지정된 콘트롤러의 현재의 값을 취득합니다.
boolean	getMono () 현재의 물건/다중 모드를 취득합니다.
boolean	getMute () 이 채널의 현재의 뮤트 상태를 취득합니다.
boolean	getOmni () 현재의 엄니 모드 스테이터스를 취득합니다.
int	getPitchBend () 이 채널의 하부 피치 좌표의 윗쪽을 취득합니다.
int	getPolyPressure (int noteNumber) 지정된 키를 누르고 있는 압력을 취득합니다.
int	getProgram () 이 채널의 현재의 프로그램 번호를 취득합니다.
boolean	getSolo () 이 채널의 현재의 솔로 상태를 취득합니다.
boolean	localControl (boolean on) 로컬 제어를 온 또는 오프로 합니다.
void	noteOff (int noteNumber) 지정된 노트의 소리를 오프로 합니다.
void	noteOff (int noteNumber, int velocity) 지정된 노트의 소리를 오프로 합니다.
void	noteOn (int noteNumber, int velocity) 지정된 노트의 소리를 내기 시작합니다.
void	programChange (int program) 프로그램 (패치)을 변경합니다.
void	programChange (int bank, int program) 뱅크 번호 및 프로그램 (패치) 번호를 사용해 프로그램을 변경합니다.
void	resetAllControllers () 전구현 콘트롤러를 디폴트 값에 리셋트 합니다.
void	setChannelPressure (int pressure) 키보드 압력의 변화에 반응합니다.
void	setMono (boolean on) 물건 모드를 온 또는 오프로 합니다.
void	setMute (boolean mute) 이 채널의 뮤트 상태를 설정합니다.
void	setOmni (boolean on) 엄니 모드를 온 또는 오프로 합니다.
void	setPitchBend (int bend) 이 채널의 모든 노트의 피치 좌표를 변경합니다.
void	setPolyPressure (int noteNumber, int pressure) 지정된 소리의 키 압력에 반응합니다.
void	setSolo (boolean soloState) 이 채널의 솔로 상태를 설정합니다.

메소드의 상세

noteOn

public void noteOn(int noteNumber,
                   int velocity)

지정된 노트의 소리를 내기 시작합니다. 키 다운 속도는 통상, 그 노트의 볼륨 또는 밝음, 혹은 그 양쪽 모두를 제어합니다. velocity 가 제로의 경우, 이 메소드는 noteOff(int) 와 같은 기능을 해, 노트를 정지시킵니다.

파라미터:

noteNumber - MIDI 노트 넘버, 0 에서 127 까지 (60 = 중앙의 C 음)

velocity - 키를 누르는 속도

관련 항목:

noteOff(int, int)

noteOff

public void noteOff(int noteNumber,
                    int velocity)

지정된 노트의 소리를 오프로 합니다. 키 업 velocity를 무시하지 않는 경우는 키 업 velocity를 사용해, 노트의 감쇠에 영향을 줄 수가 있습니다. 어쨌든, 노트는 순간에 사라지는 것은 아닙니다. 노트의 감쇠 속도는 Instrument 의 내부에 의해 정해집니다. 호르드페달 (콘트롤러,controlChange 를 참조)을 누르고 있는 경우는 이 메소드의 효과는 페달을 떼어 놓을 때까지 보류됩니다.

파라미터:

noteNumber - MIDI 노트 넘버, 0 에서 127 까지 (60 = 중앙의 C 음)

velocity - 키를 떼어 놓는 속도

관련 항목:

noteOff(int) , noteOn(int, int) , allNotesOff() , allSoundOff()

noteOff

public void noteOff(int noteNumber)

지정된 노트의 소리를 오프로 합니다.

파라미터:

noteNumber - MIDI 노트 넘버, 0 에서 127 까지 (60 = 중앙의 C 음)

관련 항목:

noteOff(int, int)

setPolyPressure

public void setPolyPressure(int noteNumber,
                            int pressure)

지정된 소리의 키 압력에 반응합니다. 다선율 키 압력에 의해, 키보드 연주자는 복수의 키를, 각각 다른 압력으로 동시에 누를 수가 있습니다. 압력을 무시하지 않는 경우, 통상은 압력을 사용해 그 노트의 볼륨, 밝음, 바이브라토등의 특징을 변화시킵니다.

파라미터:

noteNumber - MIDI 노트 넘버, 0 에서 127 까지 (60 = 중앙의 C 음)

pressure - 지정된 키의 값, 0 에서 127 까지 (127 = 최대압력)

관련 항목:

getPolyPressure(int)

getPolyPressure

public int getPolyPressure(int noteNumber)

지정된 키를 누르고 있는 압력을 취득합니다.

파라미터:

noteNumber - MIDI 노트 넘버, 0 에서 127 까지 (60 = 중앙의 C 음)

반환값:

그 소리에 대한 압력, 0 에서 127 까지 (127 = 최대압력)

관련 항목:

setPolyPressure(int, int)

setChannelPressure

public void setChannelPressure(int pressure)

키보드 압력의 변화에 반응합니다. 채널 압력은 키보드 연주자가 키보드 전체를 얼마나 강하게 누르고 있는지를 나타냅니다. 이것은 setPolyPressure 의 설정에 의해, 키별 압력센서의 최대치 또는 평균치가 됩니다. 좀 더 일반적으로 말하면(자), 채널 압력은 다선율 키 압력을 구현하고 있지 않는 디바이스의 단일의 센서의 측정치입니다. setPolyPressure 로 말하고 있게, 압력을 사용해 사운드의 다양한 면을 제어할 수 있습니다.

파라미터:

pressure - 키보드를 누르고 있는 압력, 0 에서 127 까지 (127 = 최대압력)

관련 항목:

setPolyPressure(int, int) , getChannelPressure()

getChannelPressure

public int getChannelPressure()

채널의 키보드 압력을 취득합니다.

반환값:

키보드를 누르고 있는 압력, 0 에서 127 까지 (127 = 최대압력)

관련 항목:

setChannelPressure(int)

controlChange

public void controlChange(int controller,
                          int value)

지정된 콘트롤러의 값의 변화에 반응합니다. 콘트롤러는 키보드의 키 이외의 제어장치로, 스윗치, 슬라이더, 페달, 다이얼, 숨압력센서 등입니다. MIDI 1.0 사양은 MIDI 디바이스의 일반적인 콘트롤러에 표준 번호를 주어 콘트롤러의 몇개인가에 대해 목적을 설명하고 있습니다. 콘트롤러의 변화에 대한 Instrument 의 반응의 방법은 그 Instrument 특유인 경우가 있습니다.

MIDI 1.0 사양은 7 비트 콘트롤러와 14 비트 콘트롤러의 양쪽 모두를 정의합니다. 다이얼이나 슬라이더등의 연속형 콘트롤러는 14 비트 (2 MIDI 바이트)가 표준으로, 스윗치등의 이산 콘트롤러는 7 비트 (1 MIDI 바이트)가 표준입니다. 각 형의 제어의 예상 해상도를 알려면 , 사양을 참조해 주세요.

콘트롤러 64 ~ 95 (0x40 - 0x5F)에서는 7 비트의 정밀도가 가능합니다. 7 비트 콘트롤러의 값은 모두,value 인수에 의해 설정됩니다. 콘트롤러의 추가 설정에 의해, 14 비트의 정밀도가 가능하게 됩니다. 이것에는 콘트롤러 번호를 2 개 사용합니다. 1 kr은 최상정도 7 비트용으로, 이제(벌써) 1 kr은 최하정도 7 비트용입니다. 콘트롤러 번호 0 ~ 31 (0x00 - 0x1F)은 14 비트 콘트롤러의 최상정도 7 비트를 제어해, 콘트롤러 번호 32 ~ 63 (0x20 - 0x3F)은 14 비트 콘트롤러의 최하정도 7 비트를 제어합니다. 예를 들어, 콘트롤러 번호 7 (0x07)은 채널 음량 콘트롤러의 상위 7 비트를 제어해, 콘트롤러 번호 39 (0x27)는 하위 7 비트를 제어합니다. 14 비트 콘트롤러의 값은 상위 7 비트와 하위 7 비트의 상호작용에 의해 정해집니다. 콘트롤러의 최상정도 7 비트가 설정되면(자) (콘트롤러 번호 0 ~ 31 을 사용), 하위의 7 비트는 자동적으로 0 으로 설정됩니다. 그 후, 하위 7 비트에 대응하는 콘트롤러 번호를 사용해 한층 더 콘트롤러의 값이 변경됩니다.

파라미터:

controller - 콘트롤러 번호 (0 ~ 127, 해석에 대해서는 MIDI 1.0 사양 참조)

value - 지정된 콘트롤러가 변경되는 값

관련 항목:

getController(int)

getController

public int getController(int controller)

지정된 콘트롤러의 현재의 값을 취득합니다. 반환값은 14 비트 이내에서 표시됩니다. 해상도는 콘트롤러 번호에 의해 정해집니다. 콘트롤러 0 ~ 31 의 경우, 해상도는 항상 14 비트입니다.

파라미터:

controller - 바람직한 값의 콘트롤러 번호. 가능 범위는 0 ~ 127, 해석에 대해서는 MIDI 1.0 사양 참조

반환값:

지정된 콘트롤러의 현재의 값

관련 항목:

controlChange(int, int)

programChange

public void programChange(int program)

프로그램 (패치)을 변경합니다. 이것에 의해, 현재 선택되고 있는 인스트르먼트의 뱅크로부터 특정의 인스트르먼트가 선택됩니다.

MIDI 사양은 벌써 들리고 있는 소리를 새로운 인스트르먼트 (음색)로 전환하든가, 혹은 노트·오프에 의해 종료시킬 때까지 원래의 음색을 계속할까에 대해서는 규정하고 있습니다.

프로그램 번호는 제로로부터 시작됩니다 (0 ~ 127 으로 표현됩니다). MIDI 하드웨어 디스플레이 및 MIDI 에 관한 문서에는 통상 0 ~ 127 은 아니고 1 ~ 128 까지의 번호가 사용됩니다.

파라미터:

program - 바꾸는 프로그램 번호 (0 ~ 127)

관련 항목:

programChange(int, int) , getProgram()

programChange

public void programChange(int bank,
                          int program)

뱅크 번호 및 프로그램 (패치) 번호를 사용해 프로그램을 변경합니다.

파라미터:

bank - 바꾸는 뱅크 번호 (0 ~ 127)

program - 지정된 뱅크 (0 ~ 127)에서 사용하는 프로그램 (패치)

관련 항목:

programChange(int) , getProgram()

getProgram

public int getProgram()

이 채널의 현재의 프로그램 번호를 취득합니다.

반환값:

현재 선택되고 있는 패치의 프로그램 번호

관련 항목:

Patch.getProgram() , Synthesizer.loadInstrument(javax.sound.midi.Instrument) , programChange(int)

setPitchBend

public void setPitchBend(int bend)

이 채널의 모든 노트의 피치 좌표를 변경합니다. 이것은 현재 출력중의 노트 모두후속의 노트에 영향을 줍니다 (피치의 벤드를 없애려면 , 값을 중앙의 위치에 리셋트 할 필요가 있습니다).

MIDI 사양에서는 핏치벤드를 14 비트치에 규정해, 제로가 최대 하부 비뚤어져, 16383 이 최대 윗쪽 비뚤어져, 8192 가 중앙 (핏치벤드 없음)이다고 규정하고 있습니다. 피치 변경의 실제의 값은 지정되고 있지 않습니다. 피치는 핏치벤드의 감도 설정에 의해 변경할 수 있습니다. 다만, 일반적인 MIDI 사양에서는 디폴트 범위는 중앙에서 상하 2 반음으로 되어 있습니다.

파라미터:

bend - 피치 변경량, 마이너스가 아닌 14 비트의 값 (8192 = 비뚤어져 없음)

관련 항목:

getPitchBend()

getPitchBend

public int getPitchBend()

이 채널의 하부 피치 좌표의 윗쪽을 취득합니다.

반환값:

일그러짐량, 마이너스가 아닌 14 비트의 값 (8192 = 비뚤어져 없음)

관련 항목:

setPitchBend(int)

resetAllControllers

public void resetAllControllers()

전구현 콘트롤러를 디폴트 값에 리셋트 합니다.

관련 항목:

controlChange(int, int)

allNotesOff

public void allNotesOff()

이 채널로 현재 출력중의 노트를 모두 오프로 합니다. 노트는 순간에 사라지는 것은 아닙니다. 노트의 감쇠 속도는 Instrument 의 내부에 의해 정해집니다. 호르드페다르콘트로라 (controlChange 참조)를 누르고 있는 경우는 이 메소드의 효과는 페달을 떼어 놓을 때까지 보류됩니다.

관련 항목:

allSoundOff() , noteOff(int)

allSoundOff

public void allSoundOff()

이 채널로 출력중의 노트를 모두, 곧바로 오프로 합니다. 호르드페달 및 현재의 Instrument 의 내부 감쇠 속도는 무시합니다.

관련 항목:

allNotesOff()

localControl

public boolean localControl(boolean on)

로컬 제어를 온 또는 오프로 합니다. 로컬 제어의 디폴트는 온입니다. 「온」으로 설정되어 있으면(자), 디바이스가 사운드의 합성 및 MIDI 메세지의 전송도 할 수 있는 경우, 디바이스가 노트·온 및 노트·오프 메세지에 응답해 사운드를 합성해, 디바이스 자체가 전송 합니다. 「오프」로 설정되면(자), 신디사이저는 신디사이저 자체의 전송 된 MIDI 메세지는 무시하지만 다른 디바이스로부터 수신한 메세지는 무시하지 않습니다.

파라미터:

on - 로컬 제어를 온으로 하는 경우는 true, 오프로 하는 경우는 false

반환값:

새로운 로컬 제어치

setMono

public void setMono(boolean on)

물건 모드를 온 또는 오프로 합니다. 물건 모드에서는 채널은 1 번에 1 개의 노트만을 합성합니다. 다중 모드 (물건 모드 오프와 같다)에서는 채널은 동시에 복수의 노트를 합성할 수 있습니다. 디폴트는 물건 오프 (다중 모드 온)입니다.

「물건」은 「모노포닉크 (단성의 것)」라고 하는 단어의 생략형으로, 이 문맥에서는 「다선율 (다성의 것)」이라고 하는 단어의 반대를 의미해, MIDI 채널별의 단일의 신디사이저음을 가리킵니다. 얼마나 많은 오디오 채널이 있는가 하는 것으로는 관계 없습니다 ( 「모노포닉크」대 「스테레오포닉크」의 녹음의 경우와 같다).

파라미터:

on - 물건 모드를 온으로 하는 경우는 true, 오프 (즉 다중 모드를 온)로 하는 경우는 false

관련 항목:

getMono() , VoiceStatus

getMono

public boolean getMono()

현재의 물건/다중 모드를 취득합니다.

반환값:

물건 모드가 온의 경우는 true, 그 이외는 false (즉 다중 모드가 온)

관련 항목:

setMono(boolean)

setOmni

public void setOmni(boolean on)

엄니 모드를 온 또는 오프로 합니다. 엄니 모드에서는 채널은 전채널에 송신된 메세지에 응답합니다. 엄니가 오프의 경우는 채널은 그 채널 번호에 송신된 메세지에만 응답합니다. 디폴트는 엄니 오프입니다.

파라미터:

on - 엄니 모드를 온으로 하는 경우는 true, 오프로 하는 경우는 false

관련 항목:

getOmni() , VoiceStatus

getOmni

public boolean getOmni()

현재의 엄니 모드 스테이터스를 취득합니다.

반환값:

엄니 모드가 온의 경우는 true, 그 이외는 false

관련 항목:

setOmni(boolean)

setMute

public void setMute(boolean mute)

이 채널의 뮤트 상태를 설정합니다. true 의 값은 그 채널의 소리가 지워지고 있는 것을 의미해,false 는 그 채널로 소리가 출력되는 것을 의미합니다 (다른 채널이 솔로로 되어 있지 않은 경우).

allSoundOff() 와 달리, 이 메소드는 특정의 채널인 만큼 적용되어 전채널에는 적용되지 않습니다. 또, 이 메소드는 현재 출력되고 있는 노트 뿐만이 아니라, 그 후 수신되는 노트도 무음으로 합니다.

파라미터:

mute - 새로운 뮤트 상태

관련 항목:

getMute() , setSolo(boolean)

getMute

public boolean getMute()

이 채널의 현재의 뮤트 상태를 취득합니다.

반환값:

채널의 소리가 지워지고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

setMute(boolean)

setSolo

public void setSolo(boolean soloState)

이 채널의 솔로 상태를 설정합니다. solo 가 true 의 경우는 이 채널 및 다른 솔로가 되어 있는 다른 채널의 소리만이 들립니다. solo 가 false 의 경우는 다른 솔로가 되어 있는 채널의 소리만이 들립니다만, 솔로가 되어 있는 채널이 없을 때는 뮤트로 되어 있지 않은 채널의 소리가 모두 들립니다.

파라미터:

soloState - 채널의 새로운 솔로 상태

관련 항목:

getSolo() , setMute(boolean)

getSolo

public boolean getSolo()

이 채널의 현재의 솔로 상태를 취득합니다.

반환값:

솔로의 경우는 true, 그렇지 않은 경우는 false

관련 항목:

setSolo(boolean)