Documentation Wiki rss-feed

MIDI Input

Name

MIDI Input:

image:midi_input_expanded.png

1215 116
midi input

Description

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

Ports

Key output

  • Name:

114 125
key output

  • Output
  • Type: Key

The key output sends key press data to downstream Agents. The column and course will always be 1 and the row and key are set to the MIDI note number. Each note is also sent out on a dedicated wire, from 0 to 127.

Continuous controller output

  • Name:

1472 1775 125
continuous controller output

  • Output
  • Type: Number
  • Range: 0 to 1

The continuous controller output sends MIDI CC values to downstream Agents. Each continuous controller is sent out on a dedicated wire, from 0 to 127 and the continuous controller value will range from 0 to 1.

Trigger output

  • Name:

1143 125
trigger output

  • Output
  • Type: Key

The trigger output sends key data to downstream Agents as MIDI CC messages reach values 0 and 127. When the continuous controller reaches value 0, a key will be sent with column and course set to 0 and row and key set to the CC number. When the continuous controller reaches value 127, a key will be sent with column and course set to 1 and row and key set to the CC number. Each trigger is sent out on a dedicated wire, from 0 to 127, which can be used by the connection filtering mechanism.

Program change output

  • Name:

8756 8856 125
program change output

  • Output
  • Type: Key

The program change output sends key press data downstream Agents each time a program change message arrives. The column and course will always be 1 and the row and key are set to the program change number. Each program change is sent out on a dedicated wire, from 0 to 127, which can be used by the connection filtering mechanism.

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.

Key:

Key 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