midiformat
Prepare data in the form of a MIDI message
Description
Numbers received in the inlets are used as data for MIDI messages. The data is formatted into a complete MIDI message (with the status byte determined by the inlet) and sent out the outlet as individual bytes.
Arguments
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.
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]
The value is formatted into a pitchbend message. Alternatively the bendout 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.
Outlets
midimessage [number]
MIDI messages are sent out as individual bytes, for transmission by the midiout object.
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 )
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]
The value is formatted into a pitchbend message. Alternatively the bendout 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.
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 | |
| 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 |