OpenGL capture / playback debugger.
April 16, 2014: Vogl history has been completely and utterly trounced. The original repository had an entire chroot build system that most folks weren’t interested in. A few contributors (thanks Carl & Sir Anthony) took the time to build a much smaller source only vogl repository which we’ve replaced the original one with.
A separate chroot repository (which will build this source repository) is now here:
https://bitbucket.org/raddebugger/vogl_chroot
This project is alpha^2. If you are up for suffering through a bit of pain with early releases, please jump in - we’d love to have your help…
The chroot configuration script should be a good reference for vogl dependencies. It is located here:
https://bitbucket.org/raddebugger/vogl_chroot/src/master/bin/chroot_configure.sh?at=master
The build dependencies for ubuntu (14.04) can be installed using the following:
sudo apt-get install build-essential pkg-config cmake libx11-dev \
zip wget libtinyxml-dev liblzma-dev libunwind8-dev \
libturbojpeg libdwarf-dev mesa-common-dev qt5-qmake\
freeglut3-dev qt5-default libqt5x11extras5-dev git \
libsdl2-gfx-dev libsdl2-image-dev libsdl2-ttf-dev libjpeg-turbo8-dev
git clone https://github.com/ValveSoftware/vogl.git
mkdir -p vogl/vogl_build/release64 && cd $_
cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_X64=On ../..
make -j 10
The binaries are placed in the vogl/vogl_build directory.
For debug builds, use “-DCMAKE_BUILD_TYPE=Debug”
For 32-bit builds, use “-DBUILD_X64=Off”
git clone https://github.com/ValveSoftware/vogl.git
mkdir -p vogl\vogl_build\x64
cd vogl\vogl_build\x64
cmake -DQt5_DIR="C:\Qt\5.3\msvc2013_64_opengl\lib\cmake\Qt5" -G "Visual Studio 12 2013 Win64" ..\..
cd ..\..\..\
mkdir -p vogl\vogl_build\win32
cd vogl\vogl_build\win32
cmake -DQt5_DIR="C:\Qt\5.3\msvc2013_opengl\lib\cmake\Qt5" -G "Visual Studio 12 2013" ..\..
Note: The path to Qt5 might need to be adjusted depending on your install location.
After compiling with Visual Studio, the binaries are placed in the vogl\vogl_build\Release (or Debug) directory.
Install the required build dependencies using Homebrew:
brew install pkg-config cmake sdl2 qt5 xz jpeg-turbo tinyxml
Then build with:
git clone https://github.com/ValveSoftware/vogl.git
mkdir -p vogl/vogl_build/mac
cd vogl/vogl_build/mac
cmake ../.. -DCMAKE_PREFIX_PATH=/usr/local/Cellar/qt5/5.3.2/
make
Note: the Mac port is not yet functional.
cd vogl_build
VOGL_CMD_LINE="--vogl_tracefile vogltrace.glxspheres64.bin" LD_PRELOAD=$(readlink -f libvogltrace64.so) ./glxspheres64
For capturing Steam games, please see the vogl_trace.sh script in the chroot repository:
https://bitbucket.org/raddebugger/vogl_chroot/src/master/bin/src/sl.cpp?at=master
We are currently working on making it much easier to launch and profile Steam apps.
./voglreplay64 play vogltrace.glxspheres64.bin
or launch vogleditor64 and open trace file.
See qtcreator/qtcreator.md file: qtcreator.md
http://lists.voglproj.com/listinfo.cgi/dev-voglproj.com
Vogl Wiki
OpenGL documentation/references
Specifications
Vogl code is MIT licensed.
Copyright 2013-2014 RAD Game Tools and Valve Software
All Rights Reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
libbacktrace is BSD licensed. Libbacktrace license.
apitrace is MIT licensed: Apitrace license.
Loki is MIT licensed: Loki license.
Valgrind header files are BSD-style licensed: Valgrind header files.
GL header files are MIT licensed: GL header files.
glxspheres (from VirtualGL) is wxWindows Library licensed: wxWindows Library License.
SDL is zlib licensed: zlib license.
stb files (from Sean Barrett) are public domain.
TinyXML-2 is zlib licensed: zlib license.