Merge

A configurable many-to-one router with nearest or linear selection across as many as eight inputs.

What it does #

Merge places up to eight inputs along a selection axis and sends one input, or a blend of two neighboring inputs, to a single output. Normalize makes the full axis run from 0 to 1 regardless of input count, while Wrap connects the end of the list back to the beginning.

Controls and ports #

Control	Label	Official description
select	Select	Controls which in port(s) are sent to the output
inputs	Inputs	Number of in ports provided
interpolation	Interpolation [nearest or linear]	Whether only one in port is used at a time (nearest), or a blend of two adjacent ports is used (linear)
wrap	Wrap	Offsets the range so that a high Select value wraps around to in port 1, etc.
normalize	Normalize	Uses a Select signal range of '0' to '+1', regardless of the in port count

Practical uses #

• Scan through oscillator waves, chord tones, modulation shapes, or effect branches from one control signal.
• Use Linear mode for continuous timbral morphing between adjacent sources.
• Enable Wrap for cyclic sequencing or wavetable-like scans whose last position blends back into the first.

Things to know #

• Nearest uses one input at a time; Linear uses triangular weights so at most two adjacent inputs contribute.
• Normalize changes the coordinate system rather than the source signals: the complete list fits into a 0-to-1 Select range.
• Without Normalize, Select is expressed in input-index units.
• Wrap makes the axis periodic and allows a linear blend between the last and first inputs.
• Exact negative and endpoint boundary behavior should be tested before using it for sample-accurate logic.

Technical details #

A high-confidence Nitro implementation candidate supports the technical summary, but the visible-module mapping remains inferred.

The exact grid/mix/merge body supports up to eight inputs. In Linear mode its coordinate is (count-1)*x for normalized non-wrap, count*fract(x) for normalized wrap, x for raw non-wrap, or count*fract(x/count) for raw wrap. It applies weights max(0,1-|y-index|) and adds the weighted inputs, with an extra wrapped copy of the first position at index count. Nearest mode selects floor(count*x) when normalized or floor(x) otherwise, applies modulo when Wrap is on, and upper-clamps to the final active input. A separate output reports selection levels for the module display.

Nitro port	Type
count	InputValuePortType
interpolation	InputValuePortType
wrap	InputValuePortType
normalize	InputValuePortType
x	InputAudioPortType
in	InputAudioPortType
out	OutputAudioPortType
outLevels	OutputAudioPortType

Open questions #

• Measure all Nearest boundaries, especially normalized x=1, half-step ownership, negative Select, and out-of-range non-wrap values.
• Verify count changes, disconnected inputs, stereo interpolation, smoothing, and audio-rate Select modulation.
• Test Wrap periodicity and Linear endpoint weights against the recovered coordinate equations.

Version and sources #

Checked against Bitwig Studio 6.0.6. This page combines Bitwig's module metadata, the existing Grid course and guides, and Nitro analysis where the mapping is strong enough to support a technical statement.

Related material #

• Grid Modules course reference

Return to Bitwig Grid Modules or the Grid Modules course lesson.