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 Version 20 and Version 21 of Debugging


Ignore:
Timestamp:
04/15/13 15:27:51 (8 years ago)
Author:
ahuillet
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Debugging

    v20 v21  
    156156== OpenGL ==
    157157
    158 Whenever 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.
    159 The most important thing is to build the tool Apitrace (https://github.com/apitrace/apitrace) according to the documentation https://github.com/apitrace/apitrace/blob/master/INSTALL.markdown, and use it on Xpra to get a full trace.
     158Whenever 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.
     159
     160=== Installation of Apitrace ===
     161
     162==== On Linux ====
     163
     164Download Apitrace (https://github.com/apitrace/apitrace), build it according to the documentation https://github.com/apitrace/apitrace/blob/master/INSTALL.markdown
     165
     166==== On Windows ====
     167
     168You can use pre-built binaries found at http://people.freedesktop.org/~jrfonseca/apitrace/ Try to always use the latest version and fallback to an older one if it doesn't work.
     169
     170=== Trace generation ===
    160171
    161172This 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.
     
    171182
    172183Apitrace 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.
     184
     185Be ready to send the .trace file to the developers for further investigation.