1cbfded575d3d487b8da84b5ba73df678212de4c
[mesa.git] / docs / download.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html lang="en">
3 <head>
4 <meta http-equiv="content-type" content="text/html; charset=utf-8">
5 <title>Getting Mesa</title>
6 <link rel="stylesheet" type="text/css" href="mesa.css">
7 </head>
8 <body>
9
10 <div class="header">
11 <h1>The Mesa 3D Graphics Library</h1>
12 </div>
13
14 <iframe src="contents.html"></iframe>
15 <div class="content">
16
17 <h1>Downloading</h1>
18
19 <p>
20 Primary Mesa download site:
21 <a href="ftp://ftp.freedesktop.org/pub/mesa/">ftp.freedesktop.org</a> (FTP)
22 or <a href="https://mesa.freedesktop.org/archive/">mesa.freedesktop.org</a>
23 (HTTP).
24 </p>
25
26 <p>
27 Starting with the first release of 2017, Mesa's version scheme is
28 year-based. Filenames are in the form <tt>mesa-Y.N.P.tar.gz</tt>, where
29 <tt>Y</tt> is the year (two digits), <tt>N</tt> is an incremental number
30 (starting at 0) and <tt>P</tt> is the patch number (0 for the first
31 release, 1 for the first patch after that).
32 </p>
33
34 <p>
35 When a new release is coming, release candidates (betas) may be found
36 <a href="ftp://ftp.freedesktop.org/pub/mesa/beta/">here</a>.
37 </p>
38
39
40 <h1>Unpacking</h1>
41
42 <p>
43 Mesa releases are available in three formats: .tar.bz2, .tar.gz, and .zip
44 </p>
45
46 <p>
47 To unpack .tar.gz files:
48 </p>
49 <pre>
50 tar zxf MesaLib-x.y.z.tar.gz
51 </pre>
52 or
53 <pre>
54 gzcat MesaLib-x.y.z.tar.gz | tar xf -
55 </pre>
56 or
57 <pre>
58 gunzip MesaLib-x.y.z.tar.gz ; tar xf MesaLib-x.y.z.tar
59 </pre>
60 <p>
61 To unpack .tar.bz2 files:
62 </p>
63 <pre>
64 bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
65 </pre>
66 <p>
67 To unpack .zip files:
68 </p>
69 <pre>
70 unzip MesaLib-x.y.z.zip
71 </pre>
72
73
74 <h1>Contents</h1>
75
76 <p>
77 After unpacking you'll have these files and directories (among others):
78 </p>
79 <pre>
80 Makefile - top-level Makefile for most systems
81 configs/ - makefile parameter files for various systems
82 include/ - GL header (include) files
83 bin/ - shell scripts for making shared libraries, etc
84 docs/ - documentation
85 src/ - source code for libraries
86 src/mesa - sources for the main Mesa library and device drivers
87 src/gallium - sources for Gallium and Gallium drivers
88 src/glx - sources for building libGL with full GLX and DRI support
89 </pre>
90
91
92 <p>
93 Proceed to the <a href="install.html">compilation and installation
94 instructions</a>.
95 </p>
96
97
98 <h1>Demos, GLUT, and GLU</h1>
99
100 <p>
101 A package of SGI's GLU library is available
102 <a href="ftp://ftp.freedesktop.org/pub/mesa/glu/">here</a>
103 </p>
104
105 <p>
106 A package of Mark Kilgard's GLUT library is available
107 <a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>
108 </p>
109
110 <p>
111 The Mesa demos collection is available
112 <a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">here</a>
113 </p>
114
115 <p>
116 In the past, GLUT, GLU and the Mesa demos were released in conjunction with
117 Mesa releases. But since GLUT, GLU and the demos change infrequently, they
118 were split off into their own git repositories:
119
120 <a href="http://cgit.freedesktop.org/mesa/glut/">GLUT</a>,
121 <a href="http://cgit.freedesktop.org/mesa/glu/">GLU</a> and
122 <a href="http://cgit.freedesktop.org/mesa/demos/">Demos</a>,
123 </p>
124
125 </div>
126 </body>
127 </html>