Split Mask Node
- Category: General
- Edition: All editions
- Output type: 2 to 100 masks
- Typical place in a graph: after a grass or texture mask, before several outputs that share it
Split Mask shares one mask out among several outputs by weight: each output gets the same shape, scaled to its share, and together they add up to the input. Use it to mix several grasses or flowers in one area at a fixed ratio, without the total density going up.

When to use it
- Mix grass species in one meadow: one density mask split among several Detail Density Output nodes.
- Share a texture weight between two similar layers, such as two grass textures.
- Not for: stacking layers that cover each other (use Weight Blend); splitting positions (use Split Positions).
Inputs
| Slot | Type | Required | What to connect |
|---|---|---|---|
| Input | Mask | Yes | The mask to share out. |
Outputs
| Slot | Type | What it holds |
|---|---|---|
| Output 1 to Output N | Mask | The input times that output's weight divided by the total weight. |
Properties
| Property | Default | Range | What it does |
|---|---|---|---|
| Output Count | 2 | 2 to 100 | The number of outputs. |
| Weight 1 to Weight N | 1 | 1 and up, whole numbers | Each output's share. Weights 3 and 1 give 75% and 25%. |
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) matches the mask connected to Input, times the multiplier below it. Relative To Graph follows the biome's Canvas Resolution instead. Absolute sets an exact size. 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 so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off. |
| Bypass | Skips the node. The input passes to the first output. |
Example
A Noise mask (average 0.374) split 3 ways with equal weights. Each output has the same pattern at a third of the strength (average 0.125, highest 0.23), as the image above shows.
Recipes
- Mixed meadow: grass mask → Split Mask (3 outputs, weights 6, 3, 1) → three Detail Density Output nodes: mostly one grass, some of a second, a few flowers.
Note
Each output has the same shape everywhere, only weaker, so the species mix evenly. For patches of one or the other, multiply the outputs by different Noise masks, or use Weight Blend.
Performance
Very cheap: one quick GPU step per output.
Related nodes
- Weight Blend: layers that cover each other.
- Split Positions: the same idea for positions.
For AI agents
- Type name:
SplitMaskNode. Input =0; outputs100+ i (Masks). - Property:
outputCount(2 to 100). Weights (1 to 1,000,000) are editor only (SetWeight; labels Weight 1..N). - Output i = input × weight_i / Σweights. Measured: 3 equal outputs of a mask with mean 0.374 gave mean 0.125 each.