midiformat Reference

Prepare data in the form of a MIDI message

midiformat

Examples

Arguments

channel [number]

Optional

The number is stored as the channel number of the MIDI messages. The actual value of the status byte is dependent on the channel. Numbers greater than 16 are wrapped around to stay between 1 and 16.

Inlets

noteonoroff [list]

The first number is a pitch value and the second number is a velocity value, to be formatted into a note-on/off message. Alternatively the noteout object can be used to format this message.

polypressure [list]

The first number is an aftertouch (pressure) value and the second number is a pitch value (key number), to be formatted into a polyphonic key pressure message. Alternatively the polyout object can be used to format this message.

controlchange [list]

The first number is a control value and the second number is a controller number, to be formatted into a control message. Alternatively the ctlout object can be used to format this message.

programchange [number]

The value is formatted into a program change message. Alternatively the pgmout object can be used to format this message.

aftertouch [number]

The value is formatted into an aftertouch (channel pressure) message. Alternatively the touchout object can be used to format this message.

pitchbend [number]

pitchbend

channel [number]

The number is stored as the channel number of the MIDI messages. The actual value of the status byte is dependent on the channel. Numbers greater than 16 are wrapped around to stay between 1 and 16.

Outlets

midimessage [number]

MIDI messages are sent out as individual bytes, for transmission by the midiout object. For more information see: RNBO Communications - MIDI .

Fixed Attributes

These attributes must be set in the object box and determine the behavior of the object at runtime.

bendmode [enum] (default: float)

An integer in the range 0 - 2 sets the range used for pitch bend messages by the midiformat object.

Possible values:

  • 0 = 'Off (0-127)' ( Standard 8-bit MIDI pitch bend range (default) )
  • 1 = 'Float (-1 to 1)' ( Uses pitch bend messages in the audio signal range )
  • 2 = '14-bit Fixed (-8192 to 8191)' ( Standard 14-bit MIDI high resolution pitch bend range )
Possible values:

0 = 'lores'
1 = 'float'
2 = 'hires'

Dynamic Attributes

These attributes can be modified in the code during execution using the set object

aftertouch [number]

The value is formatted into an aftertouch (channel pressure) message. Alternatively the touchout object can be used to format this message.

channel [number]

The number is stored as the channel number of the MIDI messages. The actual value of the status byte is dependent on the channel. Numbers greater than 16 are wrapped around to stay between 1 and 16.

controlchange [list]

The first number is a control value and the second number is a controller number, to be formatted into a control message. Alternatively the ctlout object can be used to format this message.

noteonoroff [list]

The first number is a pitch value and the second number is a velocity value, to be formatted into a note-on/off message. Alternatively the noteout object can be used to format this message.

pitchbend [number]

pitchbend

polypressure [list]

The first number is an aftertouch (pressure) value and the second number is a pitch value (key number), to be formatted into a polyphonic key pressure message. Alternatively the polyout object can be used to format this message.

programchange [number]

The value is formatted into a program change message. Alternatively the pgmout object can be used to format this message.

See Also

Name Description
midiin Output raw MIDI data
bendout Generate MIDI pitch bend events
ctlout Transmit MIDI controller messages
midiparse Interpret raw MIDI data
midiin MIDI input stream
noteout transmit MIDI note messages
pgmout generate MIDI program change messages
sysexout Output MIDI System Exclusive messages
touchout Generate MIDI aftertouch messages