Cross compiling Mesa for Windows

Cross compiling Mesa for Windows

QtQuick 2.0 applications require OpenGL 2.1 or higher to run. Windows only provides OpenGL 1.1 by default, which is not sufficient. One workaround is to use ANGLE which implements the OpenGL ES 2 API on top of DirectX 9. The benefit of using ANGLE is that the graphics are hardware-accelerated but ANGLE requires Windows Vista or later. The other option is to use a software renderer such as Mesa which can run on Windows XP or later and may perform better than ANGLE when running inside virtual machines.

This article describes the process of cross-compiling Mesa for Windows on Arch Linux. The result is an opengl32.dll DLL that you can copy to the folder containing your application's executable to use Mesa LLVMpipe software rendering.

Cross compiling is currently the only method that can compile the latest versions of Mesa for Windows using GCC. Compiling Mesa natively on Windows using GCC with Scons results in "the command line is too long" error during linking. There are known issues when compiling Mesa with optimizations using Visual Studio 2010. Compiling with Visual Studio 2012 is possible but requires Windows 7 and the default platform target does not support Windows XP. It is possible to cross compile using Cygwin or MSYS2 Scons.

Prebuilt binaries for Mesa are available from the MSYS2 project:
* "Mesa 10.0.2 for Windows 32-bit binary":http://downloads.sourceforge.net/project/msys2/REPOS/MINGW/i686/mingw-w64-i686-mesa-10.0.2-1-any.pkg.tar.xz
* "Mesa 10.0.2 for Windows 64-bit binary":http://downloads.sourceforge.net/project/msys2/REPOS/MINGW/x86_64/mingw-w64-x86_64-mesa-10.0.2-1-any.pkg.tar.xz

Install required Arch Linux packages

<br />sudo pacman -S base-devel mingw-w64-toolchain libxml2 python2 scons<br />

Compiling for Windows 32-bit

Create a working directory for build

<br />mkdir <sub>/mesa_win32<br />cd</sub>/mesa_win32<br />

Download LLVM and Mesa sources

<br />wget http://llvm.org/releases/3.4/llvm-3.4.src.tar.gz<br />wget ftp://ftp.freedesktop.org/pub/mesa/10.0.2/MesaLib-10.0.2.tar.bz2<br />

Extract sources

<br />tar -xvf llvm-3.4.src.tar.gz<br />tar -xvf MesaLib-10.0.2.tar.bz2<br />

Build LLVM

<br />cd <sub>/mesa_win32/llvm-3.4<br />export PYTHON=/usr/bin/python2<br />mkdir build<br />cd build<br />echo 'ac_cv_have_decl_strerror_s=${ac_cv_have_decl_strerror_s=no}' &gt; config.cache<br />../configure -C —prefix=$HOME/mesa_win32/llvm-3.4.build —host=i686-w64-mingw32 —enable-optimized —disable-assertions —disable-pthreads —enable-targets=x86 —enable-bindings=none —disable-libffi —with-c-include-dirs=/usr/i686-w64-mingw32 —with-gcc-toolchain=/usr/i686-w64-mingw32 —with-default-sysroot=/usr/i686-w64-mingw32<br />make<br />make install<br />

Note: Use of the strerror_s function is disabled by writing an entry to config.cache for Windows XP compatibility.
h3. Build Mesa

<br />cd</sub>/mesa_win32/Mesa-10.0.2<br />export LLVM=$HOME/mesa_win32/llvm-3.4.build<br />LDFLAGS=&quot;-static -s&amp;quot; scons build=release platform=windows toolchain=crossmingw machine=x86 libgl-gdi<br />mkdir <sub>/mesa_win32/dist<br />cp -a build/windows-x86/gallium/targets/libgl-gdi/opengl32.dll</sub>/mesa_win32/dist/<br />

Complete

You can now copy opengl32.dll from the _{/mesa_win32/dist folder to the folder containing your application's executable.
Your Qt must be compiled with Desktop OpenGL to use opengl32.dll. The ANGLE build will not load the mesa library.
h2. Compiling for Windows 64-bit
h3. Create a working directory for build}

<br />mkdir</sub>/mesa_win64<br />cd <sub>/mesa_win64<br />

h3. Download LLVM and Mesa sources

<br />wget http://llvm.org/releases/3.4/llvm-3.4.src.tar.gz<br />wget ftp://ftp.freedesktop.org/pub/mesa/10.0.2/MesaLib-10.0.2.tar.bz2<br />

h3. Extract sources

<br />tar -xvf llvm-3.4.src.tar.gz<br />tar -xvf MesaLib-10.0.2.tar.bz2<br />

h2. Build LLVM

<br />cd</sub>/mesa_win64/llvm-3.4<br />export PYTHON=/usr/bin/python2<br />mkdir build<br />cd build<br />echo 'ac_cv_have_decl_strerror_s=${ac_cv_have_decl_strerror_s=no}' &gt; config.cache<br />../configure -C —prefix=$HOME/mesa_win64/llvm-3.4.build —host=x86_64-w64-mingw32 —enable-optimized —disable-assertions —disable-pthreads —enable-targets=x86_64 —enable-bindings=none —disable-libffi —with-c-include-dirs=/usr/x86_64-w64-mingw32 —with-gcc-toolchain=/usr/x86_64-w64-mingw32 —with-default-sysroot=/usr/x86_64-w64-mingw32<br />make<br />make install<br />

Note: Use of the strerror_s function is disabled by writing an entry to config.cache for Windows XP x64 compatibility.

Build Mesa

<br />cd <sub>/mesa_win64/Mesa-10.0.2<br />LDFLAGS=&quot;-static -s&amp;quot; scons build=release platform=windows toolchain=crossmingw machine=x86_64 libgl-gdi<br />mkdir</sub>/mesa_win64/dist<br />cp -a build/windows-x86_64/gallium/targets/libgl-gdi/opengl32.dll <sub>/mesa_win64/dist/<br />

h3. Complete
You can now copy opengl32.dll from the/mesa_win64/dist folder to the folder containing your application's executable.