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