Send MIDI pitch bend message

midi_pitch_bend  delta (float01)

Sends a MIDI pitch bend message to all connected devices on all channels. Use the port: and channel: opts to restrict which MIDI ports and channels are used.

Delta value is between 0 and 1 with 0.5 representing no pitch bend, 1 max pitch bend and 0 minimum pitch bend.

Typical MIDI values such as note or cc are represented with 7 bit numbers which translates to the range 0-127. This makes sense for keyboards which have at most 88 keys. However, it translates to a poor resolution when working with pitch bend. Therefore, pitch bend is unlike most MIDI values in that it has a much greater range: 0 - 16383 (by virtue of being represented by 14 bits).

MIDI 1.0 Specification - Channel Voice Messages - Pitch Bend Change

Introduced in v3.0

Examples

# Example 1

midi_pitch_bend 0 



#=> Sends MIDI pitch bend message with value 0 to all ports and channels



# Example 2

midi_pitch_bend 1 



#=> Sends MIDI pitch bend message with value 16383 to all ports and channels



# Example 3

midi_pitch_bend 0.5 



#=> Sends MIDI pitch bend message with value 8192 to all ports and channels



# Example 4

midi_pitch_bend delta_midi: 8192 



#=> Sends MIDI pitch bend message with value 8192 to all ports and channels



# Example 5

midi_pitch_bend 0, channel: [1, 5] 



#=> Sends MIDI pitch bend message with value 0 on channel 1 and 5 to all ports