Beyond Linux® From Scratch (systemd edition) - Version 7.6-systemd

Chapter 24. X Window System Environment

MesaLib-10.2.7

Introduction to MesaLib

Mesa is an OpenGL compatible 3D graphics library.

This package is known to build and work properly using an LFS-7.6 systemd platform.

Package Information

Additional Patch

MesaLib Dependencies

Required

libdrm-2.4.56, Python-2.7.8 and Xorg Libraries

Recommended

elfutils-0.160 (required for Radeon 3D drivers), libvdpau-0.8 (to build VDPAU drivers for supported hardware), LLVM-3.5.0 (required for Radeon 3D drivers and also for llvmpipe which is intended to be the fastest of the three sw rasterizers, see http://www.mesa3d.org/faq.html#part3) and Wayland-1.5.0 (required for libwayland-egl library which is used by many packages that use Wayland)

Optional

libclc (to build Radeon OpenCL library) and libomxil-bellagio (to build Radeon OpenMAX driver)

[Note]

Note

The instructions below assume that elfutils and LLVM are installed. You will need to modify the instructions if you choose not to install them. Please note that elfutils and LLVM are required for Radeon 3D drivers. For an explanation of Gallium please see https://en.wikipedia.org/wiki/Gallium3D.

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/mesalib

Installation of MesaLib

[Note]

Note

Unlike other packages, the MesaLib-10.2.7.tar.bz2 archive will extract to the Mesa-10.2.7 directory.

If you have downloaded the recommended patch, apply it by running the following command: 

patch -Np1 -i ../MesaLib-10.2.7-add_xdemos-1.patch

Install MesaLib by running the following commands: 

patch -Np1 -i ../MesaLib-10.2.7-upstream_fixes-1.patch &&

./autogen.sh CFLAGS="-O2" CXXFLAGS="-O2" \
            --prefix=/usr                \
            --sysconfdir=/etc            \
            --disable-gallium-egl        \
            --enable-texture-float       \
            --enable-gles1               \
            --enable-gles2               \
            --enable-osmesa              \
            --enable-xa                  \
            --enable-gbm                 \
            --enable-glx-tls             \
            --with-egl-platforms="drm,x11,wayland" \
            --with-gallium-drivers="nouveau,r300,r600,radeonsi,svga,swrast" &&
make

If you have applied the recommended patch, build the demo programs by running the following command: 

make -C xdemos DEMOS_PREFIX=/usr

This package does not come with a test suite.

Now, as the root user: 

make install

If you have built the demo programs, install them by running the following command as the root user: 

make -C xdemos DEMOS_PREFIX=/usr install

If desired, install the optional documentation by running the following commands as the root user: 

install -v -dm755 /usr/share/doc/MesaLib-10.2.7 &&
cp -rfv docs/* /usr/share/doc/MesaLib-10.2.7

Command Explanations

sed -e ...lp_bld_debug.cpp: Fix build problem introduced with LLVM-3.5.0.

CFLAGS="-O2" CXXFLAGS="-O2": By default, Autoconf sets CFLAGS and CXXFLAGS to "-g -O2". That results in binaries and libraries being built with debugging symbols which make them bigger. Override the default flags to omit -g compiler flag so the final libraries are smaller.

--disable-gallium-egl: This switch disables the egl_gallium loader in favor of egl_dri2 loader which supports both DRI and Gallium drivers.

--enable-texture-float: This switch enables floating-point textures and render buffers. Please consult docs/patents.txt to see if there are any legal issues if you use this feature.

--enable-gles1: This switch enables support for OpenGL ES 1.x API.

--enable-gles2: This switch enables support for OpenGL ES 2.x API.

--enable-osmesa: This switch enables building of the libOSMesa library.

--enable-xa: This switch enables building of the XA X Acceleration API (Required for VMware 3D Driver).

--enable-gbm: This switch enables building of the Mesa Graphics Buffer Manager library.

--enable-gallium-gbm: This switch enables optional GBM state tracker for Gallium.

--enable-glx-tls: This switch enables TLS (Thread Local Storage) support in GLX.

--with-egl-platforms="...": This parameter controls for which platforms EGL should be built. Available platforms are drm, x11 and wayland. Remove wayland from the list if you have not installed Wayland.

--with-gallium-drivers="...": This parameter controls which Gallium drivers should be built. Available drivers are: i915, ilo, nouveau, r300, r600, radeonsi, svga and swrast. You will need to remove r300, r600 and radeonsi from the list if you did not install elfutils and LLVM.

--enable-r600-llvm-compiler: Use this switch to enable experimental R600 LLVM backend for graphics shaders which claims to speed up the driver.

Contents

Installed Programs: glxgears and glxinfo
Installed Libraries: libEGL.so, libgbm.so, libglapi.so, libGLESv1_CM.so, libGLESv2.so, libGL.so, libOSMesa.so, libwayland-egl.so, and libxatracker.so
Installed Directories: /usr/include/EGL, /usr/include/GL, /usr/include/GLES, /usr/include/GLES2, /usr/include/GLES3, /usr/include/KHR, /usr/include/VG, /usr/lib/dri, /usr/lib/egl, /usr/lib/gallium-pipe, /usr/lib/gbm, /usr/lib/vdpau, and /usr/share/doc/MesaLib-10.2.7 (optional)

Short Descriptions

glxgears

is a GL demo useful for troubleshooting graphics problems.

glxinfo

is a diagnostic program that displays information about the graphics hardware and installed GL libraries.

libEGL.so

provides a native platform graphics interface as defined by the EGL-1.4 specification.

libgbm.so

is the Mesa Graphics Buffer Manager library.

libGLESv1_CM.so

is the Mesa OpenGL ES 1.1 library.

libGLES2.so

is the Mesa OpenGL ES 2.0 library.

libGL.so

is the main Mesa OpenGL library.

libOSMesa.so

is the Mesa Off-screen Rendering library.

libwayland-egl.so

is the Wayland specific EGL library.

libxatracker.so

is the Xorg Gallium3D acceleration library.

Last updated on 2014-09-13 08:29:21 -0700