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