Home | History | Annotate | Download | only in docs
      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>
    137