smoothed_port.hpp

Go to the documentation of this file.

// sbl/dsp/primitives/smoothed_port.hpp — A port's target, its smoother and its last value
//
// The pattern every widget hand-expanded (RPT-035 F2): a setter stores a
// target, process() advances a smoother toward it by the block length, and
// the smoothed value is what the widget applies. Setters only store, so a
// setter and process() can run in different contexts.
 
#ifndef SBL_DSP_PRIMITIVES_SMOOTHED_PORT_HPP_
#define SBL_DSP_PRIMITIVES_SMOOTHED_PORT_HPP_
 
#include <cstdint>
 
#include <sbl/dsp/primitives/parameter_smoother.hpp>
 
namespace sbl::dsp::primitives {
 
class SmoothedPort {
public:
    /// @note All public methods are ISR-safe — bounded computation, no I/O.
 
    /// Settling time, at the rate the smoother is advanced at (per sample here).
    void set_time_ms(float ms, float rate_hz) { smoother_.set_time_ms(ms, rate_hz); }
 
    /// The port's setter stores here; nothing moves until advance().
    void set(float target) { target_ = target; }
    float target() const { return target_; }
 
    /// Advance by a block: the smoothed value to apply for this block.
    float advance(uint16_t n) {
        value_ = smoother_.process_steps(target_, n);
        return value_;
    }
 
    float value() const { return value_; }
 
    /// Snap to the target: what reset() does, so ports start where they were set.
    void reset() {
        smoother_.reset(target_);
        value_ = target_;
    }
 
private:
    ParameterSmoother smoother_;
    float target_ = 0.0f;
    float value_ = 0.0f;
};
 
} // namespace sbl::dsp::primitives
 
#endif // SBL_DSP_PRIMITIVES_SMOOTHED_PORT_HPP_