Add per-frame time and latency measurements

[fips] / metrics.h

diff --git a/metrics.h b/metrics.h
index 69afafb9b69b5cf6f164dba37d4042dbda4e4092..6cfc1494175cebfe13aec05606961f9facb3d3a7 100644 (file)
--- a/metrics.h
+++ b/metrics.h
@@ -108,14 +108,22 @@ metrics_set_current_op (metrics_t *metrics, metrics_op_t op);
 metrics_op_t
 metrics_get_current_op (metrics_t *metrics);
 
-/* Should be called at the end of every function wrapper for a
- * function that ends a frame, (glXSwapBuffers and similar).
+/* This pair of functions can be used to indicate a frame end.
  *
- * This function performs whatever bookkeeping is necessary to
- * generate a timing report, then emits that report.
+ * Both functions should be by every function wrapper for a function
+ * that ends a frame, (glXSwapBuffers and similar). The pre_swap
+ * before the call to the underlying swap function, and post_swap
+ * after.
+ *
+ * These functions trigger whatever bookkeeping is necessary to
+ * generate a timing report, (such as collecting any outstanding timer
+ * query values), and will also emit those reports when necessary.
  */
 void
-metrics_end_frame (metrics_t *metrics);
+metrics_end_frame_pre_swap (metrics_t *metrics);
+
+void
+metrics_end_frame_post_swap (metrics_t *metrics);
 
 /* Process outstanding metrics requests, accumulating results.
  *