X-Git-Url: https://git.cworth.org/git?p=fips;a=blobdiff_plain;f=context.h;h=cbfd6b48f0dbc315f824a28255f8ddf7960c48c3;hp=6ad357fd724aa958f9f6caf8e165ef796bf253fc;hb=HEAD;hpb=43fa296375ee35d811b7fed4537312ce9d08feac diff --git a/context.h b/context.h index 6ad357f..cbfd6b4 100644 --- a/context.h +++ b/context.h @@ -27,15 +27,6 @@ #include "fips-dispatch.h" -typedef struct context -{ - /* Pointer to the system's context ID, (such as a GLXContext) */ - void *system_id; - - metrics_info_t metrics_info; - metrics_t metrics; -} context_t; - /* Indicate that a new context has come into use. * * Here, 'system_context_id' is a pointer to a system context (such as @@ -53,8 +44,46 @@ context_enter (fips_api_t api, void *system_context_id); void context_leave (void); -/* Get the current context. */ -context_t * -context_get_current (void); +/* Start accumulating GPU time. + * + * The time accumulated will be accounted against the + * current operation (as set with context_set_current_op). + */ +void +context_counter_start (void); + +/* Stop accumulating GPU time (stops the most-recently started counter) */ +void +context_counter_stop (void); + +/* Set a metrics_op_t value to indicate what kind of operation is + * being performed. + * + * 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 +context_set_current_op (metrics_op_t op); + +/* Return the current metrics_op_t value, (the value most-recently-set + * with a call to context_set_current_op). + */ +metrics_op_t +context_get_current_op (void); + +/* Should be called at the end of every function wrapper for a + * function that ends a frame, (glXSwapBuffers and similar). + * + * This function performs whatever bookkeeping is necessary to + * generate a timing report, then emits that report. + */ +void +context_end_frame (void); #endif