Select (Flowgraph Node)

Overview

• Node Name: Select
• Category: logic
• File: extensions/flowgraph/nodes/logic/select.lua

Selects a value from multiple choices based on which selection flow pin is active. Supports merge functions for combining multiple active selections.

Pin Schema

Input Pins

Additional select_N/value_N pin pairs are created via the Count property.

Output Pins

Data Properties

Behavior

• init() - Sets count to 1 and mode to first.
• work() - Iterates through all select pins. When flow is active and a select_N pin has flow, its corresponding value_N is passed to the merge function. If nothing is selected, output value is nil.
• updatePins(old, new) - Dynamically adds or removes select/value pin pairs.
• drawCustomProperties() - UI for adjusting count and selecting the merge function from fg_utils.sortedMergeFuns.any.

How It Works

The node provides a multiplexer pattern. Each slot has a flow trigger (select_N) and a data input (value_N). When a selection flow is active, the corresponding value feeds into the merge function. The merge function (from flowgraph/utils) determines how multiple simultaneous selections combine (first, last, sum, etc.).

If no flow pin is connected at the top, the last selected value persists.

Example Usage

-- Select between two camera modes:
-- select_1 = isFirstPerson flow, value_1 = "cockpit"
-- select_2 = isThirdPerson flow, value_2 = "chase"
-- Output value = whichever mode is active

-- With merge mode "first":
-- If both are active, the first matching value wins

Additional Methods

C:_executionStarted()

Called when graph execution starts. Used for initialization/reset.

C:_onDeserialized(res)

Called after the node is deserialized (loaded from file). Restores runtime state from saved data.

Parameters:

• res

C:_onSerialize(res)

Called when the node is serialized (saved to file). Returns data to persist.

Parameters:

• res

C:drawMiddle(builder, style)

Custom ImGui drawing in the middle section of the node in the editor.

Parameters:

• builder
• style

See Also

• And (Flowgraph Node) - Related reference
• Boolean Expression (Flowgraph Node) - Related reference
• Branch (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide