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

noteout

Transmit MIDI note messages

Description

noteout can be used to send note-on and note-off messages.

Arguments

Name Type Opt Description
MIDI-port (a through z) MIDI-port opt Specifies the port for transmitting MIDI note messages. Channel numbers greater than 16 received in the right inlet will be wrapped around to stay within the 1-16 range. If there is no argument, noteout initially transmits out port a, on MIDI channel 1.
MIDI-port (a through z) and MIDI-channel symbol and int A letter and number combination (separated by a space) indicates a port and a specific MIDI channel on which to transmit note messages. Channel numbers greater than 16 will be wrapped around to stay within the 1-16 range.
(MIDI name) symbol opt The name of a MIDI output device may be used as the first argument to specify the port.
MIDI-channel int A number alone can be used in place of a letter and number combination. The exact meaning of the channel number argument depends on the channel offset specified for each port in the MIDI Setup dialog.

Messages

int MIDI-pitch-value (0 through 127) [int]
 In left inlet: The number is the pitch value of a MIDI note message transmitted on the specified channel and port. Numbers are limited between 0 and 127.
  (inlet1) note-velocity (0 through 127) [int]
 In middle inlet: The number is stored as the velocity of a note message, to be used with pitch values received in the left inlet. Numbers are limited between 0 and 127. 0 is considered a note-off message, 1-127 are note-on messages.
  (inlet2) MIDI-channel-number [int]
 In right inlet: The number is stored as the channel number on which to transmit the note-on messages.
float MIDI-message-input [float]
 Converted to int.
anything MIDI-port (a through z) [list]
 Performs the same function as port but without need for the word, "port".
(mouse) Double-clicking on a noteout object shows a pop-up menu for choosing a MIDI port or device.
port MIDI-output-port (a through z) [symbol]
 In left inlet: The word port, followed by a letter a-z or the name of a MIDI output port or device, specifies the port used to transmit the MIDI messages. The word port is optional and may be omitted.

Information for box attributes common to all objects

Output

(MIDI): There are no outlets. The output is a MIDI note-on message transmitted directly to the object's MIDI output port.

Examples

Letter argument transmits to only one port... Otherwise number specifies both port and channel

See Also

Name Description
ctlout Transmit MIDI control messages
midiout Transmit raw MIDI data
notein Output received MIDI note messages
nslider Output numbers from a notation display onscreen
xbendout Format extra precision MIDI pitch bend messages
xnoteout Format MIDI note messages with release velocity
Max MIDI Tutorial 1: Basic MIDI Max MIDI Tutorial 1: Basic MIDI