Nonlinear Smoother (Flowgraph Node)

Overview

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

Provides nonlinear (exponential-style) temporal smoothing for a numeric signal with configurable up/down rates.

Pin Schema

Input Pins

Output Pins

Internals

How It Works

1. On init, a newTemporalSmoothingNonLinear() object is created.
2. If the set pin changes, the smoother's internal state is directly set.
3. If no value input is provided, the current smoother state is output.
4. Otherwise, the rate is chosen by direction (increasing → upRate, decreasing → downRate, default 1).
5. The smoother uses getWithRate(sample, dt, rate) - nonlinear (exponential decay) smoothing.

Unlike the linear smoother, this produces an asymptotic approach to the target value.

Lua Example

-- Smooth camera follow distance:
-- value = target distance
-- dt = frame delta time
-- upRate = 3 (pull back quickly)
-- downRate = 1 (zoom in slowly)
-- Output: smooth camera distance

Key Dependencies

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

Additional Methods

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:work()

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

See Also

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