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 Current development release: <b>7.1</b>
  13 <br>
  14 Last stable release: <b>7.0.4</b>
  15 </p>
  16
  17 <p>
  18 Primary download site:
  19 <a href="http://sourceforge.net/project/showfiles.php?group_id=3"
  20 target="_parent">SourceForge</a>
  21 </p>
  22
  23 <p>
  24 When a new release is coming, release candidates (betas) can be found
  25 <a href="http://www.mesa3d.org/beta/">here</a>.
  26 </p>
  27
  28
  29 <p>
  30 Mesa is distributed in several parts:
  31 </p>
  32 <ul>
  33 <li><b>MesaLib-x.y.z</b> - the main Mesa library source code, drivers
  34     and documentation.
  35 </li>
  36 <li><b>MesaDemos-x.y.z</b> - OpenGL demonstration and test programs.
  37     Most of the programs require GLUT (either the
  38     <a href="http://www.opengl.org/resources/libraries/glut"
  39     target="_parent">original GLUT by Mark Kilgard</a> or
  40     <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
  41     <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
  42 </li>
  43 <li><b>MesaGLUT-x.y.z</b> - Mark Kilgard's GLUT, easily compiled and used
  44     with Mesa.  Plus, other implementation of GLUT for DOS, OS/2, BeOS, etc.
  45 </li>
  46 </ul>
  47
  48 <p>
  49 If you're not interested in running the demos, you'll only need the first
  50 package.
  51 </p>
  52
  53 <p>
  54 If you're new to this and not sure what you're doing, grab all three packages.
  55 </p>
  56
  57 <p>
  58 The packages are available in .tar.gz, .tar.bz2 and .zip formats.
  59 Other sites might offer additional package formats.
  60 </p>
  61
  62 <H1>Unpacking</H1>
  63
  64 <p>
  65 All the packages should be in the same directory prior to unpacking.
  66 </p>
  67
  68 <ul>
  69 <li>To unpack .tar.gz files:
  70 <pre>
  71         tar zxf MesaLib-X.Y.tar.gz
  72         tar zxf MesaDemos-X.Y.tar.gz
  73         tar zxf MesaGLUT-X.Y.tar.gz
  74 </pre>
  75 or
  76 <pre>
  77         gzcat MesaLib-X.Y.tar.gz | tar xf -
  78         gzcat MesaDemos-X.Y.tar.gz | tar xf -
  79         gzcat MesaGLUT-X.Y.tar.gz | tar xf -
  80 </pre>
  81 or
  82 <pre>
  83         gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
  84         gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaDemos-X.Y.tar
  85         gunzip MesaGLUT-X.Y.tar.gz ; tar xf MesaGLUT-X.Y.tar
  86 </pre>
  87 <li>To unpack .tar.bz2 files:
  88 <pre>
  89         bunzip2 -c MesaLib-X.Y.tar.gz | tar xf -
  90         bunzip2 -c MesaDemos-X.Y.tar.gz | tar xf -
  91         bunzip2 -c MesaGLUT-X.Y.tar.gz | tar xf -
  92 </pre>
  93 <li>To unpack .zip files:
  94 <pre>
  95         unzip MesaLib-X.Y.zip
  96         unzip MesaDemos-X.Y.zip
  97         unzip MesaGLUT-X.Y.zip
  98 </pre>
  99 </ul>
 100
 101
 102 <h1>Contents</h1>
 103
 104 <p>
 105 After unpacking you'll have these files and directories (among others):
 106 </p>
 107 <pre>
 108 Makefile        - top-level Makefile for most systems
 109 configs/        - makefile parameter files for various systems
 110 include/        - GL header (include) files
 111 bin/            - shell scripts for making shared libraries, etc
 112 docs/           - documentation
 113 src/            - source code for libraries
 114 src/mesa        - sources for the main Mesa library and device drivers
 115 src/glu         - libGLU source code
 116 src/glx         - sources for building libGL with full GLX and DRI support
 117 src/glw         - Xt/Motif/OpenGL widget code
 118 </pre>
 119
 120 If you downloaded and unpacked the MesaDemos.X.Y package:
 121
 122 <pre>
 123 progs/demos     - original Mesa demos
 124 progs/xdemos    - GLX OpenGL/Mesa demos
 125 progs/redbook   - examples from the OpenGL Programming Guide
 126 progs/samples   - examples from SGI
 127 progs/images/   - image files
 128 </pre>
 129
 130 If you downloaded and unpacked the MesaGLUT.X.Y package:
 131 <pre>
 132 src/glut        - GLUT library source code
 133 </pre>
 134
 135 <p>
 136 Proceed to the <a href="install.html">compilation and installation
 137 instructions</a>.
 138 </p>
 139
 140
 141 </BODY>
 142 </HTML>