Documentation Wiki rss-feed

Summer


Name

Summer:

image:summer_expanded.png

1183
summer

Description

The Summer Agent is used to sum together signals within EigenD. It is normally inserted between the Gain Agent and the Console Mixer Agent in normal use within EigenD.

This agent can both be used to sum wires in the same bundle together, for example when an oscillator sends out different data streams based on polyphony, but also to sum separate bundles together. The latter can be done by differentiating the bundles during the connection to the summer by specifying a 'using' ordinal.

Note, that certain other agents like Audio Unit only use the first signal in an audio bundle, a summer needs to be inserted beforehand to ensure that all audio buffer signals are summed together before being sent to the audio unit.

Ports

Audio input

  • Name:

1118 116
audio input

  • Input
  • Type: Numeric
  • Range: -1 to 1

The audio input is used to receive audio data from upstream Agents. If the channel count is set to 2, then there are two audio input ports, labelled 'left audio input 1' and 'right audio input 2' (see 'Channel Count' below).

Audio output

  • Name:

1118 125
audio output

  • Output
  • Type: Numeric
  • Range: -1 to 1

The audio input is used to send audio data to downstream Agents. If the channel count is set to 2, then there are two audio output ports, labelled 'left audio input 1' and 'right audio output 2' (see 'Channel Count' below).

Nouns

Channel Count:

The channel count is a value set by the user to determine the number of audio input and output channels that the Summer Agent requires. This depends on whether the Agent upstream produces a mono or stereo output - it is mono by default (therefore one audio input and one audio output).

Verbs

None

Examples

Before using the Belcanto examples below, please make sure you have the desired Summer in the conversation using

1183 ? 1131
summer X listen

where X is the number of the desired Summer Agent.

Setting the channel count

To set the channel count, use

1122 458 23 ? 67
channel count to X set

where X is the desired channel count.

See also