• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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>
12Primary Mesa download site:
13<a href="ftp://ftp.freedesktop.org/pub/mesa/"
14target="_parent">freedesktop.org</a> (FTP)
15</p>
16
17<p>
18When a new release is coming, release candidates (betas) may be found
19<a href="ftp://ftp.freedesktop.org/pub/mesa/beta/" target="_parent">here</a>.
20</p>
21
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
32    <a href="http://www.opengl.org/resources/libraries/glut"
33    target="_parent">original GLUT by Mark Kilgard</a> or
34    <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
35    <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
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>
48If you're new to this and not sure what you're doing, grab all three packages.
49</p>
50
51<p>
52The packages are available in .tar.gz, .tar.bz2 and .zip formats.
53Other sites might offer additional package formats.
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:
64<pre>
65	tar zxf MesaLib-X.Y.tar.gz
66	tar zxf MesaDemos-X.Y.tar.gz
67	tar zxf MesaGLUT-X.Y.tar.gz
68</pre>
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>
97
98<p>
99After unpacking you'll have these files and directories (among others):
100</p>
101<pre>
102Makefile	- top-level Makefile for most systems
103configs/	- makefile parameter files for various systems
104include/	- GL header (include) files
105bin/		- shell scripts for making shared libraries, etc
106docs/		- documentation
107src/		- source code for libraries
108src/mesa	- sources for the main Mesa library and device drivers
109src/glu		- libGLU source code
110src/glx		- sources for building libGL with full GLX and DRI support
111src/glw		- Xt/Motif/OpenGL widget code
112</pre>
113
114If you downloaded and unpacked the MesaDemos.X.Y package:
115
116<pre>
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
122</pre>
123
124If you downloaded and unpacked the MesaGLUT.X.Y package:
125<pre>
126src/glut	- GLUT library source code
127</pre>
128
129<p>
130Proceed to the <a href="install.html">compilation and installation
131instructions</a>.
132</p>
133
134
135</BODY>
136</HTML>
137