siranthony / glsl-debugger

GLSL source level debugger.

GLSL-Debugger

GLSL source level debugger.

This is the Open Source public release of the project originally known as glslDevil ( http://www.vis.uni-stuttgart.de/glsldevil/ ), by Thomas Klein, Magnus Strengert and Thomas Ertl.

Building

The only available build system is cmake. Example build steps:

mkdir Build && cd Build
cmake ..\
make

Cmake may generate files for big number of make utilities, please check the cmake documentation for further information.

It is recommended to do out-of-source build.

Windows building requires additional dependencies installed:

• flex & bison (winflexbison is recommended: http://sourceforge.net/projects/winflexbison/ gnu flex and bison might work too)
• Qt library
• glut for windows ( not tested, http://user.xmission.com/~nate/glut.html Installation instructions: http://web.eecs.umich.edu/~sugih/courses/eecs487/glut-howto/#win) or freeglut ( tested, http://www.transmissionzero.co.uk/software/freeglut-devel/ )
• mhook required for windows build. It is added as submodule, use git submodule update --init --recursive if it was not checked with the tree.

On osx build was not tested, but cmake files may be used.

GLSL support

Old implementation of GLSLCompiler support GLSL up to 1.20. Support of newer versions is avaliable by using mesa-based GLSLCompiler implementation. To enable it, cmake option USE_MESA must be set. Use -DUSE_MESA=ON as argument to cmake command to do so. Mesa currently support GLSL up to version 3.30, it will be extended in future. Please note that mesa-based compiler is disabled by default yet and consider it as alternative, that may have bugs. It will replace original compiler after some testing.

Also new compiler can be build with tests by passing TESTS=ON option to cmake.

Short-term goals

We need to test the build system and the source code more thoroughly. Hence, bugfixing and testing should be a top priority for now.

Long-term goals

• Replace Windows Detours dependency with apiTrace, glIntercept or EasyHook. Replaced with mhook.
• Check cmake-to-VS generation and fix it if needed.
• Support OSX.
• Improve GLSL language grammar support to incorporate newer dialects including switch/case.
• Support OpenGL contexts for newer versions of OpenGL.

Contribute

We are looking for people who have an interest in this tool's capability to bring this project back to life and move it forward, so get in touch, check out the code, try it out, fix some things and push some changes!

Discussion is at [email protected] https://groups.google.com/forum/?fromgroups#!forum/glsl-debugger-development

IRC channel at freenode: #glsl-debugger

glsl-debugger's Issues

Add more framebuffers to buffer view.

Add combo box in buffer view with current active and all available framebuffers and add ability to choose one must be displayed in the image view.
Also rename "Buffer view" to "Framebuffer view" or something more accurate, because of buffer objects.
Points of interest:
progControl.cpp:1262
DebugLib/readback.c:1090
DebugLib/readback.c:689 - framebuffer save

Current version does not build with USE_MESA=ON

Trying to build on Linux:

cmake -DUSE_MESA=ON ..
make

and getting:

mesa-glsl/mesa/mesa/main/mtypes.h:3837:4: error: expected specifier-qualifier-list before ‘GLDEBUGPROC’