// perf_json.h -- the performance measurements as JSON, shared by the two
// remote surfaces that report them: the DAP server's x16/perfStats and
// x16/perfConfig (debug_server.c) and the RRDC control port's GET and POST
// /perf (control_backend_perf.c). One builder each, so a field means the same
// thing whichever way a client asked. Needs cJSON: built with HAS_DAP.
#ifndef PERF_JSON_H
#define PERF_JSON_H

#include <stdbool.h>
#include <stddef.h>
#include <cjson/cJSON.h>

#include "perf_budget.h"

#ifdef __cplusplus
extern "C" {
#endif

cJSON *perf_json_stat(const perf_stat_t *s);
// "30s", "session" (seconds <= 0).
void   perf_json_window_name(float seconds, char *out, size_t outsz);
// A number of seconds, or a name as perf_json_window_name gives it.
float  perf_json_window_seconds(const cJSON *item);
// One statistics window, as perfStats' windows[] entry; NULL if the window
// could not be computed (profiling off).
cJSON *perf_json_window(float seconds);
cJSON *perf_json_budget(void);
cJSON *perf_json_frame(const perf_frame_t *f);
// VERA's bus for the last completed frame; `lines` adds each active line's
// clocks (480 numbers).
cJSON *perf_json_bandwidth(void);
cJSON *perf_json_bandwidth_lines(void);
// The sprite renderer's time for the last completed frame (sprite_trace);
// {"enabled":false} while tracing is off. `lines` adds each line's budget used.
cJSON *perf_json_sprites(bool lines);

#ifdef __cplusplus
}
#endif

#endif