Link Search Menu Expand Document

Mapping utilities

These processes route, combine and trigger control values. They do not process audio samples; use Audio utilities for audio buses.

Spigot

Passes Input events to Output only while Enabled is on. Closed means no new output event, not an output value of zero.

Repeat

Retains the last valid Input and emits it continuously on Output while executing. This converts a sporadic message into a continuously available control value.

Mux inlets

Set Input count, connect values to the generated inputs, then choose the zero-based Current index to select the value sent to Output. Keep the index within the available input count.

Demux outlets

Set Output count and select the zero-based Current index. The Input value is assigned to that outlet. For routing by exact value rather than by index, use Switch.

Counter

Each message to Increase increments the counter. Count reports it; Ceiling signals when the internal count reaches or exceeds Max. Mode is Free, Clip, Wrap or Fold, shaping the reported count relative to Max. Reset returns the internal counter to zero; Output requests the current shaped value without incrementing. Send selects EveryTick, OnInput or Manually. In manual mode, Reset changes state without sending Count until Output is triggered.

Value Mixer

Input count creates numeric inputs with individual Mix, Solo and Mute controls. A solo selects the soloed group; muting still excludes a soloed input. Output is the selected combination:

  • Mix averages the gain-scaled active inputs by active input count.
  • Weight divides their weighted sum by the sum of weights.
  • Min, Max, Multiply and Sum combine gain-scaled values accordingly.
  • Difference returns the negative sum of the active gain-scaled inputs.
  • AltSum adds even-indexed inputs and subtracts odd-indexed inputs.

Use Multi-choice instead to select one confident winner, rather than mixing its value.

Impulse

Converts each Message into an Impulse. Skip false-y values suppresses zero, false, empty strings and empty containers; an incoming impulse still triggers.

Bang

Press Bang to send one event on Impulse. This is useful for manually requesting output from Buffer queue or Counter.

Button

Hold Hold to send an Impulse every processing tick while pressed. Unlike Bang, it repeats for the duration of the press. A connected impulse acts as a one-tick press, not a latched toggle.

Flip Flop

Each received Input toggles the boolean state. Output continuously reports the state, initially false.

Repetition Filter

Passes the first Input, then only values different from the previous input to Output. Use it to suppress repeated values before an event-driven destination.

Basic value sources

Integer

Emits the integer Value setting on Integer while executing.

Float

Emits the numeric Value setting on Out while executing.

String

Emits the text in Value on Out while executing.

More mappings