|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface MidiChannelWriter
Method Summary | |
---|---|
void |
allNotesOff()
Turns off all notes that are currently sounding on this channel. |
void |
allSoundOff()
Immediately turns off all sounding notes on this channel, ignoring the state of the Hold Pedal and the internal decay rate of the current Instrument . |
void |
controlChange(int controller,
int value)
Reacts to a change in the specified controller's value. |
int |
getIndex()
|
boolean |
localControl(boolean local)
Turns local control on or off. |
void |
noteOff(int noteNumber)
Turns the specified note off. |
void |
noteOff(int noteNumber,
int velocity)
Turns the specified note off. |
void |
noteOn(int noteNumber,
int velocity)
Starts the specified note sounding. |
void |
programChange(int program)
Changes a program (patch). |
void |
programChange(int bank,
int program)
Changes the program using bank and program (patch) numbers. |
void |
resetAllControllers()
Resets all the implemented controllers to their default values. |
void |
setChannelPressure(int channelPressure)
Reacts to a change in the keyboard pressure. |
void |
setControl(int control,
int value)
Set the controller with the specified index to the specified value. |
void |
setMono(boolean mono)
Turns mono mode on or off. |
void |
setMute(boolean mute)
Sets the mute state for this channel. |
void |
setOmni(boolean omni)
Turns omni mode on or off. |
void |
setPan(int pan)
|
void |
setPitchBend(int pitchBend)
Changes the pitch offset for all notes on this channel. |
void |
setPolyPressure(int noteNumber,
int pressure)
Reacts to a change in the specified note's key pressure. |
void |
setSolo(boolean solo)
Sets the solo state for this channel. |
void |
setVolume(int volume)
|
Method Detail |
---|
void setControl(int control, int value)
void setSolo(boolean solo)
solo
is true
only this channel
and other soloed channels will sound. If solo
is false
then only other soloed channels will
sound, unless no channels are soloed, in which case all unmuted channels will sound.
soloState
- new solo state for the channel#getSolo
,
setMute(boolean)
int getIndex()
void setPitchBend(int pitchBend)
The MIDI specification stipulates that pitch bend be a 14-bit value, where zero is maximum downward bend, 16383 is maximum upward bend, and 8192 is the center (no pitch bend). The actual amount of pitch change is not specified; it can be changed by a pitch-bend sensitivity setting. However, the General MIDI specification says that the default range should be two semitones up and down from center.
bend
- the amount of pitch change, as a nonnegative 14-bit value (8192 = no bend)#getPitchBend
void setChannelPressure(int channelPressure)
setPolyPressure
. More commonly, it is a measurement of
a single sensor on a device that doesn't implement polyphonic key pressure. Pressure can be used to control various
aspects of the sound, as described under setPolyPressure
.
pressure
- the pressure with which the keyboard is being depressed, from 0 to 127 (127 = maximum pressure)setPolyPressure(int, int)
,
#getChannelPressure
void setVolume(int volume)
void setPan(int pan)
void setMono(boolean mono)
"Mono" is short for the word "monophonic," which in this context is opposed to the word "polyphonic" and refers to a single synthesizer voice per MIDI channel. It has nothing to do with how many audio channels there might be (as in "monophonic" versus "stereophonic" recordings).
on
- true
to turn mono mode on, false
to turn it off (which means turning poly mode on).#getMono
void setOmni(boolean omni)
on
- true
to turn omni mode on, false
to turn it off.#getOmni
void setMute(boolean mute)
true
means the channel is to be muted, false
means the channel can sound (if other channels are not soloed). Unlike allSoundOff()
, this method
applies to only a specific channel, not to all channels. Further, it
silences not only currently sounding notes, but also subsequently received notes.
mute
- the new mute state#getMute
,
setSolo(boolean)
void noteOn(int noteNumber, int velocity)
velocity
is zero, this method instead acts like noteOff(int)
, terminating the note.
noteNumber
- the MIDI note number, from 0 to 127 (60 = Middle C)velocity
- the speed with which the key was depressednoteOff(int, int)
void noteOff(int noteNumber, int velocity)
Instrument
. If the Hold Pedal (a controller; see controlChange
) is down,
the effect of this method is deferred until the pedal is released.
noteNumber
- the MIDI note number, from 0 to 127 (60 = Middle C)velocity
- the speed with which the key was releasednoteOff(int)
,
noteOn(int, int)
,
allNotesOff()
,
allSoundOff()
void noteOff(int noteNumber)
noteNumber
- the MIDI note number, from 0 to 127 (60 = Middle C)noteOff(int, int)
void setPolyPressure(int noteNumber, int pressure)
noteNumber
- the MIDI note number, from 0 to 127 (60 = Middle C)pressure
- value for the specified key, from 0 to 127 (127 = maximum pressure)#getPolyPressure(int)
void controlChange(int controller, int value)
Instrument
reacts to a controller change may be
specific to the Instrument
. The MIDI 1.0 Specification defines both 7-bit controllers and 14-bit controllers. Continuous controllers, such as wheels and sliders, typically have 14 bits (two MIDI bytes), while discrete controllers, such as switches, typically have 7 bits (one MIDI byte). Refer to the specification to see the expected resolution for each type of control.
Controllers 64 through 95 (0x40 - 0x5F) allow 7-bit precision.
The value of a 7-bit controller is set completely by the value
argument. An additional set of controllers
provide 14-bit precision by using two controller numbers, one for the most significant 7 bits and another for the least
significant 7 bits. Controller numbers 0 through 31 (0x00 - 0x1F) control the
most significant 7 bits of 14-bit controllers; controller numbers
32 through 63 (0x20 - 0x3F) control the least significant 7 bits of
these controllers. For example, controller number 7 (0x07) controls
the upper 7 bits of the channel volume controller, and controller number 39 (0x27) controls the lower 7 bits.
The value of a 14-bit controller is determined by the interaction of the two halves. When the most significant 7 bits
of a controller are set (using controller numbers 0 through 31), the
lower 7 bits are automatically set to 0. The corresponding controller
number for the lower 7 bits may then be used to further modulate the controller value.
controller
- the controller number (0 to 127; see the MIDI 1.0 Specification for the interpretation)value
- the value to which the specified controller is changed (0 to 127)#getController(int)
void programChange(int program)
The MIDI specification does not dictate whether notes that are already sounding should switch to the new instrument (timbre) or continue with their original timbre until terminated by a note-off.
The program number is zero-based (expressed from 0 to 127). Note that MIDI hardware displays and literature about MIDI typically use the range 1 to 128 instead.
program
- the program number to switch to (0 to 127)programChange(int, int)
,
#getProgram()
void programChange(int bank, int program)
bank
- the bank number to switch to (0 to 16383)program
- the program (patch) to use in the specified bank (0 to 127)programChange(int)
,
#getProgram()
void resetAllControllers()
controlChange(int, int)
void allNotesOff()
Instrument
.
If the Hold Pedal controller (see controlChange
) is down, the effect of this method is
deferred until the pedal is released.
allSoundOff()
,
noteOff(int)
void allSoundOff()
Instrument
.
allNotesOff()
boolean localControl(boolean local)
local
- true
to turn local control on, false
to turn local control off
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |