Skip to content

Teybeo/GLSL-Debugger

 
 

Repository files navigation

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:

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 glsl-debugger-development@googlegroups.com https://groups.google.com/forum/?fromgroups#!forum/glsl-debugger-development

IRC channel at freenode: #glsl-debugger

Releases

No releases published

Packages

No packages published

Languages

  • C++ 58.1%
  • C 40.5%
  • Perl 1.3%
  • Other 0.1%