X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=metrics.h;h=4beda7f5e41b1eddfb959b29b9a0a2583bf0b73b;hb=3b579d69622d53b95c6259daf0ecb4f5d2b1798b;hp=2d93d908d39026cf1fd4b0b8fda9bd199d24f0ef;hpb=fac9c8c2d3bfc5e97f2fdcf90f8cbe3ac9b2c49e;p=fips

diff --git a/metrics.h b/metrics.h
index 2d93d90..4beda7f 100644
--- a/metrics.h
+++ b/metrics.h
@@ -22,33 +22,83 @@
 #ifndef METRICS_H
 #define METRICS_H
 
-/* Add a new counter to the metrics tracking state.
+typedef enum
+{
+	METRICS_OP_ACCUM,
+	METRICS_OP_BUFFER_DATA,
+	METRICS_OP_BUFFER_SUB_DATA,
+	METRICS_OP_BITMAP,
+	METRICS_OP_BLIT_FRAMEBUFFER,
+	METRICS_OP_CLEAR,
+	METRICS_OP_CLEAR_BUFFER_DATA,
+	METRICS_OP_CLEAR_TEX_IMAGE,
+	METRICS_OP_COPY_PIXELS,
+	METRICS_OP_COPY_TEX_IMAGE,
+	METRICS_OP_DRAW_PIXELS,
+	METRICS_OP_GET_TEX_IMAGE,
+	METRICS_OP_READ_PIXELS,
+	METRICS_OP_TEX_IMAGE,
+
+	/* METRICS_OP_SHADER must be last.
+	 * 
+	 * All larger values for metrics_op_t are interpreted as:
+	 *
+	 *	METRICS_OP_SHADER + shader_program_number
+	 *
+	 * to indicate a specific shader program.
+	 */
+	METRICS_OP_SHADER
+} metrics_op_t;
+
+/* Initialize metrics info
  *
- * The value accumulated in this counter be accounted against the
- * current program (as set with metrics_set_current_program).
+ * This queries the names and ranges for all available performance counters.
+ *
+ * This should be called once before any other metrics functions.
+ */
+void
+metrics_info_init (void);
+
+/* Finalize metrics info state.
  *
- * Returns: A counter ID suitable for use with metrics_counter_start
- * and metrics_counter_stop.
+ * The function should be called just before setting a new, current,
+ * OpenGL context.
  */
-unsigned
-metrics_counter_new (void);
+void
+metrics_info_fini (void);
 
-/* Start accumulating GPU time spent into the given counter. */
+/* Start accumulating GPU time.
+ *
+ * The time accumulated will be accounted against the
+ * current program (as set with metrics_set_current_program).
+ */
 void
-metrics_counter_start (unsigned counter);
+metrics_counter_start (void);
 
 /* Stop accumulating GPU time (stops the most-recently started counter) */
 void
 metrics_counter_stop (void);
 
-/* Set the ID of the currently executing shader program.
+/* Set a metrics_op_t value to indicate what kind of operation is
+ * being performed.
  *
- * The metrics-tracking code will account for per-shader-program
- * timings by accumulating counter values measured while each porogram
- * is active (see metrics_add_counter).
+ * The metrics-tracking code will account for timings by accumulating
+ * measured counter values into a separate counter for each
+ * metrics_op_t value, (so that the report can describe which
+ * operations are the most expensive).
+ *
+ * In addition, for the value METRICS_OP_SHADER, each specific shader
+ * program can be distinguished. To accomplish this, pass a value of
+ * METRICS_OP_SHADER + shader_program_number to this function.
  */
 void
-metrics_set_current_program (unsigned program);
+metrics_set_current_op (metrics_op_t op);
+
+/* Return the current metrics_op_t value, (the value most-recently-set
+ * with a call to metrics_set_current_op).
+ */
+metrics_op_t
+metrics_get_current_op (void);
 
 /* Should be called at the end of every function wrapper for a
  * function that ends a frame, (glXSwapBuffers and similar).