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