1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142
|
<HTML>
<TITLE>Mesa Demos Distribution</TITLE>
<BODY>
<H1>Introduction</H1>
<p>
The Mesa Demos package contains a large number of OpenGL demonstration
and test programs.
</p>
<p>
These programs were previously distributed as the MesaDemos-x.y.z.tar.gz
package released in conjunction with the MesaLib-x.y.z.tar.gz package.
The demos are separated now since they don't change often and
aren't tied to a particular version of Mesa.
</p>
<p>
Note that the Mesa demos should be usable with any OpenGL implementation;
not just Mesa.
</p>
<H1>FTP site</H1>
<p>
The latest version of the Mesa demos can be found on the
<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">freedesktop.org FTP</a>
site.
</p>
<H1>Git Repository</H1>
<p>
The Mesa demos git repository can be obtained with:
<pre>
git clone git://anongit.freedesktop.org/git/mesa/demos
</pre>
Or, if you're a developer:
<pre>
git clone git+ssh://USERNAME@git.freedesktop.org/git/mesa/demos
</pre>
</p>
<H1>Building</H1>
<p>
The Mesa demos can be built with autoconf or
<a href="http://www.scons.org/">SCons</a>.
</p>
<H2>Autoconf</H2>
<p>
First, you may need to install the GLEW and GLUT library and header files for
your distro.
For example, if you're using an RPM-based Linux distro:
</p>
<pre>
yum install glew glew-devel
yum install freeglut freeglut-devel
</pre>
<p>
Run <b>./configure --help</b> to see the options available for building
the demos.
</p>
<p>
Otherwise, just run <b>./configure ; make</b> to build the demos.
</p>
<H2>SCons</H2>
<p>
As with autoconf, you may need to install GLEW and GLUT before building.
</p>
Just run <b>cons</b> to build with SCons.
</p>
<p>
XXX more info?
</p>
<H1>The Demos</H1>
<p>
Look in the <b>src/</b> directory for these sub-directories, among others:
</p>
<ul>
<li>demos - the original Mesa demos, such as gears, gloss, etc.
<li>redbook - the OpenGL Programming Guide demos
<li>samples- original SGI OpenGL demos
<li>glsl - OpenGL Shading Language demos
<li>gs - Geometry shader demos
<li>xdemos - GLX-based demos
<li>egl - EGL-based demos
<li>wgl - WGL-based demos
<li>fp - fragment program tests
<li>vp - vertex program tests
<li>images - sample image files (in SGI .rgb format)
<li>perf - performance tests
<li>tests - assorted test programs
<li>objviewer - program to view .obj modes with a skybox
</ul>
<H1>Getting Help</H1>
<p>
If you have trouble building or using the Mesa demos, you can post
to the<a href="http://lists.freedesktop.org/mailman/listinfo/mesa-users">
Mesa users</a> mailing list.
</p>
<p>
If your question is especially technical, you can try the
to the<a href="http://lists.freedesktop.org/mailman/listinfo/mesa-dev">
Mesa dev</a> mailing list.
</p>
<H1>Reporting Bugs</H1>
<p>
Bugs in the demos can be reported to the
<a href="https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa">
Mesa bug database</a>.
Choose Component="Demos" in the drop-down list.
</p>
</BODY>
</HTML>
|