Flow Interval / Rate Limit (Flowgraph Node)

Overview

• Node Name: Flow Interval
• Category: logic
• File: extensions/flowgraph/nodes/logic/rateLimit.lua

Lets flow through at a regular time interval. Fires instantly the first time, then throttles subsequent flow to the configured frequency or duration.

Pin Schema

Input Pins

Output Pins

Legacy Pin Mapping

Behavior

• init() - Resets timer and previous frequency tracker.
• _executionStarted() - Resets timer state.
• work() - Decrements internal timer by dt each frame. When the timer reaches 0, outputs a flow impulse and resets the timer. If asDuration is true, timer is set to the input value directly; otherwise it's set to 1/frequency. Reset pin or frequency change restarts the cycle.

How It Works

The node maintains an internal countdown timer. Each frame it subtracts the delta time. When the timer hits zero, it emits a flow pulse and reloads the timer. The reverseHit flag controls whether the first pulse happens immediately (false) or after the first full interval (true).

The middle of the node displays a progress bar showing time remaining in the current cycle.

Example Usage

-- Emit flow every 2 seconds:
-- input = 0.5 (0.5 Hz = every 2 seconds)

-- Or using duration mode:
-- asDuration = true
-- input = 2 (fire every 2 seconds)

-- Rate-limit an expensive check to 10 times per second:
-- input = 10 (10 Hz)
-- Connect the check logic to the output

Additional Methods

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