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