Spring Smoother (Flowgraph Node)

Overview

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

Provides spring-damper temporal smoothing for a numeric signal, with separate spring/damp parameters for increasing and decreasing directions.

Pin Schema

Input Pins

Output Pins

Internals

How It Works

1. On init, a smoothing object is created (note: uses newTemporalSigmoidSmoothing which supports spring-damp via getWithSpringDamp).
2. If the set pin changes, the smoother state is directly set.
3. If no value is provided, the current state is output.
4. Otherwise, spring and damp parameters are selected based on direction.
5. The smoother uses getWithSpringDamp(sample, dt, spring, damp) - physics-based spring-damper smoothing that can overshoot.

Spring smoothing produces natural-feeling motion with potential oscillation, unlike the other smoothers which are monotonic.

Lua Example

-- Bouncy camera follow height:
-- value = target height
-- dt = frame delta time
-- upSpring = 10, upDamp = 0.5 (bouncy upward)
-- downSpring = 8, downDamp = 0.8 (less bouncy downward)

Key Dependencies

• newTemporalSigmoidSmoothing() - used for its getWithSpringDamp() method
• 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
• Nonlinear Smoother (Flowgraph Node) - Related reference
• Sigmoid Smoother (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide