X-Git-Url: https://git.cworth.org/git?p=apitrace;a=blobdiff_plain;f=INSTALL.markdown;h=2228bdff860368cdf72203e97f0b62a54683b736;hp=6ed777ae5ed176fc7db32642160cbda4615ebfdc;hb=3801952b80cd7a7160f6410518f6e3740d461b60;hpb=fe7252266b79cea5bf3514c4a165c0e341ac481a diff --git a/INSTALL.markdown b/INSTALL.markdown index 6ed777a..2228bdf 100644 --- a/INSTALL.markdown +++ b/INSTALL.markdown @@ -16,12 +16,12 @@ Requirements common for all platforms: The GUI also dependends on: -* Qt version 4.7 +* Qt version 4.7 or higher (tested with version 4.8) * 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 +Qt and QJSON will be required if `-DENABLE_GUI=TRUE` is passed to CMake, and +never used if `-DENABLE_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. @@ -40,12 +40,23 @@ 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 +You can also build the 32-bits GL wrapper on a 64-bits distribution, provided +you have a multilib gcc and 32-bits X11 libraries, by doing: + + cmake \ + -DCMAKE_C_FLAGS=-m32 \ + -DCMAKE_CXX_FLAGS=-m32 \ + -DCMAKE_EXE_LINKER_FLAGS=-m32 \ + -DCMAKE_SYSTEM_LIBRARY_PATH=/usr/lib32 \ + -DENABLE_GUI=FALSE \ + -H. -Bbuild32 make -C build32 glxtrace +The `/usr/lib32` refers to the path where the 32-bits shared objects are may +differ depending on the actual Linux distribution. + + Android ------- @@ -64,20 +75,27 @@ Windows Additional requirements: -* Microsoft Visual Studio (tested with 2008 version) or MinGW (tested with gcc version 4.4) +* For Direct3D 11.1 support: + + * [Microsoft Visual Studio 11 Ultimate Beta](http://www.microsoft.com/download/en/details.aspx?id=27543) + +* Other: + + * Microsoft Visual Studio (tested with 2010 version) or MinGW (tested with + mingw-w64's gcc version 4.6.2) -* Microsoft DirectX SDK: + * [Microsoft DirectX SDK](http://msdn.microsoft.com/en-us/directx/aa937781): - * for D3D10 support the [latest](http://msdn.microsoft.com/en-us/directx/default.aspx) is - recommended. + * for D3D 10, 10.1, and 11 support the [June 2010 release](http://www.microsoft.com/en-us/download/details.aspx?id=6812) is + recommended. - * for DDRAW, D3D7, D3D8 support the [August 2007 release](http://www.microsoft.com/downloads/details.aspx?familyid=529F03BE-1339-48C4-BD5A-8506E5ACF571) - or earlier is required, as later releases do not include the necessary - headers. + * for D3D7, D3D8 support the [August 2007 release](http://www.microsoft.com/downloads/details.aspx?familyid=529F03BE-1339-48C4-BD5A-8506E5ACF571) + 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 + cmake-gui -H%cd% -B%cd%\build and press the _Configure_ button. @@ -86,14 +104,14 @@ 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: +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 9 -2008 Win64_ instead of _Visual Studio 9 2008_. +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 +It's also possible to instruct CMake build Windows binaries on Linux with [MinGW cross compilers](http://www.cmake.org/Wiki/CmakeMingw).