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</H1>
  10
  11 <p>
  12 Last stable release: <b>7.0.3</b>
  13 </p>
  14
  15 <p>
  16 Primary download site:
  17 <a href="http://sourceforge.net/project/showfiles.php?group_id=3"
  18 target="_parent">SourceForge</a>
  19 </p>
  20
  21 <p>
  22 When a new release is coming, release candidates (betas) can be found
  23 <a href="http://www.mesa3d.org/beta/">here</a>.
  24 </p>
  25
  26
  27 <p>
  28 Mesa 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
  36     <a href="http://www.opengl.org/resources/libraries/glut"
  37     target="_parent">original GLUT by Mark Kilgard</a> or
  38     <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
  39     <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
  40 </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>
  47 If you're not interested in running the demos, you'll only need the first
  48 package.
  49 </p>
  50
  51 <p>
  52 If you're new to this and not sure what you're doing, grab all three packages.
  53 </p>
  54
  55 <p>
  56 The packages are available in .tar.gz, .tar.bz2 and .zip formats.
  57 Other sites might offer additional package formats.
  58 </p>
  59
  60 <H1>Unpacking</H1>
  61
  62 <p>
  63 All the packages should be in the same directory prior to unpacking.
  64 </p>
  65
  66 <ul>
  67 <li>To unpack .tar.gz files:
  68 <pre>
  69         tar zxf MesaLib-X.Y.tar.gz
  70         tar zxf MesaDemos-X.Y.tar.gz
  71         tar zxf MesaGLUT-X.Y.tar.gz
  72 </pre>
  73 or
  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>
  79 or
  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>
 101
 102 <p>
 103 After unpacking you'll have these files and directories (among others):
 104 </p>
 105 <pre>
 106 Makefile        - top-level Makefile for most systems
 107 configs/        - makefile parameter files for various systems
 108 include/        - GL header (include) files
 109 bin/            - shell scripts for making shared libraries, etc
 110 docs/           - documentation
 111 src/            - source code for libraries
 112 src/mesa        - sources for the main Mesa library and device drivers
 113 src/glu         - libGLU source code
 114 src/glx         - sources for building libGL with full GLX and DRI support
 115 src/glw         - Xt/Motif/OpenGL widget code
 116 </pre>
 117
 118 If you downloaded and unpacked the MesaDemos.X.Y package:
 119
 120 <pre>
 121 progs/demos     - original Mesa demos
 122 progs/xdemos    - GLX OpenGL/Mesa demos
 123 progs/redbook   - examples from the OpenGL Programming Guide
 124 progs/samples   - examples from SGI
 125 progs/images/   - image files
 126 </pre>
 127
 128 If you downloaded and unpacked the MesaGLUT.X.Y package:
 129 <pre>
 130 src/glut        - GLUT library source code
 131 </pre>
 132
 133 <p>
 134 Proceed to the <a href="install.html">compilation and installation
 135 instructions</a>.
 136 </p>
 137
 138
 139 </BODY>
 140 </HTML>