install.html revision df2be226d9ca6772eb4615ce0670e66667b86691
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html lang="en"> 3<head> 4 <meta http-equiv="content-type" content="text/html; charset=utf-8"> 5 <title>Compiling and Installing</title> 6 <link rel="stylesheet" type="text/css" href="mesa.css"> 7</head> 8<body> 9 10<h1>Compiling and Installing</h1> 11 12<ol> 13<li><a href="#prereq-general">Prerequisites for building</a> 14 <ul> 15 <li><a href="#prereq-general">General prerequisites</a> 16 <li><a href="#prereq-dri">For DRI and hardware acceleration</a> 17 </ul> 18<li><a href="#autoconf">Building with autoconf (Linux/Unix/X11)</a> 19<li><a href="#scons">Building with SCons (Windows/Linux)</a> 20<li><a href="#other">Building for other systems</a> 21<li><a href="#libs">Library Information</a> 22<li><a href="#pkg-config">Building OpenGL programs with pkg-config</a> 23</ol> 24 25 26<a name="prereq-general"> 27<h1>1. Prerequisites for building</h1> 28 29<h2>1.1 General</h2> 30<ul> 31<li>lex / yacc - for building the GLSL compiler. 32On Linux systems, flex and bison are used. 33Versions 2.5.35 and 2.4.1, respectively, (or later) should work. 34<br> 35<br> 36On Windows with MinGW, install flex and bison with: 37<pre>mingw-get install msys-flex msys-bison</pre> 38</li> 39<li>python - Python is needed for building the Gallium components. 40Version 2.6.4 or later should work. 41<br> 42<br> 43To build OpenGL ES 1.1 and 2.0 you'll also need 44<a href="http://xmlsoft.org/sources/win32/python/libxml2-python-2.7.7.win32-py2.7.exe">libxml2-python</a>. 45</li> 46</ul> 47 48 49<a name="prereq-dri"> 50<h3>1.2 For DRI and hardware acceleration</h3> 51 52<p> 53The following are required for DRI-based hardware acceleration with Mesa: 54</p> 55 56<ul> 57<li><a href="http://xorg.freedesktop.org/releases/individual/proto/" 58target="_parent">dri2proto</a> version 2.6 or later 59<li><a href="http://dri.freedesktop.org/libdrm/" target="_parent">libDRM</a> 60version 2.4.33 or later 61<li>Xorg server version 1.5 or later 62<li>Linux 2.6.28 or later 63</ul> 64<p> 65If you're using a fedora distro the following command should install all 66the needed dependencies: 67</p> 68<pre> 69 sudo yum install flex bison imake libtool xorg-x11-proto-devel libdrm-devel \ 70 gcc-c++ xorg-x11-server-devel libXi-devel libXmu-devel libXdamage-devel git \ 71 expat-devel llvm-devel 72</pre> 73 74 75 76<a name="autoconf"> 77<H1>2. Building with autoconf (Linux/Unix/X11)</H1> 78 79<p> 80The primary method to build Mesa on Unix systems is with autoconf. 81</p> 82 83<p> 84The general approach is the standard: 85</p> 86<pre> 87 /configure 88 make 89 sudo make install 90</pre> 91<p> 92But please read the <a href="autoconf.html">detailed autoconf instructions</a> 93for more details. 94</p> 95 96 97 98<a name="scons"> 99<H1>3. Building with SCons (Windows/Linux)</H1> 100 101<p> 102To build Mesa with SCons on Linux or Windows do 103</p> 104<pre> 105 scons 106</pre> 107<p> 108The build output will be placed in 109build/<i>platform</i>-<i>machine</i>-<i>debug</i>/..., where <i>platform</i> is for 110example linux or windows, <i>machine</i> is x86 or x86_64, optionally followed 111by -debug for debug builds. 112</p> 113 114<p> 115To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do 116</p> 117<pre> 118 scons platform=windows toolchain=crossmingw machine=x86 mesagdi libgl-gdi 119</pre> 120<p> 121This will create: 122</p> 123<ul> 124<li>build/windows-x86-debug/mesa/drivers/windows/gdi/opengl32.dll — Mesa + swrast, binary compatible with Windows's opengl32.dll 125<li>build/windows-x86-debug/gallium/targets/libgl-gdi/opengl32.dll — Mesa + Gallium + softpipe, binary compatible with Windows's opengl32.dll 126</ul> 127<p> 128Put them all in the same directory to test them. 129</p> 130 131 132 133<a name="other"> 134<H1>4. Building for other systems</H1> 135 136<p> 137Documentation for other environments (some may be very out of date): 138</p> 139 140<UL> 141<li><A HREF="README.VMS">README.VMS</A> - VMS 142<LI><A HREF="README.CYGWIN">README.CYGWIN</A> - Cygwin 143<LI><A HREF="README.WIN32">README.WIN32</A> - Win32 144</UL> 145 146 147 148<a name="libs"> 149<H1>5. Library Information</H1> 150 151<p> 152When compilation has finished, look in the top-level <code>lib/</code> 153(or <code>lib64/</code>) directory. 154You'll see a set of library files similar to this: 155</p> 156<pre> 157lrwxrwxrwx 1 brian users 10 Mar 26 07:53 libGL.so -> libGL.so.1* 158lrwxrwxrwx 1 brian users 19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100* 159-rwxr-xr-x 1 brian users 3375861 Mar 26 07:53 libGL.so.1.5.060100* 160lrwxrwxrwx 1 brian users 11 Mar 26 07:53 libGLU.so -> libGLU.so.1* 161lrwxrwxrwx 1 brian users 20 Mar 26 07:53 libGLU.so.1 -> libGLU.so.1.3.060100* 162-rwxr-xr-x 1 brian users 549269 Mar 26 07:53 libGLU.so.1.3.060100* 163lrwxrwxrwx 1 brian users 14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6* 164lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100* 165-rwxr-xr-x 1 brian users 23871 Mar 26 07:53 libOSMesa.so.6.1.060100* 166</pre> 167 168<p> 169<b>libGL</b> is the main OpenGL library (i.e. Mesa). 170<br> 171<b>libGLU</b> is the OpenGL Utility library. 172<br> 173<b>libOSMesa</b> is the OSMesa (Off-Screen) interface library. 174</p> 175 176<p> 177If you built the DRI hardware drivers, you'll also see the DRI drivers: 178</p> 179<pre> 180-rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i915_dri.so 181-rwxr-xr-x 1 brian users 16895413 Jul 21 12:11 i965_dri.so 182-rwxr-xr-x 1 brian users 11849858 Jul 21 12:12 r200_dri.so 183-rwxr-xr-x 1 brian users 16050488 Jul 21 12:11 r300_dri.so 184-rwxr-xr-x 1 brian users 11757388 Jul 21 12:12 radeon_dri.so 185</pre> 186 187<p> 188If you built with Gallium support, look in lib/gallium/ for Gallium-based 189versions of libGL and device drivers. 190</p> 191 192 193<a name="pkg-config"> 194<H1>6. Building OpenGL programs with pkg-config</H1> 195 196<p> 197Running <code>make install</code> will install package configuration files 198for the pkg-config utility. 199</p> 200 201<p> 202When compiling your OpenGL application you can use pkg-config to determine 203the proper compiler and linker flags. 204</p> 205 206<p> 207For example, compiling and linking a GLUT application can be done with: 208</p> 209<pre> 210 gcc `pkg-config --cflags --libs glut` mydemo.c -o mydemo 211</pre> 212 213<br> 214 215 216</body> 217</html> 218