Skip to content

scygan/debugler

Repository files navigation

Build Status

Debugler

The OpenGL 2.1+, OpenGL ES 2.0+ mutli-platform debugger on-line debugger.

The project loosely based on my 2012 thesis from Gdańsk University of Technology.

It is not actively developed any more. Moreover, it is not tested enough and does not show any good coding standards.

Supported platforms

Applications using OpenGL running on following systems can be debugged:

  • Windows (Vista or newer, 32- and 64-bit applications)
  • Linux (tried x86 and x86_64 applications on Ubuntu 12.04)
  • Android (x86, x86_64, ARM or MIPS*). Tried versions 2.3.5 through 5.0.

** Android MIPS target is not being build by default.

Additionally, the GUI runs on Windows and Linux platforms.

Build instructions

Building using provided scripts is easy, however there are multiple tool and library prerequisites that must be installed before the build.

Following lists the best known versions of these tools and libraries.

Windows prerequisites

Linux prerequisites

On Ubuntu 12.04, following packages are needed

Needed:

  • Ubuntu packages: cmake g++-4.7 libxxf86vm-dev python-lxml x11proto-gl-dev libelf-dev libqt4-dev (or QT 5.0 version)

  • Android NDK r9b, set ANDROID_NDK environment variable to NDK directory

Building Debugler:

Just run the script:

built.py
  • By default build.py will build 64-bit (x86_64) redistributable installable package. On Windows this is an MSI installer, on Ubuntu this is a debugler-*-Linux-*deb package.

  • Installers are build in build\x64\Release\Installer (on Windows) or build/64-dist/Release (on Linux) directories.

  • Other targets may be build using following command line:

built.py [target]
  • Available targets:
  • 64-dist: default, 64-bit installer/deb package, with all Android binaries
  • 32-dist: 32-bit installer/deb package, with all Android binaries
  • 64: 64-bit installer/deb package
  • 32: 32-bit installer/deb package
  • android-arm: just android-arm binary (dglandroidinstaller)
  • android-x86: just android-x86 binary
  • android-mips: just android-mips binary

####Running unit tests

  • Run
cd build/<target>/<configuration>/UT
ut
  • Under Visual Studio you can use GoogleTest Runner extension

Development

Code style