Select stream

Selects one stream from multiple input streams based on a numeric index.

Use this when

• You want to dynamically switch between input sources at runtime (e.g. camera, file, synthetic feed).
• You are building fallback or failover logic where the active source changes based on system state.
• You need routing based on an external selector signal.

What it does

Reads one UInt64 index and emits the next message from the indexed input stream. Index 1 with streams "apple" | "banana" | "cherry" selects "banana".

Inputs

Type	Description
UInt64	Zero-based index of the stream to forward.
t...	Candidate streams, all of the same type.

Outputs

Type	Description
t	One message from the selected stream per tick.

Parameters

This transformation takes no parameters.

Works best with

• A controller component that emits selection indices based on state or user input.
• Multiple alternate sources producing compatible-typed streams.

Caveats

• Indices outside the range of provided streams will fail at runtime.
• Non-selected streams still consume one message per tick unless you use stream-specific gating upstream.