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

rtin Reference

Receive MIDI real time messages

rtin

Description

Receives and outputs MIDI real time messages transmitted from a specified MIDI input device.

Examples

MIDI real time messages can be used to synchronize Max with external events

Arguments

port [symbol]

Optional

Specifies the port (a-z) from which to receive incoming MIDI real time messages. If there is no argument, rtin 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 an rtin object shows a pop-up menu for choosing a MIDI port or device.

(MIDI)

The rtin object receives its input from a MIDI real-time message received from a MIDI input device.

port

Arguments

MIDI-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 real time messages (MIDI clock, start, stop, and continue) received from the specified port are sent out the outlet.

See Also

Name Description
MIDI MIDI
clocker
metro
midiin
seq