Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / mesa3d / 4c31632817a0bde28ad6c9ee8032d838ce4b7bfb / . / docs / download.html
blob: cf1cc21d3744666d65a4c923099c0d2ffb2adec8 [file] [log] [blame]
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]1<HTML>
2
3<TITLE>Getting Mesa</TITLE>
4
Brian Paul36da0452005-01-20 03:55:10 +0000[diff] [blame]5<link rel="stylesheet" type="text/css" href="mesa.css"></head>
6
7<BODY>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]8
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]9<H1>Downloading</H1>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]10
11<p>
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]12Primary download site:
13<a href="http://sourceforge.net/project/showfiles.php?group_id=3"
14target="_parent">SourceForge</a>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]15</p>
16
Brian Paul3491cbe2008-06-21 10:14:22 -0600[diff] [blame]17<p>
18When a new release is coming, release candidates (betas) can be found
19<a href="http://www.mesa3d.org/beta/">here</a>.
20</p>
21
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]22
23<p>
24Mesa is distributed in several parts:
25</p>
26<ul>
27<li><b>MesaLib-x.y.z</b> - the main Mesa library source code, drivers
28 and documentation.
29</li>
30<li><b>MesaDemos-x.y.z</b> - OpenGL demonstration and test programs.
31 Most of the programs require GLUT (either the
Brian Paul3cb56802006-06-23 15:27:32 +0000[diff] [blame]32 <a href="http://www.opengl.org/resources/libraries/glut"
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]33 target="_parent">original GLUT by Mark Kilgard</a> or
34 <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
Brian Paul3cb56802006-06-23 15:27:32 +0000[diff] [blame]35 <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]36</li>
37<li><b>MesaGLUT-x.y.z</b> - Mark Kilgard's GLUT, easily compiled and used
38 with Mesa. Plus, other implementation of GLUT for DOS, OS/2, BeOS, etc.
39</li>
40</ul>
41
42<p>
43If you're not interested in running the demos, you'll only need the first
44package.
45</p>
46
47<p>
Brian Pauld9eff8b2006-07-12 20:14:43 +0000[diff] [blame]48If you're new to this and not sure what you're doing, grab all three packages.
49</p>
50
51<p>
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]52The packages are available in .tar.gz, .tar.bz2 and .zip formats.
Brian Pauld9eff8b2006-07-12 20:14:43 +0000[diff] [blame]53Other sites might offer additional package formats.
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]54</p>
55
56<H1>Unpacking</H1>
57
58<p>
59All the packages should be in the same directory prior to unpacking.
60</p>
61
62<ul>
63<li>To unpack .tar.gz files:
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]64<pre>
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]65 tar zxf MesaLib-X.Y.tar.gz
66 tar zxf MesaDemos-X.Y.tar.gz
67 tar zxf MesaGLUT-X.Y.tar.gz
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]68</pre>
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]69or
70<pre>
71 gzcat MesaLib-X.Y.tar.gz | tar xf -
72 gzcat MesaDemos-X.Y.tar.gz | tar xf -
73 gzcat MesaGLUT-X.Y.tar.gz | tar xf -
74</pre>
75or
76<pre>
77 gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
78 gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaDemos-X.Y.tar
79 gunzip MesaGLUT-X.Y.tar.gz ; tar xf MesaGLUT-X.Y.tar
80</pre>
81<li>To unpack .tar.bz2 files:
82<pre>
83 bunzip2 -c MesaLib-X.Y.tar.gz | tar xf -
84 bunzip2 -c MesaDemos-X.Y.tar.gz | tar xf -
85 bunzip2 -c MesaGLUT-X.Y.tar.gz | tar xf -
86</pre>
87<li>To unpack .zip files:
88<pre>
89 unzip MesaLib-X.Y.zip
90 unzip MesaDemos-X.Y.zip
91 unzip MesaGLUT-X.Y.zip
92</pre>
93</ul>
94
95
96<h1>Contents</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]97
98<p>
Brian Pauld9eff8b2006-07-12 20:14:43 +0000[diff] [blame]99After unpacking you'll have these files and directories (among others):
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]100</p>
101<pre>
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]102Makefile - top-level Makefile for most systems
103configs/ - makefile parameter files for various systems
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]104include/ - GL header (include) files
Brian Paulafc04282003-09-03 23:04:31 +0000[diff] [blame]105bin/ - shell scripts for making shared libraries, etc
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]106docs/ - documentation
Brian Paulafc04282003-09-03 23:04:31 +0000[diff] [blame]107src/ - source code for libraries
108src/mesa - sources for the main Mesa library and device drivers
109src/glu - libGLU source code
Brian Pauld9eff8b2006-07-12 20:14:43 +0000[diff] [blame]110src/glx - sources for building libGL with full GLX and DRI support
Brian Paulafc04282003-09-03 23:04:31 +0000[diff] [blame]111src/glw - Xt/Motif/OpenGL widget code
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]112</pre>
Brian Paulafc04282003-09-03 23:04:31 +0000[diff] [blame]113
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]114If you downloaded and unpacked the MesaDemos.X.Y package:
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]115
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]116<pre>
Brian Paulafc04282003-09-03 23:04:31 +0000[diff] [blame]117progs/demos - original Mesa demos
118progs/xdemos - GLX OpenGL/Mesa demos
119progs/redbook - examples from the OpenGL Programming Guide
120progs/samples - examples from SGI
121progs/images/ - image files
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]122</pre>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]123
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]124If you downloaded and unpacked the MesaGLUT.X.Y package:
125<pre>
126src/glut - GLUT library source code
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]127</pre>
128
129<p>
Brian Paul7f8cb302005-09-10 16:57:22 +0000[diff] [blame]130Proceed to the <a href="install.html">compilation and installation
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]131instructions</a>.
132</p>
133
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]134
135</BODY>
136</HTML>