xref: /aosp_15_r20/external/mesa3d/src/gallium/auxiliary/util/u_trace_gallium.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Copyright © 2020 Google, Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21  * SOFTWARE.
22  */
23 
24 #ifndef _U_TRACE_GALLIUM_H
25 #define _U_TRACE_GALLIUM_H
26 
27 #include "util/perf/u_trace.h"
28 
29 #ifdef __cplusplus
30 extern "C" {
31 #endif
32 
33 /* Gallium specific u_trace helpers */
34 
35 struct pipe_context;
36 struct pipe_framebuffer_state;
37 
38 void
39 u_trace_pipe_context_init(struct u_trace_context *utctx,
40                           struct pipe_context *pctx,
41                           uint32_t timestamp_size_B,
42                           uint32_t max_indirect_size_B,
43                           u_trace_record_ts record_timestamp,
44                           u_trace_read_ts read_timestamp,
45                           u_trace_capture_data capture_data,
46                           u_trace_get_data get_data,
47                           u_trace_delete_flush_data delete_flush_data);
48 
49 /*
50  * In some cases it is useful to have composite tracepoints like this,
51  * to log more complex data structures.
52  */
53 
54 void
55 trace_framebuffer_state(struct u_trace *ut, void *cs, const struct pipe_framebuffer_state *pfb);
56 
57 #ifdef __cplusplus
58 }
59 #endif
60 
61 #endif  /* _U_TRACE_GALLIUM_H */
62