Awesome
osmesa-install
Script and patches to build and install variations of OSMesa http://www.mesa3d.org/osmesa.html:
- "mangled" or not (in mangled OSMesa, all functions start with
mgl
instead ofgl
) - debug or not
- choice of osmesa driver:
swrast
,softpipe
,llvmpipe
orswr
(SWR is not yet supported on macOS) - possibility to also compile and install LLVM 6.0.1, 4.0.1 or 3.4.2 for the
llvmpipe
driver
Usage
- edit variables / paths as the beginning of the
osmesa-install.sh
script - compile and install:
mkdir build
cd build
sh ../osmesa-install.sh
- there is a test program on the
osdemo
directory, with a few checks
Notes and caveats
The latest Mesa version that can be built using this script is 18.3.6.
The reasons are:
- Mesa dropped autoconf support with 19.0, supporting only meson and SCons builds. SCons support was also dropped in 21.1. Mangled OSMesa support was only accessible from autoconf and SCons, but it is just a matter of adding
-DUSE_MGL_NAMESPACE
toCPPFLAGS
, so it should still be possible to easily get mangled OSMesa using meson. - Source support for GL symbol mangling support was dropped with 19.2.2 (commit, relnotes). Re-adding it means we would have to maintain that large patch.
- The legacy
swrast
driver was dropped in Mesa 21.0.0.
An upstream bug was filed (original bug) to integrate at least the thread-safety fixes into Mesa, but it may require some work to port to the latest version of Mesa.
Pick the rigght LLVM version for your build:
- Mesa 17.1.10 - 17.3.9 were tested with LLVM 4.0.1.
- Mesa 18.0.4 - 18.3.6 were tested with LLVM 6.0.1.
- LLVM 9 and LLVM 13 hang in osdemo16 for Mesa versions up to 18.2.8 (Mesa 18.3.6 seems to run OK).
The script fixes the following Mesa bugs related to mangled OSMesa:
Also note that the latest clang (tested with 4.0.0) does not build on 32 bits mingw64 due to the following gcc bug (older versions of clang work):