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

sysexin Reference

Receive MIDI system exclusive messages

sysexin

Description

Receives MIDI system exclusive messages from a MIDI input device. It takes an optional argument for port selection. If a MIDI system exclusive message is received, sysexin outputs raw MIDI as integers.

Examples

Examine incoming System Exclusive messages

Arguments

port [symbol]

Optional

Specifies the port (a-z) from which to receive incoming MIDI system exclusive messages. If there is no argument, sysexin 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 function as port but without need for the word, "port".

(mouse)

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

(MIDI)

The sysexin object receives its input from a MIDI sysex message received from a MIDI input device.

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

MIDI system exclusive messages received from the specified port are sent out the outlet, byte-by-byte.

See Also

Name Description
MIDI MIDI
midiin
sxformat