xmidiin Reference

Output raw MIDI data

xmidiin

Description

Listens to a specified MIDI port and output the raw MIDI data received.

Arguments

port [symbol]

Optional

Specifies the port (a-z) from which to receive incoming MIDI messages. If there is no argument, xmidiin receives from port a (or the first input port listed in the MIDI Setup dialog.)

device [symbol]

Optional

The name of a MIDI input device may be used as the first argument to specify the port. The name 'all' can be used to enable the reception of MIDI messages from any port. The name 'none' can be used to prevent the object from receiving MIDI messages from any port.

Attributes

matchport [int] (default: 0)

If the port argument doesn't match an existing port or device name, set the object's MIDI port to 'none'.

name [symbol]

Set the object's MIDI port based on a device name. The attribute will attempt to do a case-sensitive partial string match based on the attribute's value.

Common Box Attributes

Messages

anything

Arguments

port [list]
Performs the same functions as port.

(mouse)

Double-clicking on a xmidiin object shows a pop-up menu for choosing a MIDI port or device.

(MIDI)

The xmidiin object receives all MIDI messages from a MIDI input device.

lastport

The word lastport will report the name of the device which most recently sent MIDI bytes through the xmidiin object from the rightmost outlet, if present.

port

Arguments

port [symbol]
The word port, followed by a letter a- z or the name of a MIDI input port or device, sets the port from which the object receives incoming MIDI messages. The word port is optional and may be omitted. The name 'all' can be used to enable the reception of MIDI messages from any port. The name 'none' can be used to prevent the object from receiving MIDI messages from any port.

Output

int

All MIDI messages received from the specified port are sent out the left outlet, byte-by-byte. Note that xmidiin does not "clean up" any use of running status in the incoming MIDI stream.

list

The right outlet will report the name of the actively-sending MIDI device, formatted as port <portname>. This is particularly useful when the port name 'all' is in use.

The device name will only be sent once, each time when the sending device changes (just previous to the first byte from the new sender), or when the lastport message is sent to the object.

See Also

Name Description
midiin
midiformat
midiinfo
midiformat
midiparse
mpeconfig
mpeformat
mpeparse
noteout
polymidiin
sxformat
xbendout
xnoteout
rtin
sysexin
xnotein
xbendin
Max MIDI Tutorial 1: Basic MIDI Max MIDI Tutorial 1: Basic MIDI