mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 10:19:47 -04:00
Matthew Stanley
84ba185176
Use a bounded atomic snapshot and presenter-owned reset across all backends. Readers sort their own snapshots; report host API completion cadence. Add deterministic and concurrent reader/reset coverage.
60 lines
2.8 KiB
C
60 lines
2.8 KiB
C
#ifndef PSX_VIDEO_TELEMETRY_H
|
|
#define PSX_VIDEO_TELEMETRY_H
|
|
#include <stdint.h>
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
enum { PSX_VIDEO_NONE = 0, PSX_VIDEO_SOFTWARE = 1,
|
|
PSX_VIDEO_OPENGL = 2, PSX_VIDEO_VULKAN = 3 };
|
|
typedef struct PsxVideoTelemetry {
|
|
uint64_t presents, present_errors;
|
|
int valid, renderer, internal_scale, present_status_available;
|
|
int source_width, source_height;
|
|
int drawable_width, drawable_height;
|
|
int viewport_width, viewport_height;
|
|
} PsxVideoTelemetry;
|
|
|
|
/* Render-owner publication, before submission. These describe the latest
|
|
* composed image, which can lead actual swaps when presentation is threaded.
|
|
* Zero dimensions mean unavailable, not a zero-sized successful image.
|
|
* A backend has one composing owner at a time. No readbacks or GL syncs. */
|
|
void psx_video_telemetry_compose(int renderer, int scale, int source_w, int source_h,
|
|
int drawable_w, int drawable_h, int viewport_w, int viewport_h);
|
|
/* Call after the backend's swap/present API returns. A success means the host
|
|
* API accepted/completed the call, not that a monitor displayed correct pixels.
|
|
* Counts include repeats, overlays and generated frames. */
|
|
/* result: 1 accepted, 0 failed, -1 returned but API supplies no status (SDL2). */
|
|
void psx_video_telemetry_present(int result);
|
|
/* Bounded passive read: valid=0 if a coherent composition was unavailable.
|
|
* Completion/error counters remain available in that case. */
|
|
void psx_video_telemetry_snapshot(PsxVideoTelemetry *out);
|
|
|
|
typedef struct PsxPresentCadence {
|
|
int valid;
|
|
uint32_t count, mean_us, p50_us, p95_us, p99_us, max_us, hitches;
|
|
double span_ms, fps;
|
|
} PsxPresentCadence;
|
|
/* Host API completion intervals, shared by all backends; no monitor-display
|
|
* guarantee. Bounded passive snapshot. reset is consumed by the presenter. */
|
|
void psx_video_telemetry_cadence(int window_ms, int reset, PsxPresentCadence *out);
|
|
int psx_video_telemetry_cadence_json(int window_ms, int reset, char *out, int capacity);
|
|
/* Explicit monotonic host microseconds for adapters and deterministic tests. */
|
|
void psx_video_telemetry_present_at(int result, uint64_t now_us);
|
|
|
|
/* Emulation-owner settings after runtime mod overrides, sampled every VBlank.
|
|
* Actual allocated scale/dimensions come from the separate backend snapshot. */
|
|
typedef struct PsxVideoConfigTelemetry {
|
|
int renderer, resolution_preset, aspect_num, aspect_den, widescreen;
|
|
} PsxVideoConfigTelemetry;
|
|
void psx_video_config_telemetry(PsxVideoConfigTelemetry *out);
|
|
/* Queue one composed-output PNG on the existing presenter capture path.
|
|
* Zero means rejected/unavailable. Acceptance is not proof the file was written.
|
|
* Called only for an explicit owner incident, never for every ordinary frame. */
|
|
int psx_video_telemetry_capture(const char *path);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|