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).

It is also possible to specify the delta value as a (14 bit) MIDI pitch bend value between 0 and 16383 using the delta_midi: opt.
When using the delta_midi: opt no pitch bend is the value 8192

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