<- C I ->

MIDI CONVERTERS

     ival notnum
     ival veloc
     icps cpsmidi
     icps cpsmidib
     kcps cpsmidib
     ioct octmidi
     ioct octmidib
     koct octmidib
     ipch pchmidi
     ipch pchmidib
     kpch pchmidib
     iamp ampmidi   iscal[, ifn]
     kaft aftouch   iscal
     kchprchpress   iscal
     kbendpchbend   iscal
     ival midictrl  inum
     kval midictrl  inum 
Get a value from the MIDI event that activated this instrument, or from a continuous MIDI controller, and convert it to a locally useful format.

INITIALIZATION

iscal - I-time scaling factor.

ifn (optional) - function table number of a normalized translation table, by which the incoming value is first interpreted. The default value is 0, denoting no translation.

inum - MIDI controller number.

PERFORMANCE

notnum, veloc - get the MIDI byte value (0 - 127) denoting the note number or velocity of the current event.

cpsmidi, octmidi, pchmidi - get the note number of the current MIDI event, expressed in cps, oct, or pch units for local processing.

cpsmidib, octmidib, pchmidib - get the note number of the current MIDI event, modify it by the current pitch-bend value, and express the result in cps, oct, or pch units. Available as an I-time value or as a continuous ksig value.

ampmidi - get the velocity of the current MIDI event, optionally pass it through a normalized translation table, and return an amplitude value in the range 0 - iscal.

aftouch, chpress, pchbend - get the current after-touch, channel pressure, or pitch-bend value for this channel, rescaled to the range 0 - iscal. Note that this access to pitch-bend data is independent of the MIDI pitch, enabling the value here to be used for any arbitrary purpose.

midictrl - get the current value (0 - 127) of a specified MIDI controller.

<- C I ->
Prepared from the MIT Media Lab Csound Manual, PJN, Nov 1994.