blob: 22a22e6d57a0b84b690671f4495b659bd433bc5a [file] [log] [blame]
Brian Paul0b27ace2003-03-08 17:38:57 +00001<HTML>
2
3<TITLE>Getting Mesa</TITLE>
4
5<BODY text="#000000" bgcolor="#55bbff" link="#111188">
6
7<H1>Downloading / Unpacking</H1>
8
9<p>
10Mesa can be downloaded from the
11<a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">
12SourceForge download area</A>.
13</p>
14
15<p>
16Since version 2.3, Mesa is distributed in two pieces: main library code
17and demos. If you're upgrading from a previous version of Mesa or you're not
18interested in the demos you can just download the core Mesa archive file.
19</p>
20
21<p>
22Mesa is available in at least three archive formats:
23</p>
24
25<pre>
261. GNU zip/tar
27
28 Download MesaLib-X.Y.tar.gz and optionally MesaDemos-X.Y.tar.gz
29 Unpack with:
30 gzcat MesaLib-X.Y.tar.gz | tar xf -
31 gzcat MesaDemos-X.Y.tar.gz | tar xf -
32 or
33 gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
34 gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
35 or
36 tar zxf MesaLib-X.Y.tar.gz
37 tar zxf MesaDemos-X.Y.tar.gz
38
39 If you don't have gzcat try zcat instead.
40
412. Unix compressed/tar
42
43 Download MesaLib-X.Y.tar.Z and optionally MesaDemos-X.Y.tar.Z
44 Unpack with:
45 zcat MesaLib-X.Y.tar.Z | tar xf -
46 zcat MesaDemos-X.Y.tar.Z | tar xf -
47
483. ZIP format
49
50 Download MesaLib-X.Y.zip and optionally MesaDemos-X.Y.zip
51 Unpack with:
52 unzip MesaLib-X.Y.zip
53 unzip MesaDemos-X.Y.zip
54</pre>
55
56<p>
57After unpacking you'll have these directories (and more):
58</p>
59<pre>
Brian Paulafc04282003-09-03 23:04:31 +000060Makefile.X11 - top-level Makefile for X11-based systems
Brian Paul0b27ace2003-03-08 17:38:57 +000061Make-config - system configurations used by the Makefile.X11
Brian Paul0b27ace2003-03-08 17:38:57 +000062include/ - GL header (include) files
Brian Paulafc04282003-09-03 23:04:31 +000063bin/ - shell scripts for making shared libraries, etc
64lib/ - final client libraries, created during compilation
Brian Paul0b27ace2003-03-08 17:38:57 +000065docs/ - documentation
Brian Paulafc04282003-09-03 23:04:31 +000066src/ - source code for libraries
67src/mesa - sources for the main Mesa library and device drivers
68src/glu - libGLU source code
69src/glw - Xt/Motif/OpenGL widget code
70
Brian Paul0b27ace2003-03-08 17:38:57 +000071
Brian Paulb0eee792003-03-16 16:43:04 +000072and if you downloaded and unpacked the MesaDemos.X.Y archive:
Brian Paul0b27ace2003-03-08 17:38:57 +000073
Brian Paulafc04282003-09-03 23:04:31 +000074src/glut - GLUT source code
75progs/ - OpenGL programs
76progs/demos - original Mesa demos
77progs/xdemos - GLX OpenGL/Mesa demos
78progs/redbook - examples from the OpenGL Programming Guide
79progs/samples - examples from SGI
80progs/images/ - image files
Brian Paul0b27ace2003-03-08 17:38:57 +000081
82</pre>
83
84<p>
85Proceed to <a href="install.html">compilation and installation
86instructions</a>.
87</p>
88
89<H1>GLUT</H1>
90
91<p>
92Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
93GLUT is built automatically on systems which support it.
94</p>
95<p>
96The GLUT tests, demos, examples, etc are not included, just the main library.
97To obtain the latest complete release of GLUT please visit the
98<a href="http://www.opengl.org/developers/documentation/glut/index.html"
99target ="_parent">GLUT homepage</a>
100</p>
101
102
103</BODY>
104</HTML>