download.html revision 36da0459e4d0b12ab46f0e2090d107a22f68844a 
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 / Unpacking</H1>
10
11<p>
12Mesa can be downloaded from the
13<a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">
14SourceForge download area</A>.
15</p>
16
17<p>
18Since version 2.3, Mesa is distributed in two pieces:  main library code
19and demos.  If you're upgrading from a previous version of Mesa or you're not
20interested in the demos you can just download the core Mesa archive file.
21</p>
22
23<p>
24Mesa is available in at least three archive formats:
25</p>
26
27<pre>
281. GNU zip/tar
29
30	Download MesaLib-X.Y.tar.gz and optionally MesaDemos-X.Y.tar.gz
31	Unpack with:
32		gzcat MesaLib-X.Y.tar.gz | tar xf -
33		gzcat MesaDemos-X.Y.tar.gz | tar xf -
34	or
35		gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
36		gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
37	or
38		tar zxf MesaLib-X.Y.tar.gz
39		tar zxf MesaDemos-X.Y.tar.gz
40
41	If you don't have gzcat try zcat instead.
42
432. Unix compressed/tar
44
45	Download MesaLib-X.Y.tar.Z and optionally MesaDemos-X.Y.tar.Z
46	Unpack with:
47		zcat MesaLib-X.Y.tar.Z | tar xf -
48		zcat MesaDemos-X.Y.tar.Z | tar xf -
49
503. ZIP format
51
52	Download MesaLib-X.Y.zip and optionally MesaDemos-X.Y.zip
53	Unpack with:
54		unzip MesaLib-X.Y.zip
55		unzip MesaDemos-X.Y.zip
56</pre>
57
58<p>
59After unpacking you'll have these directories (and more):
60</p>
61<pre>
62Makefile.X11	- top-level Makefile for X11-based systems
63Make-config	- system configurations used by the Makefile.X11
64include/	- GL header (include) files
65bin/		- shell scripts for making shared libraries, etc
66lib/		- final client libraries, created during compilation
67docs/		- documentation
68src/		- source code for libraries
69src/mesa	- sources for the main Mesa library and device drivers
70src/glu		- libGLU source code
71src/glw		- Xt/Motif/OpenGL widget code
72
73
74and if you downloaded and unpacked the MesaDemos.X.Y archive:
75
76src/glut	- GLUT source code
77progs/		- OpenGL programs
78progs/demos	- original Mesa demos
79progs/xdemos	- GLX OpenGL/Mesa demos
80progs/redbook	- examples from the OpenGL Programming Guide
81progs/samples	- examples from SGI
82progs/images/	- image files
83
84</pre>
85
86<p>
87Proceed to <a href="install.html">compilation and installation
88instructions</a>.
89</p>
90
91<H1>GLUT</H1>
92
93<p>
94Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
95GLUT is built automatically on systems which support it.
96</p>
97<p>
98The GLUT tests, demos, examples, etc are not included, just the main library.
99To obtain the latest complete release of GLUT please visit the
100<a href="http://www.opengl.org/resources/libraries/glut.html"
101target ="_parent">GLUT page</a> on www.opengl.org.
102</p>
103
104
105</BODY>
106</HTML>
107