Table of Contents

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.

The first of three outputs: the input's shape at a third of its strength

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.

For AI agents

  • Type name: SplitMaskNode. Input = 0; outputs 100 + 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.