1 /**************************************************************************
2  *
3  * Copyright 2013 Marek Olšák <maraeo@gmail.com>
4  * All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the
8  * "Software"), to deal in the Software without restriction, including
9  * without limitation the rights to use, copy, modify, merge, publish,
10  * distribute, sub license, and/or sell copies of the Software, and to
11  * permit persons to whom the Software is furnished to do so, subject to
12  * the following conditions:
13  *
14  * The above copyright notice and this permission notice (including the
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21  * IN NO EVENT SHALL THE AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR
22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25  *
26  **************************************************************************/
27 
28 /* This file contains code for reading values from pipe queries
29  * for displaying on the HUD. To prevent stalls when reading queries, we
30  * keep a list of busy queries in a ring. We read only those queries which
31  * are idle.
32  */
33 
34 #include "hud/hud_private.h"
35 #include "pipe/p_screen.h"
36 #include "util/os_time.h"
37 #include "util/u_math.h"
38 #include "util/u_memory.h"
39 #include <stdio.h>
40 
41 // Must be a power of two
42 #define NUM_QUERIES 8
43 
44 struct hud_batch_query_context {
45    unsigned num_query_types;
46    unsigned allocated_query_types;
47    unsigned *query_types;
48 
49    boolean failed;
50    struct pipe_query *query[NUM_QUERIES];
51    union pipe_query_result *result[NUM_QUERIES];
52    unsigned head, pending, results;
53 };
54 
55 void
hud_batch_query_update(struct hud_batch_query_context * bq,struct pipe_context * pipe)56 hud_batch_query_update(struct hud_batch_query_context *bq,
57                        struct pipe_context *pipe)
58 {
59    if (!bq || bq->failed)
60       return;
61 
62    if (bq->query[bq->head])
63       pipe->end_query(pipe, bq->query[bq->head]);
64 
65    bq->results = 0;
66 
67    while (bq->pending) {
68       unsigned idx = (bq->head - bq->pending + 1) % NUM_QUERIES;
69       struct pipe_query *query = bq->query[idx];
70 
71       if (!bq->result[idx])
72          bq->result[idx] = MALLOC(sizeof(bq->result[idx]->batch[0]) *
73                                   bq->num_query_types);
74       if (!bq->result[idx]) {
75          fprintf(stderr, "gallium_hud: out of memory.\n");
76          bq->failed = TRUE;
77          return;
78       }
79 
80       if (!pipe->get_query_result(pipe, query, FALSE, bq->result[idx]))
81          break;
82 
83       ++bq->results;
84       --bq->pending;
85    }
86 
87    bq->head = (bq->head + 1) % NUM_QUERIES;
88 
89    if (bq->pending == NUM_QUERIES) {
90       fprintf(stderr,
91               "gallium_hud: all queries busy after %i frames, dropping data.\n",
92               NUM_QUERIES);
93 
94       assert(bq->query[bq->head]);
95 
96       pipe->destroy_query(pipe, bq->query[bq->head]);
97       bq->query[bq->head] = NULL;
98    }
99 
100    ++bq->pending;
101 
102    if (!bq->query[bq->head]) {
103       bq->query[bq->head] = pipe->create_batch_query(pipe,
104                                                      bq->num_query_types,
105                                                      bq->query_types);
106 
107       if (!bq->query[bq->head]) {
108          fprintf(stderr,
109                  "gallium_hud: create_batch_query failed. You may have "
110                  "selected too many or incompatible queries.\n");
111          bq->failed = TRUE;
112          return;
113       }
114    }
115 }
116 
117 void
hud_batch_query_begin(struct hud_batch_query_context * bq,struct pipe_context * pipe)118 hud_batch_query_begin(struct hud_batch_query_context *bq,
119                       struct pipe_context *pipe)
120 {
121    if (!bq || bq->failed || !bq->query[bq->head])
122       return;
123 
124    if (!pipe->begin_query(pipe, bq->query[bq->head])) {
125       fprintf(stderr,
126               "gallium_hud: could not begin batch query. You may have "
127               "selected too many or incompatible queries.\n");
128       bq->failed = TRUE;
129    }
130 }
131 
132 static boolean
batch_query_add(struct hud_batch_query_context ** pbq,unsigned query_type,unsigned * result_index)133 batch_query_add(struct hud_batch_query_context **pbq,
134                 unsigned query_type, unsigned *result_index)
135 {
136    struct hud_batch_query_context *bq = *pbq;
137    unsigned i;
138 
139    if (!bq) {
140       bq = CALLOC_STRUCT(hud_batch_query_context);
141       if (!bq)
142          return false;
143       *pbq = bq;
144    }
145 
146    for (i = 0; i < bq->num_query_types; ++i) {
147       if (bq->query_types[i] == query_type) {
148          *result_index = i;
149          return true;
150       }
151    }
152 
153    if (bq->num_query_types == bq->allocated_query_types) {
154       unsigned new_alloc = MAX2(16, bq->allocated_query_types * 2);
155       unsigned *new_query_types
156          = REALLOC(bq->query_types,
157                    bq->allocated_query_types * sizeof(unsigned),
158                    new_alloc * sizeof(unsigned));
159       if (!new_query_types)
160          return false;
161       bq->query_types = new_query_types;
162       bq->allocated_query_types = new_alloc;
163    }
164 
165    bq->query_types[bq->num_query_types] = query_type;
166    *result_index = bq->num_query_types++;
167    return true;
168 }
169 
170 void
hud_batch_query_cleanup(struct hud_batch_query_context ** pbq,struct pipe_context * pipe)171 hud_batch_query_cleanup(struct hud_batch_query_context **pbq,
172                         struct pipe_context *pipe)
173 {
174    struct hud_batch_query_context *bq = *pbq;
175    unsigned idx;
176 
177    if (!bq)
178       return;
179 
180    *pbq = NULL;
181 
182    if (bq->query[bq->head] && !bq->failed)
183       pipe->end_query(pipe, bq->query[bq->head]);
184 
185    for (idx = 0; idx < NUM_QUERIES; ++idx) {
186       if (bq->query[idx])
187          pipe->destroy_query(pipe, bq->query[idx]);
188       FREE(bq->result[idx]);
189    }
190 
191    FREE(bq->query_types);
192    FREE(bq);
193 }
194 
195 struct query_info {
196    struct hud_batch_query_context *batch;
197    enum pipe_query_type query_type;
198 
199    /** index to choose fields in pipe_query_data_pipeline_statistics,
200     * for example.
201     */
202    unsigned result_index;
203    enum pipe_driver_query_result_type result_type;
204    enum pipe_driver_query_type type;
205 
206    /* Ring of queries. If a query is busy, we use another slot. */
207    struct pipe_query *query[NUM_QUERIES];
208    unsigned head, tail;
209 
210    uint64_t last_time;
211    uint64_t results_cumulative;
212    unsigned num_results;
213 };
214 
215 static void
query_new_value_batch(struct query_info * info)216 query_new_value_batch(struct query_info *info)
217 {
218    struct hud_batch_query_context *bq = info->batch;
219    unsigned result_index = info->result_index;
220    unsigned idx = (bq->head - bq->pending) % NUM_QUERIES;
221    unsigned results = bq->results;
222 
223    while (results) {
224       info->results_cumulative += bq->result[idx]->batch[result_index].u64;
225       ++info->num_results;
226 
227       --results;
228       idx = (idx - 1) % NUM_QUERIES;
229    }
230 }
231 
232 static void
query_new_value_normal(struct query_info * info,struct pipe_context * pipe)233 query_new_value_normal(struct query_info *info, struct pipe_context *pipe)
234 {
235    if (info->last_time) {
236       if (info->query[info->head])
237          pipe->end_query(pipe, info->query[info->head]);
238 
239       /* read query results */
240       while (1) {
241          struct pipe_query *query = info->query[info->tail];
242          union pipe_query_result result;
243          uint64_t *res64 = (uint64_t *)&result;
244 
245          if (query && pipe->get_query_result(pipe, query, FALSE, &result)) {
246             if (info->type == PIPE_DRIVER_QUERY_TYPE_FLOAT) {
247                assert(info->result_index == 0);
248                info->results_cumulative += (uint64_t) (result.f * 1000.0f);
249             }
250             else {
251                info->results_cumulative += res64[info->result_index];
252             }
253             info->num_results++;
254 
255             if (info->tail == info->head)
256                break;
257 
258             info->tail = (info->tail+1) % NUM_QUERIES;
259          }
260          else {
261             /* the oldest query is busy */
262             if ((info->head+1) % NUM_QUERIES == info->tail) {
263                /* all queries are busy, throw away the last query and create
264                 * a new one */
265                fprintf(stderr,
266                        "gallium_hud: all queries are busy after %i frames, "
267                        "can't add another query\n",
268                        NUM_QUERIES);
269                if (info->query[info->head])
270                   pipe->destroy_query(pipe, info->query[info->head]);
271                info->query[info->head] =
272                      pipe->create_query(pipe, info->query_type, 0);
273             }
274             else {
275                /* the last query is busy, we need to add a new one we can use
276                 * for this frame */
277                info->head = (info->head+1) % NUM_QUERIES;
278                if (!info->query[info->head]) {
279                   info->query[info->head] =
280                         pipe->create_query(pipe, info->query_type, 0);
281                }
282             }
283             break;
284          }
285       }
286    }
287    else {
288       /* initialize */
289       info->query[info->head] = pipe->create_query(pipe, info->query_type, 0);
290    }
291 }
292 
293 static void
begin_query(struct hud_graph * gr,struct pipe_context * pipe)294 begin_query(struct hud_graph *gr, struct pipe_context *pipe)
295 {
296    struct query_info *info = gr->query_data;
297 
298    assert(!info->batch);
299    if (info->query[info->head])
300       pipe->begin_query(pipe, info->query[info->head]);
301 }
302 
303 static void
query_new_value(struct hud_graph * gr,struct pipe_context * pipe)304 query_new_value(struct hud_graph *gr, struct pipe_context *pipe)
305 {
306    struct query_info *info = gr->query_data;
307    uint64_t now = os_time_get();
308 
309    if (info->batch) {
310       query_new_value_batch(info);
311    } else {
312       query_new_value_normal(info, pipe);
313    }
314 
315    if (!info->last_time) {
316       info->last_time = now;
317       return;
318    }
319 
320    if (info->num_results && info->last_time + gr->pane->period <= now) {
321       double value;
322 
323       switch (info->result_type) {
324       default:
325       case PIPE_DRIVER_QUERY_RESULT_TYPE_AVERAGE:
326          value = info->results_cumulative / info->num_results;
327          break;
328       case PIPE_DRIVER_QUERY_RESULT_TYPE_CUMULATIVE:
329          value = info->results_cumulative;
330          break;
331       }
332 
333       if (info->type == PIPE_DRIVER_QUERY_TYPE_FLOAT) {
334          value /= 1000.0;
335       }
336 
337       hud_graph_add_value(gr, value);
338 
339       info->last_time = now;
340       info->results_cumulative = 0;
341       info->num_results = 0;
342    }
343 }
344 
345 static void
free_query_info(void * ptr,struct pipe_context * pipe)346 free_query_info(void *ptr, struct pipe_context *pipe)
347 {
348    struct query_info *info = ptr;
349 
350    if (!info->batch && info->last_time) {
351       int i;
352 
353       pipe->end_query(pipe, info->query[info->head]);
354 
355       for (i = 0; i < ARRAY_SIZE(info->query); i++) {
356          if (info->query[i]) {
357             pipe->destroy_query(pipe, info->query[i]);
358          }
359       }
360    }
361    FREE(info);
362 }
363 
364 
365 /**
366  * \param result_index  to select fields of pipe_query_data_pipeline_statistics,
367  *                      for example.
368  */
369 void
hud_pipe_query_install(struct hud_batch_query_context ** pbq,struct hud_pane * pane,const char * name,enum pipe_query_type query_type,unsigned result_index,uint64_t max_value,enum pipe_driver_query_type type,enum pipe_driver_query_result_type result_type,unsigned flags)370 hud_pipe_query_install(struct hud_batch_query_context **pbq,
371                        struct hud_pane *pane,
372                        const char *name,
373                        enum pipe_query_type query_type,
374                        unsigned result_index,
375                        uint64_t max_value, enum pipe_driver_query_type type,
376                        enum pipe_driver_query_result_type result_type,
377                        unsigned flags)
378 {
379    struct hud_graph *gr;
380    struct query_info *info;
381 
382    gr = CALLOC_STRUCT(hud_graph);
383    if (!gr)
384       return;
385 
386    strncpy(gr->name, name, sizeof(gr->name));
387    gr->name[sizeof(gr->name) - 1] = '\0';
388    gr->query_data = CALLOC_STRUCT(query_info);
389    if (!gr->query_data)
390       goto fail_gr;
391 
392    gr->query_new_value = query_new_value;
393    gr->free_query_data = free_query_info;
394 
395    info = gr->query_data;
396    info->result_type = result_type;
397    info->type = type;
398 
399    if (flags & PIPE_DRIVER_QUERY_FLAG_BATCH) {
400       if (!batch_query_add(pbq, query_type, &info->result_index))
401          goto fail_info;
402       info->batch = *pbq;
403    } else {
404       gr->begin_query = begin_query;
405       info->query_type = query_type;
406       info->result_index = result_index;
407    }
408 
409    hud_pane_add_graph(pane, gr);
410    pane->type = type; /* must be set before updating the max_value */
411 
412    if (pane->max_value < max_value)
413       hud_pane_set_max_value(pane, max_value);
414    return;
415 
416 fail_info:
417    FREE(info);
418 fail_gr:
419    FREE(gr);
420 }
421 
422 boolean
hud_driver_query_install(struct hud_batch_query_context ** pbq,struct hud_pane * pane,struct pipe_screen * screen,const char * name)423 hud_driver_query_install(struct hud_batch_query_context **pbq,
424                          struct hud_pane *pane, struct pipe_screen *screen,
425                          const char *name)
426 {
427    struct pipe_driver_query_info query;
428    unsigned num_queries, i;
429    boolean found = FALSE;
430 
431    if (!screen->get_driver_query_info)
432       return FALSE;
433 
434    num_queries = screen->get_driver_query_info(screen, 0, NULL);
435 
436    for (i = 0; i < num_queries; i++) {
437       if (screen->get_driver_query_info(screen, i, &query) &&
438           strcmp(query.name, name) == 0) {
439          found = TRUE;
440          break;
441       }
442    }
443 
444    if (!found)
445       return FALSE;
446 
447    hud_pipe_query_install(pbq, pane, query.name, query.query_type, 0,
448                           query.max_value.u64, query.type, query.result_type,
449                           query.flags);
450 
451    return TRUE;
452 }
453