Index of /archives/NetBSD/NetBSD-release-9/xsrc/external/mit/MesaLib.old/dist/src/gallium/tools/trace

Icon  Name                                                                                    Last modified      Size  Description
[PARENTDIR] Parent Directory                                                                                             -   
[DIR] CVS/                                                                                    2020-03-20 07:39    -   
[TXT] README.txt                                                                              2019-03-08 19:19  1.0K  
[TXT] TODO.txt                                                                                2019-03-08 19:19  212   
[TXT] diff_state.py                                                                           2019-03-08 19:19  9.8K  
[TXT] dump.py                                                                                 2019-03-08 19:19  1.4K  
[TXT] dump_state.py                                                                           2019-03-08 19:19   24K  
[TXT] format.py                                                                               2019-03-08 19:19  5.0K  
[TXT] model.py                                                                                2019-03-08 19:19  6.1K  
[TXT] parse.py                                                                                2019-03-08 19:19   12K  
[   ] tracediff.sh                                                                            2019-03-08 19:19  2.0K  

These directory contains tools for manipulating traces produced by the trace
pipe driver.


Most debug builds of state trackers already load the trace driver by default.
To produce a trace do

  export GALLIUM_TRACE=foo.gtrace

and run the application.  You can choose any name, but the .gtrace is
recommended to avoid confusion with the .trace produced by apitrace.


You can dump a trace by doing

  ./dump.py foo.gtrace | less


You can dump a JSON file describing the static state at any given draw call
(e.g., 12345) by
doing

  ./dump_state.py -v -c 12345 foo.gtrace > foo.json

or by specifying the n-th (e.g, 1st) draw call by doing

  ./dump_state.py -v -d 1 foo.gtrace > foo.json

The state is derived from the call sequence in the trace file, so no dynamic
(eg. rendered textures) is included.


You can compare two JSON files by doing

  ./diff_state.py foo.json boo.json | less

If you're investigating a regression in a state tracker, you can obtain a good
and bad trace, dump respective state in JSON, and then compare the states to
identify the problem.