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

midiinfo

Set a pop-up menu with names of MIDI devices

Description

When midiinfo receives a bang or integer in its left inlet, it sends a series of messages which will set up a pop-up menu to a list of MIDI output devices. You can connect the middle outlet of the menu to a MIDI output object to select MIDI devices by name. A number in midiinfo 's right inlet creates a list of MIDI input devices.

Arguments

None.

Messages

bang In left inlet: Same as int, but doesn't send a set message after setting the umenu items. The equivalent message to bang for retrieving input device names is -1 in the right inlet.
int menu-index [int]
 In left inlet: Causes midiinfo to send out a series of messages containing the names of the current MIDI output devices. Those messages can be used to set the individual items of a pop-up umenu object connected to the midiinfo object's outlet. The number received in the midiinfo object's left inlet is then sent in a set message to set the currently displayed umenu item. In right inlet: Causes midiinfo to send out a series of messages containing the names of the current MIDI input devices. Those messages can be used to set the individual items of a pop-up umenu object connected to the midiinfo object's outlet. The number received in the midiinfo object's right inlet is then sent in a set message to set the currently displayed umenu item, unless the number is less than zero, in which case no set message is sent.
controllers initial-menu-index [int]
 In left inlet: Causes midiinfo to send out a series of messages containing the names of all MIDI controllers (devices that transmit MIDI) in the current MIDI setup. Those messages can be used to set the individual items of a pop-up umenu object connected to the midiinfo object's outlet. The word controllers may be followed by a number, which sets the pop-up umenu to that item number after the menu items have been created.

Information for box attributes common to all objects

Output

append: Immediately after sending the clear message, midiinfo sends an append message for each MIDI input or output device name, to set the items of a connected umenu object. The device names will be sent out in the order in which they appear in Max's MIDI Setup dialog.
clear: midiinfo first sends a clear message out its outlet to clear all the receiving umenu object's items.
set: If the incoming message to midiinfo is an integer greater than or equal to zero, a set message is sent after the append messages, to set the currently displayed menu item.

Examples

Get output device names for MIDI output objects... and for MIDI input objects

See Also

Name Description
midiin Output received raw MIDI data
midiout Transmit raw MIDI data
umenu Pop-up menu, to display and send commands
Max MIDI Tutorial 1: Basic MIDI Max MIDI Tutorial 1: Basic MIDI