motion_cost.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/view/motion.hpp>
 
#include <cstdint>
#include <functional>
#include <memory>
#include <string>
#include <vector>
 
namespace pulp::view::motion {
 
// ── CostSample ───────────────────────────────────────────────────────
 
constexpr int kCostSchemaVersion = 1;

struct CostSample {
    std::uint64_t frame = 0;
    double t_seconds = 0.0;

    double render_pass_duration_ms = 0.0;

    double dirty_rect_area_px = 0.0;

    int dirty_rect_count = 0;

    std::vector<int> active_trace_ids;

    std::vector<Provenance> active_provenance;
};
 
// ── CostProbe ────────────────────────────────────────────────────────

struct RenderCostSnapshot {
    double render_pass_duration_ms = 0.0;
    double dirty_rect_area_px = 0.0;
    int dirty_rect_count = 0;
};
 
using CostProbe = std::function<RenderCostSnapshot()>;
 
// ── CostAttributor ───────────────────────────────────────────────────

class CostAttributor {
public:
    using CostSink = std::function<void(const CostSample&)>;
 
    static CostAttributor& instance();

    void set_enabled(bool on);
    bool enabled() const noexcept;

    void set_probe(CostProbe probe);

    int add_sink(CostSink sink);
    void remove_sink(int sink_id);
    void clear_sinks();

    void reset();

    std::size_t emitted_sample_count() const noexcept;
 
private:
    CostAttributor();
    ~CostAttributor();
    CostAttributor(const CostAttributor&) = delete;
    CostAttributor& operator=(const CostAttributor&) = delete;
 
    friend class Coordinator;

    void note_tick_begin(std::uint64_t frame, double t_seconds);
    void note_trace_activity(int trace_id);
    void note_provenance(int trace_id, const Provenance& prov);
    void emit_frame();
 
    struct State;
    std::unique_ptr<State> state_;
};
 
// ── JSONL cost sink ──────────────────────────────────────────────────

CostAttributor::CostSink make_cost_sink(std::string path);

CostAttributor::CostSink make_cost_buffer_sink(std::vector<CostSample>* buffer);

std::string serialize_cost_sample(const CostSample& s);

std::vector<CostSample> load_cost_stream(const std::string& path);
 
} // namespace pulp::view::motion