Linear Smoother (Flowgraph Node)

Overview

• Node Name: Linear Smoother
• Category: simple
• File: extensions/flowgraph/nodes/math/smoothers/linear.lua

Provides linear temporal smoothing for a numeric signal with configurable up/down rates.

Pin Schema

Input Pins

Output Pins

Internals

How It Works

1. On execution start, a newTemporalSmoothing() object is created.
2. If the set pin changes, the smoother's internal state is directly set to that value.
3. If no value input is provided, the current smoother state is output unchanged.
4. Otherwise, the rate is selected based on direction (increasing → upRate, decreasing → downRate, default 1).
5. The smoother is updated via getWithRateUncapped(sample, dt, rate) - linear interpolation without capping.

Lua Example

-- Smooth a throttle input:
-- value = raw throttle (0-1)
-- dt = frame delta time
-- upRate = 2 (fast response up)
-- downRate = 5 (slower release)
-- Output: smoothed throttle value

Key Dependencies

• newTemporalSmoothing() - BeamNG temporal smoothing primitive
• ui_imgui - displays smoother state in the node editor
• _flowgraph_createNode() - standard flowgraph node registration

Additional Methods

C:_executionStarted()

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

C:checkSetValue()

Node method.

C:drawMiddle(builder, style)

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

Parameters:

• builder
• style

C:init()

Initializes the node, setting up pins and default properties.

C:work()

Main work function called each frame/tick when the node is active.

See Also

• Nonlinear Smoother (Flowgraph Node) - Related reference
• Sigmoid Smoother (Flowgraph Node) - Related reference
• Spring Smoother (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide