Documentation Wiki rss-feed

MIDI Input


Name

MIDI Input:

1215 116
midi input

Description

The MIDI Input Agent is used to process incoming external MIDI messages for use within EigenD.

Ports

Activation output

  • Name:

1435 125
activation output

  • Output
  • Type: Generic

The activation output is normally used to send activation data to downstream Agents.

Continuous Controller output

  • Name:

1472 1775 125
continuous controller output

  • Output
  • Type: Generic

The continuous controller output is normally used to send MIDI Continuous Controller data to downstream Agents.

MIDI output

  • Name:

1215 125
midi output

  • Output
  • Type: Generic

The MIDI output is normally used to send MIDI data to downstream Agents.

MIDI clock output

  • Name:

1215 8771 125
midi clock output

  • Output
  • Type: Generic

The MIDI clock output is normally used to send incoming MIDI clock data to downstream Agents (usually the Metronome in this case).

Nouns

MIDI Port:

A MIDI port within the MIDI Input Agent is the virtual object within EigenD which corresponds to the operating system's available MIDI ports. These can be browsed using the EigenBrowser - please see example below.

Continuous Controller:

A Continuous Controller within EigenD refers to the object within EigenD used to talk about the incoming MIDI continuous controller values and their associated function. The values associated with them can either be a value between 0 and 127, or you can refer to the controller function by name - a full list of available MIDI CCs can be found here. You can calibrate or invert the incoming values using the examples below, or connect them to Ports within EigenD.

K:

K within EigenD is a virtual object used to refer to an incoming MIDI note number. This is a value between 0 and 127 which corresponds to the desired note number. This value within EigenD can be used to trigger Talker events or connected to other Ports.

Verbs

Choose:

122
choose

The 'choose' verb is used to select a MIDI port for MIDI input to EigenD from the EigenBrowser.

Invert:

411
invert

The 'invert' verb is used to invert the sense of the incoming MIDI data.

Minimise:

1152
minimise

The 'minimise' verb is used to calibrate the incoming MIDI data. Set the incoming MIDI device to produce its lowest value before using the 'minimise' verb.

Maximise:

1153
maximise

The 'maximise' verb is used to calibrate the incoming MIDI data. Set the incoming MIDI device to produce its highest value before using the 'maximise' verb.

Examples

Before using the Belcanto examples below, please make sure that you have the desired MIDI Input Agent in the conversation using:

1215 116 ? 1131
midi input X listen

where X is the number of the desired MIDI Input Agent.

Browsing the MIDI input port

To browse a MIDI input port in the EigenBrowser, making sure you have the EigenBrowser open, use

8777 8716 1215 116 ? 5
eigenbrowser , midi input X hey

1215 1822 413
midi port browse

where X is the number of the desired MIDI input Agent.

Choosing a MIDI input port from the EigenBrowser

To choose a MIDI input port which is currently selected in the EigenBrowser, making sure you have the EigenBrowser open, use

8777 8716 1215 116 ? 5
eigenbrowser , midi input X hey

414 122
selection choose

Inverting incoming MIDI data

To invert the sense of incoming MIDI continuous controller data, use

1472 1775 ? 411
continuous controller X invert

where X refers to the incoming continuous control value.

Set the maximum value of incoming MIDI continuous controller data

To calibrate the upper bound of incoming MIDI, use:

1472 1775 ? 1153
continuous controller X maximise

where X refers to the incoming continuous control value.

Set the minimum value of incoming MIDI continuous controller data

To calibrate the lower bound of incoming MIDI data, use:

1472 1775 ? 1152
continuous controller X minimise

where X refers to the incoming continuous control value.

See also