Table of Contents

Color Blend Node

  • Category: General
  • Edition: All editions
  • Output type: Color texture
  • Typical place in a graph: after several region masks and before Albedo Output or another color node

Color Blend paints 1 to 100 solid colors from mask weights. Layers are evaluated from Layer 0 upward, so higher numbered layers cover lower ones wherever their masks are white.

Color Blend building a green, brown, and pale color map from two Noise masks

When to use it

  • Build an albedo color map from masks for grass, soil, rock, snow, or other regions.
  • Preview several terrain zones as clear colors while developing their masks.
  • Add a color accent over an existing base color with a soft gray transition.
  • Stack many independent mask and color pairs when later regions must cover earlier ones.
  • Not for blending existing color textures. Every layer paints one solid Color. Use Draw Mask Overlay or another color workflow when the foreground must be a texture.
  • Not for normalizing several competing weights. Use Weight Blend when the output should be weight maps rather than one color image.

Inputs

Slot Type Required What to connect
Layer 0 to Layer 99 Mask No A mask controlling how much of that layer's color is painted. Black leaves the current result unchanged, white uses the layer color, and gray blends between them. Layer Count controls how many slots exist.

An unconnected Layer 0 uses a white mask, so Color 0 fills the whole result and works as the base color. Every other unconnected layer uses black and has no effect.

Dynamic input slots cannot carry individual hover tooltips. Their matching Color fields and Layer Count explain the layer behavior in the properties panel.

Outputs

Slot Type What it holds
Output Color texture The final RGBA color image after every layer has been painted in index order.

Properties

Property Default Range What it does
Layer Count 2 1 to 100 Sets how many mask inputs and color fields the node shows. Raising it adds layers at the top of the stack. Lowering it removes the highest numbered slots and their connections.
Color 0 to Color 99 White RGBA color Sets the solid color painted by the matching layer mask. The color alpha is included in the blend.

Common properties

Property What it does
Id The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node.
Resolution How detailed this node's result is, in texels across the biome. Relative To Main Input (default) follows Layer 0 when it is connected; otherwise it falls back to the biome's Canvas Resolution. Relative To Graph follows Canvas Resolution. Absolute sets an exact size. Higher resolution keeps narrow mask edges sharp but costs more memory and one full image pass for every layer. Absolute is limited to 32 to 512 in Vista Personal and 32 to 4096 in Vista Indie and Pro.
Split Execution Lets this node run over several frames when Allow Split Execution is on in the graph settings. Color Blend paints all layers in one step, so splitting only adds a short pause around it; leave it off.
Bypass Skips the node. Color Blend does not pass a mask input into its color output, so Output is empty while bypass is on.

How layers are painted

Color Blend starts with a transparent black image, then processes the layers in order. Each layer performs this blend at every texel:

new color = blend(current color, layer color, mask value)

A mask value of 0 keeps the current color. A value of 1 replaces it with the layer color. Values between 0 and 1 make a soft transition. The red channel of each mask supplies the blend weight.

Graph wiring for a base color plus two masked colors

Layer order matters because each new layer blends over the result made by all earlier layers. A white value on Layer 2 completely covers Layer 0 and Layer 1 at that point.

Examples

The sample uses an unconnected Layer 0 as a full green base. A 360 meter Noise controls brown on Layer 1. A separate 160 meter Noise controls the pale color on Layer 2.

Two active layers

Green base blended with brown from Layer 1

With the Layer 2 source bypassed, its mask is empty and reads black. Only the green base and the broad brown mask remain.

Three active layers

Green, brown, and pale colors blended by three layers

Layer 2 adds the fine pale pattern over the first two colors. Its gray mask values blend rather than cut a hard boundary.

Changing the upper layer order

Brown on Layer 2 painting over the pale Layer 1 result

The masks stay connected to the same slots, but the brown color moves to Layer 2 and the pale color moves to Layer 1. Brown now wins wherever the Layer 2 mask is strong, showing why the highest layer is visually on top.

Recipes

  • Simple terrain color map: leave Layer 0 unconnected and set Color 0 to grass green; connect a slope mask to a gray rock layer; connect a height mask to a pale snow layer; send Output to Albedo Output.
  • Debug mask regions: assign clearly different colors to each mask so overlap and soft transitions are easy to see in the 2D viewport.
  • Biome accent: use the biome mask on a higher layer to tint only the area inside the Local Procedural Biome.
  • Hard regions: pass a mask through a steep Curve or Levels before Color Blend when you need a crisp boundary instead of a soft mix.
Tip

Leave Layer 0 unconnected when you want one dependable base color. Add regional masks from Layer 1 upward.

Note

Connecting Layer 0 changes resolution matching and removes its automatic white mask. Black areas of a connected Layer 0 reveal the initial transparent black image unless another layer covers them.

Warning

Lowering Layer Count deletes the removed slots and their edges. Undo immediately if you remove connected layers by mistake.

Performance

Color Blend performs one full image blend for every layer, including unconnected layers. Cost grows with both Layer Count and output resolution. Keep the count close to the number of colors you actually need, and use the lowest resolution that preserves the mask boundaries. Split Execution does not divide the layer loop over several frames.

  • Albedo Output: sends the finished color texture to terrain.
  • Gradient Map: maps one mask through a color gradient instead of stacking several solid colors.
  • Weight Blend: resolves competing masks into normalized terrain layer weights.
  • Draw Mask Overlay: overlays a color on an existing color texture through one mask.
  • RGBA Merge: packs four masks into the channels of one color texture.

For AI agents

  • Type name: ColorBlendNode; node search and graph commands use ColorBlend.
  • Dynamic input slot ids are 0 through layerCount - 1. Output = 100, ColorTexture.
  • Layer Count is clamped from 1 to 100. Changing the count rebuilds slots and can remove edges.
  • Use vista_graphitor_color_blend_set with the complete color list. The list length sets Layer Count and each item sets the matching color.
  • Colors accept hex strings such as #4C7A3D or RGBA arrays.
  • Processing order is Layer 0, Layer 1, and onward. Each step uses lerp(current, color, mask.r).
  • An empty Layer 0 uses white. Empty later layers use black.
  • Bypass produces no output because the mask input and color output types do not pass through.
  • Sample graph: Assets/_DocSamples/NodeGraphs/ColorBlendNode_Doc.asset.