ION

QUICK-REF - CsoundManual - Top of this section - Previous - Contents - Index - Next Section

ion, ioff, iondur, iondur2

    ion         ichn, inum, ivel
    ioff        ichn, inum, ivel
    iondur      ichn, inum, ivel, idur
    iondur2     ichn, inum, ivel, idur

DESCRIPTION

send note-on and note-off messages to the MIDI OUT port.

INITIALIZATION

ichn - MIDI channel number (0-15)

inum - note number (0-127)

ivel - velocity (0-127)

PERFORMANCE

ion (i-rate note on) and ioff (i-rate note off) are the simplest MIDI OUT opcodes. ion sends a MIDI noteon message to MIDI OUT port, and ioff sends a noteoff message. A ion opcode must always be follwed by an ioff with the same channel and number inside the same instrument, otherwise the note will play endlessly. These ion and ioff are useful only when introducing a timout statement to play a non zero duration MIDI note. For most purposes it is better to use iondur and iondur2.

iondur and iondur2 (i-rate note on with duration) send a noteon and a noteoff MIDI message both with the same channel, number and velocity. Noteoff message is sent after idur seconds are elapsed by the time iondur was actived.

iondur differs from iondur2 in that iondur truncates note duration when current instrument is deactivated by score or by realtime playing, while iondur2 will extend performance time of current instrument until idur seconds have elapsed. In realtime playing it is suggested to use iondur also for undefined durations, giving a large idur value.

Any number of iondur or iondur2 opcodes can appear in the same Csound instrument, allowing chords to be played by a single instr.

AUTHOR:

Gabriel Maldonado
Italy
May 1997

QUICK-REF - CsoundManual - Top of this section - Previous - Contents - Index - Next Section