state_inspector.hpp

Go to the documentation of this file.

// state_inspector.hpp — Parameter state monitoring and editing for the inspector
#pragma once
 
#include <pulp/dataplane/fwd.hpp>
#include <pulp/state/listener_token.hpp>
#include <pulp/state/parameter.hpp>
#include <pulp/state/store.hpp>
#include <pulp/view/value_channel_telemetry.hpp>
 
#include <chrono>
#include <mutex>
#include <span>
#include <string>
#include <vector>
 
namespace pulp::inspect {
 
using namespace pulp::state;

class StateInspector {
public:
    explicit StateInspector(StateStore& store);

    StateStore& store() const noexcept { return store_; }

    void set_value_channels(view::ValueChannelSet* channels);
    void set_value_channels(std::span<const view::ValueChannelInfo> channels) {
        value_channels_.assign(channels.begin(), channels.end());
    }
    std::span<const view::ValueChannelInfo> value_channels() const noexcept {
        return value_channels_;
    }
    ~StateInspector();
 
    StateInspector(const StateInspector&) = delete;
    StateInspector& operator=(const StateInspector&) = delete;

    struct ParamSnapshot {
        ParamID id;
        std::string name;
        std::string unit;
        float value;
        float normalized;
        float modulated;
        float default_value;
        float min, max, step;
        std::string display_value;  // from to_string, if available
    };

    struct ParamChange {
        ParamID id;
        float value;
        std::chrono::steady_clock::time_point time;
    };

    std::vector<ParamSnapshot> all_params() const;

    std::vector<ParamChange> recent_changes() const;

    bool set_param(ParamID id, float value, bool normalized = false);
 
private:
    StateStore& store_;
    std::vector<view::ValueChannelInfo> value_channels_;
    mutable std::mutex changes_mutex_;
    std::vector<ParamChange> changes_;
    ListenerToken listener_token_;
    static constexpr size_t kMaxChanges = 100;
};
 
} // namespace pulp::inspect