xpra icon
Bug tracker and wiki

This bug tracker and wiki are being discontinued
please use https://github.com/Xpra-org/xpra instead.

Changes between Initial Version and Version 1 of Debugging/OpenGL

12/11/13 10:38:58 (8 years ago)
Antoine Martin



  • Debugging/OpenGL

    v1 v1  
     1{{{#!div class="box"
     2= OpenGL Debugging using `Apitrace` =
     4Whenever you encounter problems with client-side `OpenGL` rendering, for example with `OpenGL` error messages, crashes, or visual artifacts, there are some specific steps to take to investigate. The *`Apitrace`* tool will get a dump of the `OpenGL` command stream, allowing it to be sent to the developers for replaying and investigation.
     7{{{#!div class="box"
     8== Installation ==
     10=== On Linux ===
     12Download [https://github.com/apitrace/apitrace Apitrace], build it according to the documentation: [https://github.com/apitrace/apitrace/blob/master/INSTALL.markdown]
     14=== On Windows ===
     16You can use pre-built binaries found at [http://people.freedesktop.org/~jrfonseca/apitrace/]
     17Try to always use the latest version and fallback to an older one if it doesn't work.
     20{{{#!div class="box"
     21= Trace generation ===
     23This trace will enable you to replay the actions of the client without having to re-run it; giving you additional error tracing, ability to send the trace to another person, and ability to replay the exact same steps every time.
     25Use as follows:
     27$ apitrace trace xpra attach <your regular commandline>
     29- Do whatever is needed to reproduce the issue you are experiencing. Beware: Apitrace is keeping a copy of everything you do in RAM, it's going to be huge, so don't run the session for too long, and focus on reproducing one issue at a time.
     30- Exit Xpra when done
     32$ qapitrace
     34`File` -> `load the trace`
     35Then go to `Trace` -> `Replay` and check both boxes
     37Apitrace will replay your trace and report in the bottom panel any errors it found, with additional explanation as compared to what the GL driver typically gives.
     39Be ready to send the {{{.trace}}} file to the developers for further investigation.