Send MIDI note off message

midi_note_off  note (midi), release_velocity (midi)

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

Note and release velocity values can be passed as a note symbol such as :e3 or a number. Decimal values will be rounded down or up to the nearest whole number - so values between 3.5 and 4 will be rounded up to 4 and values between 3.49999… and 3 will be rounded down to 3. These values will also be clipped within the range 0->127 so all values lower then 0 will be increased to 0 and all values greater than 127 will be reduced to 127.

The release_velocity param may be omitted - in which case it will default to 127 unless you supply it as a named opt via the keys velocity: or vel_f:.

You may also optionally pass the release velocity value as a floating point value between 0 and 1 such as 0.2 or 0.785 (which will be mapped to MIDI values between 0 and 127) using the vel_f: opt.

MIDI 1.0 Specification - Channel Voice Messages - Note off event

Introduced in v3.0

Examples

# Example 1 

midi_note_off :e3





#=> Sends MIDI note off for :e3 with the default release velocity of 127 to all ports and channels

# Example 2 

midi_note_off :e3, 12 





#=> Sends MIDI note off on :e3 with velocity 12 on all channels

# Example 3 

midi_note_off :e3, 12, channel: 3 





#=> Sends MIDI note off on :e3 with velocity 12 to channel 3

# Example 4 

midi_note_off :e3, velocity: 100





#=> Sends MIDI note on for :e3 with release velocity 100

# Example 5 

midi_note_off :e3, vel_f: 0.8





#=> Scales release velocity 0.8 to MIDI value 102 and sends MIDI note off for :e3 with release velocity 102

# Example 6 

midi_note_off 60.3, 50.5





#=> Rounds params up or down to the nearest whole number and sends MIDI note off for note 60 with velocity 51

# Example 7 

midi_note_off :e3, channel: [1, 3, 5]





#=> Send MIDI note off on :e3 to channels 1, 3, 5 on all connected ports

# Example 8 

midi_note_off :e3, port: ["foo", "bar"]





#=> Send MIDI note off on :e3 to on all channels on ports named "foo" and "bar"

# Example 9 

midi_note_off :e3, channel: 1, port: "foo"





#=> Send MIDI note off on :e3 only on channel 1 on port "foo"