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

xbendin

Interpret extra precision MIDI pitch bend values

Description

xbendin serves as a 14-bit pitch bend filter/processor and xbendin2 serves as a 2-byte pitch bend filter/processor.

Arguments

Name Type Opt Description
MIDI-channel int opt The number specifies a MIDI channel on which to recognize pitch bend messages. If there is no argument, xbendin recognizes pitch bend messages on all channels, and the channel number is sent out the extra outlet on the right.
xbendin2 symbol opt Normally, xbendin sends pitch bend values out the left outlet as 14-bit values. If the object is called xbendin2, however, there will be an additional outlet. The most significant data byte of the message is sent out the leftmost outlet, and the least significant data byte is sent out the second outlet.

Messages

int MIDI-input [int]
The numbers are individual bytes of a MIDI message stream, received from an object such as midiin or seq. MIDI pitch bend messages are recognized by xbendin, and the pitch bend data is sent out in full precision.

Information for box attributes common to all objects

Output

int: The pitch bend value is sent out the left outlet of xbendin as a single 14-bit value. If the object is called xbendin2, there is an additional outlet. The most significant 7 bits are sent out the leftmost outlet, and the least significant (extra precision) 7 bits are sent out the second outlet. If there is no channel number specified as an argument (omni on), xbendin will have an extra outlet on the right, which will output the channel number of the incoming pitch bend message.

Examples

Pitch bend values are sent out as a single number or as two separate bytes

See Also

Name Description
bendin Output received MIDI pitch bend values
midiin Output received raw MIDI data
xbendout Format extra precision MIDI pitch bend messages