README.md

WIP15

WIP15 is a core OpenGL debugger. It allows you to trace unmodified OpenGL programs and to replay and inspect the traces. It is not stable nor ready for use.

Dependencies (excluding what is probably already installed)

• SDL2 headers and libraries
• GTK+ 3 headers and libraries
• Optionally GTKSourceView for Gtk+ 3 headers and libraries
• Python (versions 2.7.14 and 3.6.3 have been tested)
• GNU Wget

Zlib and LZ4 development packages are optional but having at least one is recommended.

For the "test-coverage" Makefile target, LCOV is needed.

Compiling

make -j$(getconf _NPROCESSORS_ONLN)

Usage

Tracing

Currently it can only trace GLX programs.

./trace -o <output-trace> <program> <arguments>

For example:

./trace -o output.trace ./test

Traces can also be created with the GUI.

Inspection

./gui <trace-file>

or

./gui

and open it in the GUI.