A newer version of Max is available. Click here to access the latest version of this document.

xbendout

Format extra precision MIDI pitch bend messages

Description

xbendout only changes the most significant byte of the pitch bend message. However, using xbendout with midiout, you can send messages which change both bytes. xbendout2 allows you to send the pitch bend data as two bytes from 0-127.

Arguments

Name Type Opt Description
xbendout2 symbol If the object is called xbendout2, there will be three inlets. The most significant byte of the pitch bend message is received in the left inlet, and the least significant (extra precision) byte is received in the middle inlet.
MIDI-channel int opt The number sets an initial value for the MIDI channel of the pitch bend messages. If there is no argument, the initial channel number is 1.

Messages

bang Sends out a MIDI pitch bend message using the numbers currently stored in xbendout.
int 14bit-pitch-bend-value [int]
In left inlet: The number is a 14-bit pitch bend value to be formatted into a complete MIDI pitch bend message by xbendout.
  (inlet1) MIDI-channel [int]
In right inlet: The number is stored as the MIDI channel for the pitch bend message sent out by xbendout. Channel numbers greater than 16 will be wrapped around to stay within the 1-16 range.
  (inlet2) MIDI-channel [int]
The number is stored as the MIDI channel for the pitch bend message sent out by xbendout. Channel numbers greater than 16 will be wrapped around to stay within the 1-16 range.
list 14bit-pitch-bend and MIDI-channel [list]
The first number is a 14-bit pitch bend value, and the second number is the channel. Both numbers are stored and are formatted into a MIDI pitch bend message which is sent out the outlet.

Information for box attributes common to all objects

Output

int: When a pitch bend value is received in the left inlet, the complete MIDI pitch bend message is sent out the outlet, byte-by-byte.

Examples

14-bit pitch bend value is formatted into a MIDI message which is sent out byte-by-byte

See Also

Name Description
bendout Transmit MIDI pitch bend messages
midiout Transmit raw MIDI data
xbendin Interpret extra precision MIDI pitch bend values