Add glXAllocateMemoryMESA demo app using ycbcr...
[mesa-demos.git] / docs / download.html
blobb30b98ff9beaf320b4ee11def162b65ab1623ac2
1 <HTML>
3 <TITLE>Getting Mesa</TITLE>
5 <link rel="stylesheet" type="text/css" href="mesa.css"></head>
7 <BODY>
9 <H1>Downloading / Unpacking</H1>
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>
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>
23 <p>
24 Mesa is available in at least three archive formats:
25 </p>
27 <pre>
28 1. GNU zip/tar
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 -
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
38 tar zxf MesaLib-X.Y.tar.gz
39 tar zxf MesaDemos-X.Y.tar.gz
41 If you don't have gzcat try zcat instead.
43 2. Unix compressed/tar
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 -
50 3. ZIP format
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>
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
74 and if you downloaded and unpacked the MesaDemos.X.Y archive:
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
84 </pre>
86 <p>
87 Proceed to <a href="install.html">compilation and installation
88 instructions</a>.
89 </p>
91 <H1>GLUT</H1>
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>
105 </BODY>
106 </HTML>