Use a simple CSS style sheet.
[mesa.git] / docs / download.html
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>
12 Mesa can be downloaded from the
13 <a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">
14 SourceForge download area</A>.
15 </p>
16
17 <p>
18 Since version 2.3, Mesa is distributed in two pieces: main library code
19 and demos. If you're upgrading from a previous version of Mesa or you're not
20 interested in the demos you can just download the core Mesa archive file.
21 </p>
22
23 <p>
24 Mesa is available in at least three archive formats:
25 </p>
26
27 <pre>
28 1. 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
43 2. 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
50 3. 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>
59 After unpacking you'll have these directories (and more):
60 </p>
61 <pre>
62 Makefile.X11 - top-level Makefile for X11-based systems
63 Make-config - system configurations used by the Makefile.X11
64 include/ - GL header (include) files
65 bin/ - shell scripts for making shared libraries, etc
66 lib/ - final client libraries, created during compilation
67 docs/ - documentation
68 src/ - source code for libraries
69 src/mesa - sources for the main Mesa library and device drivers
70 src/glu - libGLU source code
71 src/glw - Xt/Motif/OpenGL widget code
72
73
74 and if you downloaded and unpacked the MesaDemos.X.Y archive:
75
76 src/glut - GLUT source code
77 progs/ - OpenGL programs
78 progs/demos - original Mesa demos
79 progs/xdemos - GLX OpenGL/Mesa demos
80 progs/redbook - examples from the OpenGL Programming Guide
81 progs/samples - examples from SGI
82 progs/images/ - image files
83
84 </pre>
85
86 <p>
87 Proceed to <a href="install.html">compilation and installation
88 instructions</a>.
89 </p>
90
91 <H1>GLUT</H1>
92
93 <p>
94 Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
95 GLUT is built automatically on systems which support it.
96 </p>
97 <p>
98 The GLUT tests, demos, examples, etc are not included, just the main library.
99 To obtain the latest complete release of GLUT please visit the
100 <a href="http://www.opengl.org/resources/libraries/glut.html"
101 target ="_parent">GLUT page</a> on www.opengl.org.
102 </p>
103
104
105 </BODY>
106 </HTML>