ctlin
From Pdpedia
| {{{example_image}}} caption | |
| Description: | MIDI control in |
|---|---|
| Abbreviation: | |
| Library: | vanilla |
| Author(s): | Miller S. Puckette and others |
| Developer(s): | |
| Release version: | |
| Release date: | 2007 |
| Status: | active |
| Dependencies: | |
| License: | BSD |
| Website: | http://crca.ucsd.edu/~msp/software.html |
| Programming Language: | |
| Platform(s): | GNU/Linux, Mac OS X, Windows |
| Language: | English |
| Data type(s): | message |
| Distribution(s): | DesireData, PDa, Pd-extended, Pd-vanilla, puredata debian package, pure:dyne |
ctlin listens for MIDI control messages from the configured MIDI ports and supplies the resulting values through its outlet. It is useful for monitoring knobs, sliders, and other continuous MIDI controller devices.
See also: ctlout, midiin, notein
Contents |
[edit] Inlets
ctlin has no inlets, and reads directly from the configured MIDI ports.
[edit] Outlets
ctlin has three outlets when supplied no arguments. The first produces a number corresponding to the control value received. Values will range between 0 and 127. The second, middle, outlet outputs the controller number. The third, right-most outlet produces the channel number on which the value was received.
If one argument is supplied to ctlin, it only has two outlets -- the first for controller value, and the second for channel number. If two arguments are supplied, it only has one outlet, which gives the controller value, and is updated whenever a MIDI control message is received that matches the filters applied by the arguments.
[edit] Arguments
ctlin has two possible arguments, both optional. The first is the controller number to listen for, and may be supplied a wildcard ("*") argument. The second is the MIDI channel number to listen on, and defaults to listening on all channels. If neither argument is supplied, ctlin listens for all controller data on all channels.
