| 154 | --- |
| 155 | |
| 156 | == OpenGL == |
| 157 | |
| 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. |
| 160 | |
| 161 | This 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. |
| 162 | |
| 163 | Use as follows: |
| 164 | |
| 165 | $ apitrace xpra attach <your regular commandline> |
| 166 | - 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. |
| 167 | - Exit Xpra when done |
| 168 | $ qapitrace |
| 169 | File -> load the trace |
| 170 | Then go to Trace -> Replay and check both boxes |
| 171 | |
| 172 | Apitrace 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. |