blob: 1cbfded575d3d487b8da84b5ba73df678212de4c [file] [log] [blame]
Andreas Bollecd5c7c2012-06-12 09:05:03 +02001<!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>
Brian Paul0b27ace2003-03-08 17:38:57 +00009
Andreas Bollb5da52a2012-09-18 18:57:02 +020010<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
Andreas Bollecd5c7c2012-06-12 09:05:03 +020017<h1>Downloading</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +000018
19<p>
Brian Paul5d56e312009-09-03 15:44:49 -060020Primary Mesa download site:
Brian Paulbab07522016-03-29 12:54:10 -060021<a href="ftp://ftp.freedesktop.org/pub/mesa/">ftp.freedesktop.org</a> (FTP)
22or <a href="https://mesa.freedesktop.org/archive/">mesa.freedesktop.org</a>
23(HTTP).
Brian Paul0b27ace2003-03-08 17:38:57 +000024</p>
25
Brian Paul3491cbe2008-06-21 10:14:22 -060026<p>
Eric Engestrom5b10c362017-02-08 04:27:00 -070027Starting with the first release of 2017, Mesa's version scheme is
28year-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
31release, 1 for the first patch after that).
32</p>
33
34<p>
Brian Paul5d56e312009-09-03 15:44:49 -060035When a new release is coming, release candidates (betas) may be found
Andreas Bolla73c59b2012-09-18 19:31:28 +020036<a href="ftp://ftp.freedesktop.org/pub/mesa/beta/">here</a>.
Brian Paul3491cbe2008-06-21 10:14:22 -060037</p>
38
Brian Paul7f8cb302005-09-10 16:57:22 +000039
Andreas Boll210a27d2012-06-12 09:05:36 +020040<h1>Unpacking</h1>
Brian Paul7f8cb302005-09-10 16:57:22 +000041
42<p>
Brian Paulf64bae22012-04-19 08:56:02 -060043Mesa releases are available in three formats: .tar.bz2, .tar.gz, and .zip
44</p>
45
46<p>
Brian Paul48f696c2011-04-04 11:16:51 -060047To unpack .tar.gz files:
Brian Paul7f8cb302005-09-10 16:57:22 +000048</p>
Brian Paul0b27ace2003-03-08 17:38:57 +000049<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060050 tar zxf MesaLib-x.y.z.tar.gz
Brian Paul0b27ace2003-03-08 17:38:57 +000051</pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000052or
53<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060054 gzcat MesaLib-x.y.z.tar.gz | tar xf -
Brian Paul7f8cb302005-09-10 16:57:22 +000055</pre>
56or
57<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060058 gunzip MesaLib-x.y.z.tar.gz ; tar xf MesaLib-x.y.z.tar
Brian Paul7f8cb302005-09-10 16:57:22 +000059</pre>
Brian Paul48f696c2011-04-04 11:16:51 -060060<p>
61To unpack .tar.bz2 files:
62</p>
Brian Paul7f8cb302005-09-10 16:57:22 +000063<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060064 bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
Brian Paul7f8cb302005-09-10 16:57:22 +000065</pre>
Brian Paul48f696c2011-04-04 11:16:51 -060066<p>
67To unpack .zip files:
68</p>
Brian Paul7f8cb302005-09-10 16:57:22 +000069<pre>
Brian Paul48f696c2011-04-04 11:16:51 -060070 unzip MesaLib-x.y.z.zip
Brian Paul7f8cb302005-09-10 16:57:22 +000071</pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000072
73
74<h1>Contents</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +000075
76<p>
Brian Pauld9eff8b2006-07-12 20:14:43 +000077After unpacking you'll have these files and directories (among others):
Brian Paul0b27ace2003-03-08 17:38:57 +000078</p>
79<pre>
Brian Paul7f8cb302005-09-10 16:57:22 +000080Makefile - top-level Makefile for most systems
81configs/ - makefile parameter files for various systems
Brian Paul0b27ace2003-03-08 17:38:57 +000082include/ - GL header (include) files
Brian Paulafc04282003-09-03 23:04:31 +000083bin/ - shell scripts for making shared libraries, etc
Brian Paul0b27ace2003-03-08 17:38:57 +000084docs/ - documentation
Brian Paulafc04282003-09-03 23:04:31 +000085src/ - source code for libraries
86src/mesa - sources for the main Mesa library and device drivers
Brian Paul48f696c2011-04-04 11:16:51 -060087src/gallium - sources for Gallium and Gallium drivers
Brian Pauld9eff8b2006-07-12 20:14:43 +000088src/glx - sources for building libGL with full GLX and DRI support
Brian Paul7f8cb302005-09-10 16:57:22 +000089</pre>
Brian Paulafc04282003-09-03 23:04:31 +000090
Brian Paul0b27ace2003-03-08 17:38:57 +000091
92<p>
Brian Paul7f8cb302005-09-10 16:57:22 +000093Proceed to the <a href="install.html">compilation and installation
Brian Paul0b27ace2003-03-08 17:38:57 +000094instructions</a>.
95</p>
96
Brian Paul0b27ace2003-03-08 17:38:57 +000097
Matt Turnerb95d5982012-08-23 16:39:20 -070098<h1>Demos, GLUT, and GLU</h1>
99
100<p>
101A package of SGI's GLU library is available
Andreas Bolla73c59b2012-09-18 19:31:28 +0200102<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/">here</a>
Matt Turnerb95d5982012-08-23 16:39:20 -0700103</p>
Brian Paulf64bae22012-04-19 08:56:02 -0600104
105<p>
106A package of Mark Kilgard's GLUT library is available
Andreas Bolla73c59b2012-09-18 19:31:28 +0200107<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>
Brian Paulf64bae22012-04-19 08:56:02 -0600108</p>
109
110<p>
111The Mesa demos collection is available
Andreas Bolla73c59b2012-09-18 19:31:28 +0200112<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">here</a>
Brian Paulf64bae22012-04-19 08:56:02 -0600113</p>
114
115<p>
Matt Turnerb95d5982012-08-23 16:39:20 -0700116In the past, GLUT, GLU and the Mesa demos were released in conjunction with
117Mesa releases. But since GLUT, GLU and the demos change infrequently, they
118were 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>,
Brian Paulf64bae22012-04-19 08:56:02 -0600123</p>
124
Andreas Bollb5da52a2012-09-18 18:57:02 +0200125</div>
Andreas Bollecd5c7c2012-06-12 09:05:03 +0200126</body>
127</html>