Mix
Select or interpolate between multiple inputs.
What it does
Mix picks or blends between any number of option inputs. Start with one and click the + socket to add more; images, colours, shapes, geometry, numbers and most other value types are accepted. Operation sets how the options combine: Index picks one by a numeric slot, Match picks the option whose value equals a probe, Boolean routes between exactly two options with a true/false switch, Sum adds every option together with an optional weighted average, and Additive blends per-target deltas from a base using a weight per target.
In Index mode, turning on Blend treats Index as a fractional value and cross-fades between the two adjacent options instead of hard-switching. On two matching shapes this travels between their outlines as a shape key; on two matching meshes it morphs the surface; on mismatched types, a shape and an image say, it blends through a shared distance field so the transition still reads as one shape becoming another.
When to use it
Switching between several ready-made looks or setups by a single index
Cross-fading or morphing between two shapes, meshes, colours or images as a value changes: a shape key, a colour transition, a state blend
Routing a value on a condition (Boolean), or picking the option matching a specific value (Match)
Combining several inputs additively: stacked deltas from a base, each with its own weight (Additive), or adding and averaging a set of inputs (Sum)
| Parameter | Type | Default | What it does |
|---|---|---|---|
operation | String | "Index" | Selection mode. One of: Index, Match, Boolean, Sum, Additive. |
index | Number | 0 | Index of input to select (fractional values blend when blend is on) |
match_value | Any | — | Value to match against inputs |
condition | Boolean or Number | — | If true, select first option; if false, select second option |
blend | Boolean | false | Interpolate between adjacent options (off = discrete switch) |
factor | Curve | — | Easing curve for blend interpolation (connect a Curve node) |
blend_placement | Boolean | true | Shape-key: also interpolate placement (position/rotation/scale) so the shape travels between the two; off morphs the outline in place |
weights | Number[] | — | Per-target weights as NumberArray. weights[0] controls option_1's blend, etc. |
master_weight | Number | 1 | Master weight applied to the summed output |
normalize | Boolean | false | Divide sum by number of inputs (produces weighted average) |
n_options | Number | 0 | Number of options (0 = dynamic) |
strength | Number | 1 | Effect strength / wet-dry (0 = no effect, 1 = full). Editable, wirable, keyframable. |
Gotchas
Match compares whole option values, not indices. It selects the first option whose value equals Match Value, and falls back to the first option when nothing matches.
Blend Placement affects the shape-key case only, blending between two matching shapes. It has no effect on meshes, images or other option types.
In Additive mode, weights is offset by one: weights[0] controls the second option (option_1), not the first. The first option is always the unweighted base that the others blend deltas onto.
Worked example
Add a Mix node. Wire two images into the option sockets (click
+to add the second).Set Operation to Index and turn on Blend.
Animate Index from 0 to 1 to cross-fade smoothly between the two images.
Switch Operation to Boolean and wire a condition to snap-switch between them instead of blending.
See also
Conditional · Hold · Fit · Rasters (images)