blob: 9533fb81c255aa9804441a350538ef3ce93a68b5 [file] [log] [blame]
Brian Paul0b27ace2003-03-08 17:38:57 +00001<HTML>
2
3<TITLE>Getting Mesa</TITLE>
4
Brian Paul36da0452005-01-20 03:55:10 +00005<link rel="stylesheet" type="text/css" href="mesa.css"></head>
6
7<BODY>
Brian Paul0b27ace2003-03-08 17:38:57 +00008
Brian Paul7f8cb302005-09-10 16:57:22 +00009<H1>Downloading</H1>
Brian Paul0b27ace2003-03-08 17:38:57 +000010
11<p>
Brian5d735022008-04-04 19:26:29 -060012Last stable release: <b>7.0.3</b>
Brian Paul0b27ace2003-03-08 17:38:57 +000013</p>
14
15<p>
Brian Paul7f8cb302005-09-10 16:57:22 +000016Primary download site:
17<a href="http://sourceforge.net/project/showfiles.php?group_id=3"
18target="_parent">SourceForge</a>
Brian Paul0b27ace2003-03-08 17:38:57 +000019</p>
20
Brian Paul3491cbe2008-06-21 10:14:22 -060021<p>
22When a new release is coming, release candidates (betas) can be found
23<a href="http://www.mesa3d.org/beta/">here</a>.
24</p>
25
Brian Paul7f8cb302005-09-10 16:57:22 +000026
27<p>
28Mesa is distributed in several parts:
29</p>
30<ul>
31<li><b>MesaLib-x.y.z</b> - the main Mesa library source code, drivers
32 and documentation.
33</li>
34<li><b>MesaDemos-x.y.z</b> - OpenGL demonstration and test programs.
35 Most of the programs require GLUT (either the
Brian Paul3cb56802006-06-23 15:27:32 +000036 <a href="http://www.opengl.org/resources/libraries/glut"
Brian Paul7f8cb302005-09-10 16:57:22 +000037 target="_parent">original GLUT by Mark Kilgard</a> or
38 <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
Brian Paul3cb56802006-06-23 15:27:32 +000039 <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
Brian Paul7f8cb302005-09-10 16:57:22 +000040</li>
41<li><b>MesaGLUT-x.y.z</b> - Mark Kilgard's GLUT, easily compiled and used
42 with Mesa. Plus, other implementation of GLUT for DOS, OS/2, BeOS, etc.
43</li>
44</ul>
45
46<p>
47If you're not interested in running the demos, you'll only need the first
48package.
49</p>
50
51<p>
Brian Pauld9eff8b2006-07-12 20:14:43 +000052If you're new to this and not sure what you're doing, grab all three packages.
53</p>
54
55<p>
Brian Paul7f8cb302005-09-10 16:57:22 +000056The packages are available in .tar.gz, .tar.bz2 and .zip formats.
Brian Pauld9eff8b2006-07-12 20:14:43 +000057Other sites might offer additional package formats.
Brian Paul7f8cb302005-09-10 16:57:22 +000058</p>
59
60<H1>Unpacking</H1>
61
62<p>
63All the packages should be in the same directory prior to unpacking.
64</p>
65
66<ul>
67<li>To unpack .tar.gz files:
Brian Paul0b27ace2003-03-08 17:38:57 +000068<pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000069 tar zxf MesaLib-X.Y.tar.gz
70 tar zxf MesaDemos-X.Y.tar.gz
71 tar zxf MesaGLUT-X.Y.tar.gz
Brian Paul0b27ace2003-03-08 17:38:57 +000072</pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000073or
74<pre>
75 gzcat MesaLib-X.Y.tar.gz | tar xf -
76 gzcat MesaDemos-X.Y.tar.gz | tar xf -
77 gzcat MesaGLUT-X.Y.tar.gz | tar xf -
78</pre>
79or
80<pre>
81 gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
82 gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaDemos-X.Y.tar
83 gunzip MesaGLUT-X.Y.tar.gz ; tar xf MesaGLUT-X.Y.tar
84</pre>
85<li>To unpack .tar.bz2 files:
86<pre>
87 bunzip2 -c MesaLib-X.Y.tar.gz | tar xf -
88 bunzip2 -c MesaDemos-X.Y.tar.gz | tar xf -
89 bunzip2 -c MesaGLUT-X.Y.tar.gz | tar xf -
90</pre>
91<li>To unpack .zip files:
92<pre>
93 unzip MesaLib-X.Y.zip
94 unzip MesaDemos-X.Y.zip
95 unzip MesaGLUT-X.Y.zip
96</pre>
97</ul>
98
99
100<h1>Contents</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +0000101
102<p>
Brian Pauld9eff8b2006-07-12 20:14:43 +0000103After unpacking you'll have these files and directories (among others):
Brian Paul0b27ace2003-03-08 17:38:57 +0000104</p>
105<pre>
Brian Paul7f8cb302005-09-10 16:57:22 +0000106Makefile - top-level Makefile for most systems
107configs/ - makefile parameter files for various systems
Brian Paul0b27ace2003-03-08 17:38:57 +0000108include/ - GL header (include) files
Brian Paulafc04282003-09-03 23:04:31 +0000109bin/ - shell scripts for making shared libraries, etc
Brian Paul0b27ace2003-03-08 17:38:57 +0000110docs/ - documentation
Brian Paulafc04282003-09-03 23:04:31 +0000111src/ - source code for libraries
112src/mesa - sources for the main Mesa library and device drivers
113src/glu - libGLU source code
Brian Pauld9eff8b2006-07-12 20:14:43 +0000114src/glx - sources for building libGL with full GLX and DRI support
Brian Paulafc04282003-09-03 23:04:31 +0000115src/glw - Xt/Motif/OpenGL widget code
Brian Paul7f8cb302005-09-10 16:57:22 +0000116</pre>
Brian Paulafc04282003-09-03 23:04:31 +0000117
Brian Paul7f8cb302005-09-10 16:57:22 +0000118If you downloaded and unpacked the MesaDemos.X.Y package:
Brian Paul0b27ace2003-03-08 17:38:57 +0000119
Brian Paul7f8cb302005-09-10 16:57:22 +0000120<pre>
Brian Paulafc04282003-09-03 23:04:31 +0000121progs/demos - original Mesa demos
122progs/xdemos - GLX OpenGL/Mesa demos
123progs/redbook - examples from the OpenGL Programming Guide
124progs/samples - examples from SGI
125progs/images/ - image files
Brian Paul7f8cb302005-09-10 16:57:22 +0000126</pre>
Brian Paul0b27ace2003-03-08 17:38:57 +0000127
Brian Paul7f8cb302005-09-10 16:57:22 +0000128If you downloaded and unpacked the MesaGLUT.X.Y package:
129<pre>
130src/glut - GLUT library source code
Brian Paul0b27ace2003-03-08 17:38:57 +0000131</pre>
132
133<p>
Brian Paul7f8cb302005-09-10 16:57:22 +0000134Proceed to the <a href="install.html">compilation and installation
Brian Paul0b27ace2003-03-08 17:38:57 +0000135instructions</a>.
136</p>
137
Brian Paul0b27ace2003-03-08 17:38:57 +0000138
139</BODY>
140</HTML>