Requirements common for all platforms:
-
Python version 2.6 or 2.7
- Python Image Library
-
CMake version 2.8 or higher (tested with version 2.8)
The GUI also dependends on:
-
Qt version 4.7
-
QJSON version 0.5 or higher (tested with version 0.7.1, which is bundled)
Qt and QJSON will be required if -DENABLE_GUI=TRUE
is passed to cmake
, and
never used if -DENABLED_GUI=FALSE
is passed instead. The implicit default is
-DENABLE_GUI=AUTO
, which will build the GUI if Qt is available, using the
bundled QJSON if it is not found on the system.
The code also depends on zlib, libpng, and snappy libraries, but the bundled sources are always used regardless of system availability, to make the wrapper shared-objects/DLL self contained, and to prevent symbol collisions when tracing.
Build as:
cmake -H. -Bbuild
make -C build
You can also build the 32bit GL wrapper on 64bit distro with a multilib gcc by doing:
cmake -H. -Bbuild32 -DCMAKE_C_FLAGS=-m32 -DCMAKE_CXX_FLAGS=-m32 -DCMAKE_EXE_LINKER_FLAGS=-m32 -DENABLE_GUI=FALSE
make -C build32 glxtrace
Additional requirements:
Build as:
export ANDROID_NDK=/path/to/your/ndk
cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain/android.toolchain.cmake -DANDROID_API_LEVEL=9 -H. -Bbuild
make -C build
Additional requirements:
-
For Direct3D 11.1 support:
-
Other:
-
Microsoft Visual Studio (tested with 2010 version) or MinGW (tested with mingw-w64's gcc version 4.6.2)
-
-
for D3D 10, 10.1, and 11 support the June 2010 release is recommended.
-
for D3D7, D3D8 support the August 2007 release or earlier is required, as later releases do not include the necessary headers.
-
-
To build with Visual Studio first invoke CMake GUI as:
cmake-gui -H. -B%cd%\build
and press the Configure button.
It will try to detect most required/optional dependencies automatically. When not found automatically, you can manually specify the location of the dependencies from the CMake GUI.
After you've successfully configured, you can start the build by opening the
generated build\apitrace.sln
solution file, or invoking cmake
as:
cmake --build build --config MinSizeRel
The steps to build 64bit version are similar, but choosing Visual Studio 10 Win64 instead of Visual Studio 10.
It's also possible to instruct cmake
build Windows binaries on Linux with
MinGW cross compilers.