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:
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:
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
Get Source and Build
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.
Mac OS X
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:
We are currently working on making it much easier to launch and profile Steam apps.
./voglreplay64 play vogltrace.glxspheres64.bin
vogleditor64 and open trace file.
QtCreator tagging and building
See qtcreator/qtcreator.md file: qtcreator.md
Vogl Dev List
- 4.x: http://www.opengl.org/sdk/docs/man/
- 3.3: http://www.opengl.org/sdk/docs/man3/
- 2.1: http://www.opengl.org/sdk/docs/man2/
- 4.0: http://www.opengl.org/registry/doc/glspec40.core.20100311.pdf
- 3.3: http://www.opengl.org/registry/doc/glspec33.core.20100311.withchanges.pdf
- 2.1: http://www.opengl.org/documentation/specs/version2.1/glspec21.pdf
License and Credits
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.