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

ctlin Reference

MIDI controller input

ctlin

Examples

Arguments

controller [number]

Optional

In the second inlet, a number will describe the controller number that the ctlin object is to receive. This number can also be given as the first argument to ctlin. A value of -1 will result in ctlin receiving all controller numbers.

channel [number]

Optional

In the third inlet, a number will describe the MIDI channel that the ctlin object is to receive. This number can also be given as the second argument to ctlin. A value of -1 will result in ctlin receiving all channels.

Inlets

input [number]

ctlin receives its input from a MIDI control change message received from a MIDI input device.

controller [number]

In the second inlet, a number will describe the controller number that the ctlin object is to receive. This number can also be given as the first argument to ctlin. A value of -1 will result in ctlin receiving all controller numbers.

channel [number]

In the third inlet, a number will describe the MIDI channel that the ctlin object is to receive. This number can also be given as the second argument to ctlin. A value of -1 will result in ctlin receiving all channels.

Outlets

value [number]

Out left outlet: The number is the control value of an incoming MIDI control change message.

outcontroller [number]

Out middle outlet: The number is the controller number of the incoming MIDI control change message.

outchannel [number]

Out right outlet: The number is the channel number of the incoming MIDI control change message.

Dynamic Attributes

These attributes can be modified in the code during execution using the set object

channel [number]

In the third inlet, a number will describe the MIDI channel that the ctlin object is to receive. This number can also be given as the second argument to ctlin. A value of -1 will result in ctlin receiving all channels.

controller [number]

In the second inlet, a number will describe the controller number that the ctlin object is to receive. This number can also be given as the first argument to ctlin. A value of -1 will result in ctlin receiving all controller numbers.

input [number]

ctlin receives its input from a MIDI control change message received from a MIDI input device.

See Also

Name Description
midiin Output raw MIDI data
pgmin Receive MIDI program changes
ctlout Transmit MIDI controller messages
pgmout generate MIDI program change messages
midiin MIDI input stream
touchin MIDI channel pressure input