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