diff options
| author | Brian Paul <[email protected]> | 2003-03-08 17:38:57 +0000 |
|---|---|---|
| committer | Brian Paul <[email protected]> | 2003-03-08 17:38:57 +0000 |
| commit | 0b27aceae2464db3dd149cf4fd667e353a655c5e (patch) | |
| tree | a8df88dd0893e04a6fe4f125ddd361a1bde9d7ae /docs | |
| parent | dc32636cfd38916ad7b2150e10765026dbb64ce5 (diff) | |
Documentation/website overhaul. The website content and doc/ directory
are now merged and are one and the same.
Diffstat (limited to 'docs')
38 files changed, 3954 insertions, 93 deletions
diff --git a/docs/README.X11 b/docs/README.X11 index 22621eff465..030b6e3fc1b 100644 --- a/docs/README.X11 +++ b/docs/README.X11 @@ -250,15 +250,9 @@ HPCR glClear(GL_COLOR_BUFFER_BIT) dithering to HP systems with the HPCR (Color Recovery) system. -Extensions: - The following OpenGL GLX extensions are currently implemented: - - GLX_EXT_visual_info - GLX visual and transparent pixel extension - GLX_EXT_visual_rating - GLX visual caveats - - For detailed information about the extensions see www.opengl.org - - There are four Mesa-specific GL/GLX extensions at this time. +Extensions +========== + There are three Mesa-specific GLX extensions at this time. GLX_MESA_pixmap_colormap @@ -317,4 +311,4 @@ Summary of X-related environment variables: ---------------------------------------------------------------------- -$Id: README.X11,v 3.9 2002/10/29 23:42:48 brianp Exp $ +$Id: README.X11,v 3.10 2003/03/08 17:38:57 brianp Exp $ diff --git a/docs/banner.html b/docs/banner.html new file mode 100644 index 00000000000..b6d1abb0d5f --- /dev/null +++ b/docs/banner.html @@ -0,0 +1,15 @@ +<HTML> + +<title>Banner</title> + + +<body text="#ffffff" bgcolor="#aa4444"> + +<center> +<p> +<font size="5">The Mesa 3D Graphics Library</font> +</p> +</center> + +</body> +</html>
\ No newline at end of file diff --git a/docs/bugs.html b/docs/bugs.html new file mode 100644 index 00000000000..9ced9dc8c2d --- /dev/null +++ b/docs/bugs.html @@ -0,0 +1,35 @@ +<HTML> + +<TITLE>Mesa Bug Reporting</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Bug Database</H1> + +<p> +Bug reports can be filed in the <a +href="http://sourceforge.net/bugs/?group_id=3" target="_parent">Bug +Database</a> on sourceforge.net. Please follow these guidelines: +</p> + +<ul> +<li>Make sure you're using the most recent version of Mesa +<li>Make sure your bug isn't already reported +<li>Include as much information as possible in the report +<li>Provide a simple GLUT-based test program if possible +<li>Check back for follow-ups to the report +</ul> + +<p> +Bug reports will automatically be forwarded to the Mesa developer's list. +</p> + +<p> +The easier a bug is to reproduce, the sooner it will be fixed. +Please do everything you can to facilitate quickly fixing bugs. +If your bug report is vague or your test program doesn't compile +easily, the problem may not be fixed very quickly. +</p> + +</BODY> +</HTML> diff --git a/docs/conform.html b/docs/conform.html new file mode 100644 index 00000000000..eded6a79de5 --- /dev/null +++ b/docs/conform.html @@ -0,0 +1,693 @@ +<HTML> + +<TITLE>Conformance</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Conformance</H1> + +<p> +The SGI OpenGL conformance tests verify correct operation of OpenGL +implementations. I, Brian Paul, have been given a copy of the tests +for testing Mesa. The tests are not publically available. +</p> +<p> +This file has the latest results of testing Mesa with the OpenGL 1.2 +conformance tests. Testing with the preliminary OpenGL 1.3 tests has +also been done. Mesa passes all the 1.3 tests. +</p> +<p> +The tests were run using the software X11 device driver on 24-bpp +and 16-bpp displays. +</p> +<p> +Mesa 4.0 and later pass all conformance tests at all path levels. +Note that this says nothing about the conformance of hardware drivers +based upon Mesa. +</p> + + +<pre> + +COVERAGE TESTS +-------------- + +Test that all API functions accept the legal parameters and reject +illegal parameters. The result of each test is either pass or fail. + +% covgl +OpenGL Coverage Test. +Version 1.2 + +covgl passed. + +covgl passed at 1.1 level. + +covgl passed at 1.2 level. + +covgl passed for ARB_multitexture. + + +% covglu +OpenGL GLU Coverage Test. +Version 1.3 + +covglu passed. + +covglu passed at 1.1 level. + + +% covglx +OpenGL X Coverage Test. +Version 1.1.1 + +covglx passed. + + +% primtest -v +Open GL Primitives Test. +Version 1.2 + +[lots of output deleted] + +292159 Combinations. +primtest passed. + + + + +GL CONFORMANCE TEST +=================== + +Render test images, read them back, then test for expected results. + + +---------------------------------------------------------------------- +% conform -v 2 + +OpenGL Conformance Test +Version 1.2 + +Setup Report. + Verbose level = 2. + Random number seed = 1. + Path inactive. + +Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + +Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + +Default State test passed. +Must Pass test passed. +Divide By Zero test passed. +Viewport Clamp test passed. +Matrix Stack test passed. +Matrix Stack Mixing test passed. +Vertex Order test passed. +Transformations test passed. +Transformation Normal test passed. +Viewport Transformation test passed. +Buffer Clear test passed. +Buffer Corners test passed. +Buffer Color test passed. +Color Ramp test passed. +Mask test passed. +Buffer Invariance test passed. +Accumulation Buffer test passed. +Select test passed. +Feedback test passed. +Scissor test passed. +Alpha Plane Function test passed. +Stencil Plane Clear test passed. +Stencil Plane Corners test passed. +Stencil Plane Operation test passed. +Stencil Plane Function test passed. +Depth Buffer Clear test passed. +Depth Buffer Function test passed. +Blend test passed. +Dither test passed. +LogicOp Function test does not exist for an RGB visual. +DrawPixels test passed. +CopyPixels test passed. +Bitmap Rasterization test passed. +Point Rasterization test passed. +Anti-aliased Point test passed. +Line Rasterization test passed. +Line Stipple test passed. +Anti-aliased Line test passed. +Horizontal and Vertical Line test passed. +Triangle Rasterization test passed. +Triangle Tile test passed. +Triangle Stipple test passed. +Anti-aliased Triangles test passed. +Quad Rasterization test passed. +Polygon Face test passed. +Polygon Cull test passed. +Polygon Stipple test passed. +Polygon Edge test passed. +Ambient Material test passed. +Ambient Scene test passed. +Attenuation Position test passed. +Diffuse Light test passed. +Diffuse Material test passed. +Diffuse Material Normal test passed. +Diffuse Material Positioning test passed. +Emissive Material test passed. +Specular Exponent test passed. +Specular Exponent Normal test passed. +Specular Local Eye Half Angle test passed. +Specular Light test passed. +Specular Material test passed. +Specular Normal test passed. +Spot Positioning test passed. +Spot Exponent and Positioning test passed. +Spot Exponent and Direction test passed. +Fog Exponential test passed. +Fog Linear test passed. +Texture Decal test passed. +Texture Border test passed. +Mipmaps Selection test passed. +Mipmaps Interpolation test passed. +Display Lists test passed. +Evaluator test passed. +Evaluator Color test passed. +Texture Edge Clamp test passed. +Packed Pixels test passed. +Texture LOD test passed. +Rescale Normal test passed. +Color Table test passed. +Convolution test passed. +Convolution Border test passed. +Histogram test passed. +MinMax test passed. +MultiTexture test passed. + +Conform passed. + +---------------------------------------------------------------------- +% conform -v 2 -p 1 + +OpenGL Conformance Test +Version 1.2 + +Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 1. + +Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + +Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + +Default State test passed. +Must Pass test passed. +Divide By Zero test passed. +Viewport Clamp test passed. +Matrix Stack test passed. +Matrix Stack Mixing test passed. +Vertex Order test passed. +Transformations test passed. +Transformation Normal test passed. +Viewport Transformation test passed. +Buffer Clear test passed. +Buffer Corners test passed. +Buffer Color test passed. +Color Ramp test passed. +Mask test passed. +Buffer Invariance test passed. +Accumulation Buffer test passed. +Select test passed. +Feedback test passed. +Scissor test passed. +Alpha Plane Function test passed. +Stencil Plane Clear test passed. +Stencil Plane Corners test passed. +Stencil Plane Operation test passed. +Stencil Plane Function test passed. +Depth Buffer Clear test passed. +Depth Buffer Function test passed. +Blend test passed. +Dither test passed. +LogicOp Function test does not exist for an RGB visual. +DrawPixels test passed. +CopyPixels test passed. +Bitmap Rasterization test passed. +Point Rasterization test passed. +Anti-aliased Point test passed. +Line Rasterization test passed. +Line Stipple test passed. +Anti-aliased Line test passed. +Horizontal and Vertical Line test passed. +Triangle Rasterization test passed. +Triangle Tile test passed. +Triangle Stipple test passed. +Anti-aliased Triangles test passed. +Quad Rasterization test passed. +Polygon Face test passed. +Polygon Cull test passed. +Polygon Stipple test passed. +Polygon Edge test passed. +Ambient Material test passed. +Ambient Scene test passed. +Attenuation Position test passed. +Diffuse Light test passed. +Diffuse Material test passed. +Diffuse Material Normal test passed. +Diffuse Material Positioning test passed. +Emissive Material test passed. +Specular Exponent test passed. +Specular Exponent Normal test passed. +Specular Local Eye Half Angle test passed. +Specular Light test passed. +Specular Material test passed. +Specular Normal test passed. +Spot Positioning test passed. +Spot Exponent and Positioning test passed. +Spot Exponent and Direction test passed. +Fog Exponential test passed. +Fog Linear test passed. +Texture Decal test passed. +Texture Border test passed. +Mipmaps Selection test passed. +Mipmaps Interpolation test passed. +Display Lists test passed. +Evaluator test passed. +Evaluator Color test passed. +Texture Edge Clamp test passed. +Packed Pixels test passed. +Texture LOD test passed. +Rescale Normal test passed. +Color Table test passed. +Convolution test passed. +Convolution Border test passed. +Histogram test passed. +MinMax test passed. +MultiTexture test passed. + +Conform passed. + +---------------------------------------------------------------------- +% conform -v 2 -p 2 + +OpenGL Conformance Test +Version 1.2 + +Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 2. + +Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + +Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + +Default State test passed. +Must Pass test passed. +Divide By Zero test passed. +Viewport Clamp test passed. +Matrix Stack test passed. +Matrix Stack Mixing test passed. +Vertex Order test passed. +Transformations test passed. +Transformation Normal test passed. +Viewport Transformation test passed. +Buffer Clear test passed. +Buffer Corners test passed. +Buffer Color test passed. +Color Ramp test passed. +Mask test passed. +Buffer Invariance test passed. +Accumulation Buffer test passed. +Select test passed. +Feedback test passed. +Scissor test passed. +Alpha Plane Function test passed. +Stencil Plane Clear test passed. +Stencil Plane Corners test passed. +Stencil Plane Operation test passed. +Stencil Plane Function test passed. +Depth Buffer Clear test passed. +Depth Buffer Function test passed. +Blend test passed. +Dither test passed. +LogicOp Function test does not exist for an RGB visual. +DrawPixels test passed. +CopyPixels test passed. +Bitmap Rasterization test passed. +Point Rasterization test passed. +Anti-aliased Point test passed. +Line Rasterization test passed. +Line Stipple test passed. +Anti-aliased Line test passed. +Horizontal and Vertical Line test passed. +Triangle Rasterization test passed. +Triangle Tile test passed. +Triangle Stipple test passed. +Anti-aliased Triangles test passed. +Quad Rasterization test passed. +Polygon Face test passed. +Polygon Cull test passed. +Polygon Stipple test passed. +Polygon Edge test passed. +Ambient Material test passed. +Ambient Scene test passed. +Attenuation Position test passed. +Diffuse Light test passed. +Diffuse Material test passed. +Diffuse Material Normal test passed. +Diffuse Material Positioning test passed. +Emissive Material test passed. +Specular Exponent test passed. +Specular Exponent Normal test passed. +Specular Local Eye Half Angle test passed. +Specular Light test passed. +Specular Material test passed. +Specular Normal test passed. +Spot Positioning test passed. +Spot Exponent and Positioning test passed. +Spot Exponent and Direction test passed. +Fog Exponential test passed. +Fog Linear test passed. +Texture Decal test passed. +Texture Border test passed. +Mipmaps Selection test passed. +Mipmaps Interpolation test passed. +Display Lists test passed. +Evaluator test passed. +Evaluator Color test passed. +Texture Edge Clamp test passed. +Packed Pixels test passed. +Texture LOD test passed. +Rescale Normal test passed. +Color Table test passed. +Convolution test passed. +Convolution Border test passed. +Histogram test passed. +MinMax test passed. +MultiTexture test passed. + +Conform passed. + +---------------------------------------------------------------------- +% conform -v 2 -p 3 + +OpenGL Conformance Test +Version 1.2 + +Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 3. + +Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + +Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + +Default State test passed. +Must Pass test passed. +Divide By Zero test passed. +Viewport Clamp test passed. +Matrix Stack test passed. +Matrix Stack Mixing test passed. +Vertex Order test passed. +Transformations test passed. +Transformation Normal test passed. +Viewport Transformation test passed. +Buffer Clear test passed. +Buffer Corners test passed. +Buffer Color test passed. +Color Ramp test passed. +Mask test passed. +Buffer Invariance test passed. +Accumulation Buffer test passed. +Select test passed. +Feedback test passed. +Scissor test passed. +Alpha Plane Function test passed. +Stencil Plane Clear test passed. +Stencil Plane Corners test passed. +Stencil Plane Operation test passed. +Stencil Plane Function test passed. +Depth Buffer Clear test passed. +Depth Buffer Function test passed. +Blend test passed. +Dither test passed. +LogicOp Function test does not exist for an RGB visual. +DrawPixels test passed. +CopyPixels test passed. +Bitmap Rasterization test passed. +Point Rasterization test passed. +Anti-aliased Point test passed. +Line Rasterization test passed. +Line Stipple test passed. +Anti-aliased Line test passed. +Horizontal and Vertical Line test passed. +Triangle Rasterization test passed. +Triangle Tile test passed. +Triangle Stipple test passed. +Anti-aliased Triangles test passed. +Quad Rasterization test passed. +Polygon Face test passed. +Polygon Cull test passed. +Polygon Stipple test passed. +Polygon Edge test passed. +Ambient Material test passed. +Ambient Scene test passed. +Attenuation Position test passed. +Diffuse Light test passed. +Diffuse Material test passed. +Diffuse Material Normal test passed. +Diffuse Material Positioning test passed. +Emissive Material test passed. +Specular Exponent test passed. +Specular Exponent Normal test passed. +Specular Local Eye Half Angle test passed. +Specular Light test passed. +Specular Material test passed. +Specular Normal test passed. +Spot Positioning test passed. +Spot Exponent and Positioning test passed. +Spot Exponent and Direction test passed. +Fog Exponential test passed. +Fog Linear test passed. +Texture Decal test passed. +Texture Border test passed. +Mipmaps Selection test passed. +Mipmaps Interpolation test passed. +Display Lists test passed. +Evaluator test passed. +Evaluator Color test passed. +Texture Edge Clamp test passed. +Packed Pixels test passed. +Texture LOD test passed. +Rescale Normal test passed. +Color Table test passed. +Convolution test passed. +Convolution Border test passed. +Histogram test passed. +MinMax test passed. +MultiTexture test passed. + +Conform passed. + +---------------------------------------------------------------------- +% conform -v 2 -p 4 + +OpenGL Conformance Test +Version 1.2 + +Setup Report. + Verbose level = 2. + Random number seed = 1. + Path level = 4. + +Visual Report. + Display ID = 35. Indirect Rendering. + Double Buffered. + RGBA (5, 6, 5, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + +Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + +Default State test passed. +Must Pass test passed. +Divide By Zero test passed. +Viewport Clamp test passed. +Matrix Stack test passed. +Matrix Stack Mixing test passed. +Vertex Order test passed. +Transformations test passed. +Transformation Normal test passed. +Viewport Transformation test passed. +Buffer Clear test passed. +Buffer Corners test passed. +Buffer Color test passed. +Color Ramp test passed. +Mask test passed. +Buffer Invariance test passed. +Accumulation Buffer test passed. +Select test passed. +Feedback test passed. +Scissor test passed. +Alpha Plane Function test passed. +Stencil Plane Clear test passed. +Stencil Plane Corners test passed. +Stencil Plane Operation test passed. +Stencil Plane Function test passed. +Depth Buffer Clear test passed. +Depth Buffer Function test passed. +Blend test passed. +Dither test passed. +LogicOp Function test does not exist for an RGB visual. +DrawPixels test passed. +CopyPixels test passed. +Bitmap Rasterization test passed. +Point Rasterization test passed. +Anti-aliased Point test passed. +Line Rasterization test passed. +Line Stipple test passed. +Anti-aliased Line test passed. +Horizontal and Vertical Line test passed. +Triangle Rasterization test passed. +Triangle Tile test passed. +Triangle Stipple test passed. +Anti-aliased Triangles test passed. +Quad Rasterization test passed. +Polygon Face test passed. +Polygon Cull test passed. +Polygon Stipple test passed. +Polygon Edge test passed. +Ambient Material test passed. +Ambient Scene test passed. +Attenuation Position test passed. +Diffuse Light test passed. +Diffuse Material test passed. +Diffuse Material Normal test passed. +Diffuse Material Positioning test passed. +Emissive Material test passed. +Specular Exponent test passed. +Specular Exponent Normal test passed. +Specular Local Eye Half Angle test passed. +Specular Light test passed. +Specular Material test passed. +Specular Normal test passed. +Spot Positioning test passed. +Spot Exponent and Positioning test passed. +Spot Exponent and Direction test passed. +Fog Exponential test passed. +Fog Linear test passed. +Texture Decal test passed. +Texture Border test passed. +Mipmaps Selection test passed. +Mipmaps Interpolation test passed. +Display Lists test passed. +Evaluator test passed. +Evaluator Color test passed. +Texture Edge Clamp test passed. +Packed Pixels test passed. +Texture LOD test passed. +Rescale Normal test passed. +Color Table test passed. +Convolution test passed. +Convolution Border test passed. +Histogram test passed. +MinMax test passed. +MultiTexture test passed. + +Conform passed. + + + +GLX CONFORMANCE TEST +==================== + +% conformx -v 2 + +OpenGL X Conformance Test +Version 1.1.1 + +Setup Report. + Verbose level = 2. + Random number seed = 1. + Path inactive. + +Visual Report. + Display ID = 34. Direct Rendering. + Double Buffered. + RGBA (8, 8, 8, 0). + Stencil (8). + Depth (16). + Accumulation (16, 16, 16, 16). + +Epsilon Report. + zero error epsilon = 0.000122. + RGBA error epsilon = 0.00404, 0.00404, 0.00404, 0.000122. + Depth buffer error epsilon = 0.000137. + Stencil plane error epsilon = 0.00404. + Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137. + +Default State test passed. +glReadPixels() test passed. +Font test passed. + +Conformx passed. + + +</pre> + +NOTE: conformx passes for all machine path levels (-p option). + + +</body> +</html> diff --git a/docs/contents.html b/docs/contents.html new file mode 100644 index 00000000000..f5d6b46842d --- /dev/null +++ b/docs/contents.html @@ -0,0 +1,76 @@ +<html> + +<title>Contents</title> + +<body text="#ffffff" bgcolor="#119955" link="#ffffff" vlink="#dddddd" alink="#ffffff"> + +<b>Documentation</b> +<ul> +<li><a href="intro.html" target="MainFrame">Introduction</a> +<li><a href="news.html" target="MainFrame">News</a> +<li><a href="systems.html" target="MainFrame">Platforms and Drivers</a> +<li><a href="license.html" target="MainFrame">License & Copyright</a> +<li><a href="faq.html" target="MainFrame">FAQ</a> +<li><a href="VERSIONS" target="MainFrame">Version History</a> +<li><a href="relnotes.html" target="MainFrame">Release Notes</a> +<li><a href="thanks.html" target="MainFrame">Acknowledgements</a> +<li><a href="conform.html" target="MainFrame">Conformance Testing</a> +<li>more docs below... +</ul> + +<b>Download / Install</b> +<ul> +<li><a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">Stable Release (5.0.1)</a> +<li><a href="download.html" target="MainFrame">Downloading/Unpacking</a> +<li><a href="install.html" target="MainFrame">Installation</a> +<li><a href="glu.html" target="MainFrame">SGI's GLU</a> +</ul> + +<b>Resources</b> +<ul> +<li><a href="lists.html" target="MainFrame">Mailing Lists</a> +<li><a href="bugs.html" target="MainFrame">Bug Database</a> +<li><a href="webmaster.html" target="MainFrame">Webmaster</a> +</ul> + +<b>User Topics</b> +<ul> +<LI><A HREF="envvars.html" target="MainFrame">Environment Variables</A> +<LI><A HREF="osmesa.html" target="MainFrame">Off-Screen Rendering</A> +<LI><A HREF="debugging.html" target="MainFrame">Debugging Tips</A> +<LI><A HREF="perf.html" target="MainFrame">Performance Tips</A> +<LI><A HREF="extensions.html" target="MainFrame">Mesa Extensions</A> +<LI><A HREF="mangling.html" target="MainFrame">Function Name Mangling</A> +</ul> + +<b>Developer Topics</b> +<ul> +<li><a href="http://sourceforge.net/projects/mesa3d" target="_parent">SourceForge homepage</a> +<li><a href="cvs_branches.html" target="MainFrame">CVS Branch Info</a> +<li><a href="cvs_anonymous.html" target="MainFrame">Anonymous CVS Access</a> +<li><a href="utilities.html" target="MainFrame">Utilities</a> +<li><a href="helpwanted.html" target="MainFrame">Help Wanted</a> +<li><a href="devinfo.html" target="MainFrame">Development Notes</a> +<li><a href="sourcedocs.html" target="MainFrame">Source Documentation</a> +<li><a href="subset.html" target="MainFrame">Subset Information</a> +<LI><A HREF="custom.html" target="MainFrame">Custom Development</A> +</ul> + +<b>Links</b> +<ul> +<li><a href="http://www.opengl.org" target="_parent">OpenGL website</a> +<li><a href="http://dri.sourceforge.net" target="_parent">DRI website</a> +<li><a href="games.html" target="MainFrame">Games and Entertainment</a> +<li><a href="libraries.html" target="MainFrame">Libraries and Toolkits</a> +<li><a href="modelers.html" target="MainFrame">Modeling and Rendering</a> +<li><a href="science.html" target="MainFrame">Science and Technical</a> +<li><a href="utility.html" target="MainFrame">Utilities</a> +<li><a href="demos.html" target="MainFrame">Demos / other</a> +</ul> + +<A HREF="http://sourceforge.net" +target="_parent"><IMG SRC="http://sourceforge.net/sflogo.php?group_id=3&type=1" +WIDTH="88" HEIGHT="31" ALIGN="BOTTOM" ALT="Sourceforge.net" BORDER="0"></A> + +</body> +</html>
\ No newline at end of file diff --git a/docs/custom.html b/docs/custom.html new file mode 100644 index 00000000000..a5cfdeb813b --- /dev/null +++ b/docs/custom.html @@ -0,0 +1,25 @@ +<HTML> + +<TITLE>Custom Development</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Custom Development</H1> + +<p> +Mesa is primarily developed and maintained on a volunteer basis. +Some Mesa development work has been done in conjuction with contracted +projects, such as the XFree86/DRI drivers. +</p> + +<p> +<pre>[Begin shameless plug]</pre> +If you have a need for specific or custom Mesa development work, +<a href="http://www.tungstengraphics.com/" target="_parent"> +Tungsten Graphics, Inc.</a> may be able to help you. +<pre>[End shameless plug]</pre> +</p> + + +</body> +</html> diff --git a/docs/cvs_anonymous.html b/docs/cvs_anonymous.html new file mode 100644 index 00000000000..19cac143842 --- /dev/null +++ b/docs/cvs_anonymous.html @@ -0,0 +1,37 @@ +<HTML> + +<TITLE>Anonymous CVS</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Anonymous CVS</H1> + +<p> +Anonymous, public, read-only access to the code in CVS is +available. Here are the basic instructions for Unix systems: +</p> + +<ol> + <li>Install CVS client software on your computer. Version 1.9.28 is known to work. + </li><li>Login as an anonymous user: <code>cvs -d:pserver:[email protected]:/cvsroot/mesa3d + login</code> + </li><li>Just hit return at the <code>CVS password:</code> prompt. + </li><li>Then checkout mesa: <code>cvs -z3 -d:pserver:[email protected]:/cvsroot/mesa3d + co Mesa</code> +</li></ol> + +<p>To update your Mesa CVS source to the latest CVS source: + +</p><ol> + <li><code>cd Mesa</code> + </li><li><code>cvs -z3 -d:pserver:[email protected]:/cvsroot/mesa3d + update</code> +</li></ol> + +<p>You can browse the Mesa source code in CVS +<a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/mesa3d/">here. +</a> +</p> + +</body> +</html>
\ No newline at end of file diff --git a/docs/cvs_branches.html b/docs/cvs_branches.html new file mode 100644 index 00000000000..ecb524e20e2 --- /dev/null +++ b/docs/cvs_branches.html @@ -0,0 +1,59 @@ +<HTML> + +<TITLE>CVS Branches</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>CVS Branch Information</H1> + +<p> +The Mesa3d sources are split up into two branches. A branch that is to +remain as stable as possible, and an unstable branch where development +work for new versions will be done. The current stable branch is +tagged <code>mesa_3_4_branch</code> while the unstable branch is just +the default. The goal is to adopt and even/odd stable/unstable +versioning scheme similar to the Linux kernel. Hence releases of Mesa +3.2.X should be more stable than Mesa 3.3.X.<p></p> <p>All versions of +Mesa after 3.0 will also be tagged with a branch id. Mesa 3.1 has the +tag <code>mesa_3_1</code>, Mesa 3.2 will be <code>mesa_3_2</code>, +Mesa 3.3 <code>mesa_3_3</code>, etc..</p> + +<p> +To checkout a specific branch of mesa just pass <code>-r</code> and +the branch tag after your cvs command. For example <code>cvs checkout +-r mesa_3_4_branch Mesa</code> will checkout the 3.4 branch and +<code>cvs update -r mesa_3_4_branch</code> will convert your current +branch to the 3.4 dev branch. +Consult <a href="http://www.durak.org/cvswebsites/doc/cvs_5.php3#SEC54" +target="_parent">http://www.durak.org/cvswebsites/doc/cvs_5.php3#SEC54</a> +for more on branching in cvs. +</p> + +<p> +To see a list of all the CVS branchs run <code>cvs log README</code> (or any +other file) and look for the section labeled <code>symbolic names</code>. +You'll see something like this: +</p> + +<pre> symbolic names: + mesa_4_0: 1.3 + mesa_4_0_branch: 1.3.0.6 + mesa_3_5: 1.3 + mesa_3_4_2: 1.3 + mesa_3_4_1: 1.3 + mesa_3_4: 1.3 + mesa_3_4_branch: 1.3.0.4 + mesa_3_3: 1.3 + mesa_3_2_1: 1.1.1.1 + mesa_3_3_texture_env_combine2: 1.3.0.2 + mesa_3_2: 1.1.1.1 + mesa_3_2_beta_1: 1.1.1.1 + mesa_3_1: 1.1.1.1 + mesa_3_2_dev: 1.1.1.1.0.2 + mesa_3_1_beta_3: 1.1.1.1 + start: 1.1.1.1 + mesa: 1.1.1 +</pre> + +</body> +</html>
\ No newline at end of file diff --git a/docs/debugging.html b/docs/debugging.html new file mode 100644 index 00000000000..cdefa7d210d --- /dev/null +++ b/docs/debugging.html @@ -0,0 +1,36 @@ +<HTML> + +<TITLE>Debugging Tips</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Debugging Tips</H1> + +<p> + Normally Mesa (and OpenGL) records but does not notify the user of + errors. It is up to the application to call + <code>glGetError</code> to check for errors. Mesa supports an + environment variable, MESA_DEBUG, to help with debugging. If + MESA_DEBUG is defined, a message will be printed to stdout whenever + an error occurs. +</p> + +<p> + More extensive error checking is done when Mesa is compiled with the + DEBUG symbol defined. You'll have to edit the Make-config file and + add -DDEBUG to the CFLAGS line for your system configuration. You may + also want to replace any optimization flags with the -g flag so you can + use your debugger. After you've edited Make-config type 'make clean' + before recompiling. +</p> +<p> + In your debugger you can set a breakpoint in _mesa_error() to trap Mesa + errors. +</p> +<p> + There is a display list printing/debugging facility. See the end of + src/dlist.c for details. +</p> + +</BODY> +</HTML> diff --git a/docs/demos.html b/docs/demos.html new file mode 100644 index 00000000000..6e189458c21 --- /dev/null +++ b/docs/demos.html @@ -0,0 +1,16 @@ +<HTML> + +<TITLE>Demos</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Demos</H1> + + +<ul> +<li><a href="http://www.geocities.com/shobhand/homepage.html">Shobhan Dutta's Geartrain and Walkthrough Demos</a> +</li></ul> + + +</body> +</html>
\ No newline at end of file diff --git a/docs/devinfo.html b/docs/devinfo.html new file mode 100644 index 00000000000..ee191fc9f84 --- /dev/null +++ b/docs/devinfo.html @@ -0,0 +1,230 @@ +<HTML> + +<TITLE>Development Notes</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Development Notes</H1> + + +<H2>Adding Extentions</H2> + +<p> +To add a new GL extension to Mesa you have to do the following. +<pre> + If glext.h doesn't define the extension, edit include/GL/gl.h and add: + - new enum tokens + - new API function entry points + - #define GL_EXT_the_extension_name 1 + + If adding a new API function (call it glNewFunctionEXT): + - insert glNewFunctionEXT()into src/apiext.h + - edit src/types.h and add NewFunction to the gl_api_table struct + - implement gl_NewFunction() in the appropriate src file + - hook gl_NewFunction() into pointers.c + - add display list support in dlist.c for save_NewFunction() + - add glNewFunctionEXT to gl_GetProcAddress() in extensions.c or + in the device driver's GetProcAddress() function if appropriate +</pre> +<p> +If adding new GL state be sure to update get.c and enable.c +</p> +<p> +In general, look for an extension similar to the new one that's already +implemented in Mesa and follow it by example. +</p> + + + +<H2>Coding Style</H2> + +<p> +Mesa's code style has changed over the years. Here's the latest. +</p> + +<p> +Comment your code! It's extremely important that open-source code be +well documented. Also, strive to write clean, easily understandable code. +</p> + +<p> +3-space indentation +</p> + +<p> +If you use tabs, set them to 8 columns +</p> + +<p> +Brace example: +</p> +<pre> + if (condition) { + foo; + } + else { + bar; + } +</pre> + +<p> +Here's the GNU indent command which will best approximate my preferred style: +</p> +<pre> + indent -br -i3 -npcs infile.c -o outfile.c +</pre> + + +<p> +Local variable name example: localVarName (no underscores) +</p> + +<p> +Constants and macros are ALL_UPPERCASE, with _ between words +</p> + +<p> +Global vars not allowed. +</p> + +<p> +Function name examples: +</p> +<pre> + glFooBar() - a public GL entry point (in dispatch.c) + _mesa_FooBar() - the internal immediate mode function + save_FooBar() - retained mode (display list) function in dlist.c + foo_bar() - a static (private) function + _mesa_foo_bar() - an internal non-static Mesa function +</pre> + + +<H2>Writing a Device Driver</H2> + +<p> +XXX to do +</p> + + + +<H2>Making a New Mesa Release</H2> + +<p> +These are the instructions for making a new Mesa release. +</p> + +<p> +Prerequisites (later versions may work): +</p> +<ul> +<li> autoconf 2.50 +<li> automake 1.4-p2 +<li> libtool 1.4 +</ul> + +<p> +Be sure to do a "cvs update -d ." in the Mesa directory to +get all the latest files. +</p> + +<p> +Update the version strings in src/get.c and src/X/fakeglx.c to return +the new Mesa version number. +</p> + +<p> +Create/edit the docs/RELNOTES-X-Y file to document what's new in the release. +Edit the docs/VERSIONS file too. +Update the docs/IAFA-PACKAGE file. +</p> + +<p> +Edit Make-config and change the MESA_MAJOR and/or MESA_MINOR versions. +</p> + +<p> +Edit the GNU configure stuff to change versions numbers as needed: +Update the version string (second argument) in the line +"AM_INIT_AUTOMAKE(Mesa, 3.3)" in the configure.in file. +</p> + +<p> +Remove the leading `dnl' from the line "dnl AM_MAINTAINER_MODE". +</p> + +<p> +Verify the version numbers near the top of configure.in +</p> + +<p> +Run "fixam -f" to disable automatic dependency tracking. +</p> + +<p> +Run the bootstrap script to generate the configure script. +</p> + +<p> +Edit Makefile.X11 and verify DIRECTORY is set correctly. The Mesa +sources must be in that directory (or there must be a symbolic link). +</p> + +<p> +Edit Makefile.X11 and verify that LIB_NAME and DEMO_NAME are correct. +If it's a beta release, be sure the bump up the beta release number. +</p> + +<p> +cp Makefile.X11 to Makefile so that the old-style Mesa makefiles +still work. ./configure will overwrite it if that's what the user runs. +</p> + +<p> +Make a symbolic link from $(DIRECTORY) to Mesa. For example, +ln -s Mesa Mesa-3.3 This is needed in order to make a correct +tar file in the next step. +</p> + +<p> +Make the distribution files. From inside the Mesa directory: +<pre> + make -f Makefile.X11 lib_tar + make -f Makefile.X11 demo_tar + make -f Makefile.X11 lib_zip + make -f Makefile.X11 demo_zip +</pre> + +<p> +Copy the distribution files to a temporary directory, unpack them, +compile everything, and run some demos to be sure everything works. +</p> + +<p> +Upload the *.tar.gz and *.zip files to ftp.mesa3d.org +</p> + +<p> +Update the web site. CJ Beyer ([email protected]) can +help with this and uploading to the ftp site. +</p> + +<p> +Make the announcement to the SourceForge.net sites: [email protected], +</p> + + +<H2>Autoconf info</H2> + +<p> +In order to run the bootstrap script you'll need: +<p> +<pre> +autoconf 2.50 +automake 1.4-p5 +libtool 1.4 +</pre> + + +</body> +</html> diff --git a/docs/download.html b/docs/download.html new file mode 100644 index 00000000000..79b34e4990f --- /dev/null +++ b/docs/download.html @@ -0,0 +1,106 @@ +<HTML> + +<TITLE>Getting Mesa</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Downloading / Unpacking</H1> + +<p> +Mesa can be downloaded from the +<a href="http://www.sourceforge.net/projects/mesa3d" target="_parent"> +SourceForge download area</A>. +</p> + +<p> +Since version 2.3, Mesa is distributed in two pieces: main library code +and demos. If you're upgrading from a previous version of Mesa or you're not +interested in the demos you can just download the core Mesa archive file. +</p> + +<p> +Mesa is available in at least three archive formats: +</p> + +<pre> +1. GNU zip/tar + + Download MesaLib-X.Y.tar.gz and optionally MesaDemos-X.Y.tar.gz + Unpack with: + gzcat MesaLib-X.Y.tar.gz | tar xf - + gzcat MesaDemos-X.Y.tar.gz | tar xf - + or + gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar + gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar + or + tar zxf MesaLib-X.Y.tar.gz + tar zxf MesaDemos-X.Y.tar.gz + + If you don't have gzcat try zcat instead. + +2. Unix compressed/tar + + Download MesaLib-X.Y.tar.Z and optionally MesaDemos-X.Y.tar.Z + Unpack with: + zcat MesaLib-X.Y.tar.Z | tar xf - + zcat MesaDemos-X.Y.tar.Z | tar xf - + +3. ZIP format + + Download MesaLib-X.Y.zip and optionally MesaDemos-X.Y.zip + Unpack with: + unzip MesaLib-X.Y.zip + unzip MesaDemos-X.Y.zip +</pre> + +<p> +After unpacking you'll have these directories (and more): +</p> +<pre> +Makefile.X11 - "old" top-level Makefile for X11-based systems +Make-config - system configurations used by the Makefile.X11 +configure - the GNU autoconf script +bin/ - shell scripts for making shared libraries, etc +include/ - GL header (include) files +lib/ - client libraries, created during installation +src/ - source code for the main libGL library +si-glu/ - SGI Sample Implementation of libGLU +src-glu/ - old source code for libGLU (obsolete) +docs/ - documentation +util/ - handly utility functions +widgets-mesa/ - Mesa widgets for Xt/Motif (obsolete) +widgets-sgi/ - SGI OpenGL widgets for Xt/Motif + +and if you downloaded and unpacked the demos: + +src-glut/ - source code for GLUT toolkit +demos/ - GLUT demos +xdemos/ - X11 and SVGA demo programs +samples/ - sample OpenGL programs from SGI +book/ - example programs from the OpenGL Programming Guide, + converted to GLUT by Mark Kilgard, from GLUT distribution. +images/ - image files + +</pre> + +<p> +Proceed to <a href="install.html">compilation and installation +instructions</a>. +</p> + +<H1>GLUT</H1> + +<p> +Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit). +GLUT is built automatically on systems which support it. +</p> +<p> +The GLUT tests, demos, examples, etc are not included, just the main library. +To obtain the latest complete release of GLUT please visit the +<a href="http://www.opengl.org/developers/documentation/glut/index.html" +target ="_parent">GLUT homepage</a> +</p> + + +</BODY> +</HTML> diff --git a/docs/envvars.html b/docs/envvars.html new file mode 100644 index 00000000000..38b212fc020 --- /dev/null +++ b/docs/envvars.html @@ -0,0 +1,25 @@ +<HTML> + +<TITLE>Environment Variables</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Environment Variables</H1> + +<p> +Mesa supports the following environment variables: +</p> +<ul> +<li>MESA_DEBUG - if defined, error messages are printed to stderr +<li>MESA_NO_DITHER - disable dithering, overriding glEnable(GL_DITHER) +<li>MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode (X only) +<li>MESA_CI_VISUAL - specifies the X visual and depth for CI mode (X only) +<li>MESA_BACK_BUFFER - specifies how to implement the back color buffer (X only) +<li>MESA_PRIVATE_CMAP - force aux/tk libraries to use private colormaps (X only) +<li>MESA_GAMMA - gamma correction coefficients (X only) +<li>MESA_XSYNC - enable synchronous X behavior (for X debugging only) +</ul> + + +</BODY> +</HTML> diff --git a/docs/extensions.html b/docs/extensions.html new file mode 100644 index 00000000000..b4906ec1fe3 --- /dev/null +++ b/docs/extensions.html @@ -0,0 +1,32 @@ +<HTML> + +<TITLE>Mesa Extensions</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Mesa Extensions</H1> + +<p> +A number of extensions have been developed especially for Mesa. +The specifications follow. +</p> + + +<UL> +<LI><A HREF="MESA_agp_offset.spec">MESA_agp_offset.spec</A> +<LI><A HREF="MESA_copy_sub_buffer.spec">MESA_copy_sub_buffer.spec</A> +<LI><A HREF="MESA_packed_depth_stencil.spec">MESA_packed_depth_stencil.spec</A> +<LI><A HREF="MESA_pack_invert.spec">MESA_pack_invert.spec</A> +<LI><A HREF="MESA_pixmap_colormap.spec">MESA_pixmap_colormap.spec</A> +<LI><A HREF="MESA_release_buffers.spec">MESA_release_buffers.spec</A> +<LI><A HREF="MESA_resize_buffers.spec">MESA_resize_buffers.spec</A> +<LI><A HREF="MESA_set_3dfx_mode.spec">MESA_set_3dfx_mode.spec</A> +<LI><A HREF="MESA_sprite_point.spec">MESA_sprite_point.spec</A> (obsolete) +<LI><A HREF="MESA_trace.spec">MESA_trace.spec</A> (obsolete) +<LI><A HREF="MESA_window_pos.spec">MESA_window_pos.spec</A> +<LI><A HREF="MESA_ycbcr_texture.spec">MESA_ycbcr_texture.spec</A> +</UL> + + +</BODY> +</HTML> diff --git a/docs/faq.html b/docs/faq.html new file mode 100644 index 00000000000..448def5274f --- /dev/null +++ b/docs/faq.html @@ -0,0 +1,330 @@ +<html> + +<head><title>Mesa FAQ</title></head> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + + +<center> +<h1>Mesa Frequently Asked Questions</h1> +Last updated: 7 March 2003 +</center> + +<br> +<br> +<h2>Index</h2> +<a href="#part1">1. High-level Questions and Answers</a> +<br> +<a href="#part2">2. Compilation and Installation Problems</a> +<br> +<a href="#part3">3. Runtime / Rendering Problems</a> +<br> +<a href="#part4">4. Developer Questions</a> +<br> +<br> +<br> + + + +<a name="part1"> +</a><h1><a name="part1">1. High-level Questions and Answers</a></h1> + +<h2><a name="part1">1.1 What is Mesa?</a></h2> +<p> +<a name="part1">Mesa is an open-source implementation of the OpenGL specification. +OpenGL is a high-level programming library for interactive 3D graphics. +See the </a><a href="http://www.opengl.org/">OpenGL website</a> for more +information. +</p> +<p> +Mesa 5.0.x supports the OpenGL 1.4 specification. +</p> + + +<h2>1.2 Does Mesa support/use graphics hardware?</h2> +<p> +Yes. Specifically, Mesa serves as the OpenGL core for the XFree86/DRI +OpenGL drivers. See the <a href="http://dri.sf.net/">DRI website</a> for +more information. +</p> +<p> +There have been other hardware drivers for Mesa over the years (such as +the 3Dfx Glide/Voodoo driver, an old S3 driver, etc) but the DRI drivers +are the modern ones. +</p> + +<h2>1.3 What purpose does (software) Mesa serve today?</h2> +<p> +Commercial, hardware-accelerated OpenGL implementations are available for +many operating systems today. +Still, Mesa serves at least these purposes: +</p> +<ul> +<li>Mesa is used as the core of the XFree86/DRI hardware drivers. +</li><li>Mesa is quite portable and allows OpenGL to be used on systems that have + no other OpenGL solution. +</li><li>Software rendering with Mesa serves as a reference for validating the + hardware drivers. +</li><li>A software implementation of OpenGL is useful for experimentation, such + as testing new rendering techniques. +</li><li>Mesa can render images with deep color channels: 16-bit integer and 32-bit + floating point color channels are supported. + This capability is only now appearing in hardware. +</li><li>Mesa's internal limits (max lights, clip planes, texture size, etc) can be + changed for special needs (hardware limits are hard to overcome). +</li></ul> + +<h2>1.4 How do I upgrade my DRI installation to use a new Mesa release?</h2> +<p> +You don't! The Mesa source code lives inside the XFree86/DRI source tree +and gets compiled into the individual DRI driver modules. +If you try to install Mesa over an XFree86/DRI installation, you'll lose +hardware rendering (because Mesa's libGL.so is different than the XFree86 +libGL.so). +</p> +<p> +The DRI developers will incorporate the latest release of Mesa into the +DRI drivers when the time is right. +</p> + +<h2>1.5 Are there other open-source implementations of OpenGL?</h2> +<p> +Yes, SGI's <a href="http://oss.sgi.com/projects/ogl-sample/index.html"> +OpenGL Sample Implemenation (SI)</a> is available. +The SI was written during the time that OpenGL was originally designed. +Unfortunately, development of the SI has stagnated. +Mesa is much more up to date with modern features and extensions. +</p> +<p> +<a href="http://www.dsbox.com/minigl.html">miniGL</a> is a subset of OpenGL +for PalmOS devices. + +<a href="http://fabrice.bellard.free.fr/TinyGL/">TinyGL</a> is another +subset of OpenGL. +</p> +<p> +There may be others but Mesa is the most popular and feature-complete. +</p> + +<br> +<br> + + +<a name="part2"> +</a><h1><a name="part2">2. Compilation and Installation Problems</a></h1> + + +<h2><a name="part2">2.1 What's the easiest way to install Mesa?</a></h2> +<p> +<a name="part2">If you're using a Linux-based system, your distro CD most likely already +has Mesa packages (like RPM or DEB) which you can easily install. +</a></p> + + +<h2><a name="part2">2.2 Running <code>configure; make</code> Doesn't Work</a></h2> +<p> +<a name="part2">Unfortunately, the GNU autoconf/automake/libtool system doesn't seem to work +too well on non GNU/Linux systems, even after installing gmake, gcc, etc. +For that reason, Mesa's <b>old-style</b> makefile system is still included. +The old-style system uses good old traditional Makefiles. Try the following: +</a></p><pre><a name="part2"> cd Mesa-x.y.z + cp Makefile.X11 Makefile + make +</a></pre> +<a name="part2">You'll see a list of system configurations from which to choose. +For example: +</a><pre><a name="part2"> make linux-x86 +</a></pre> +<p> +<a name="part2">If you're experienced with GNU autoconf/automake/libtool and think you can help +with maintence, contact the Mesa developers. +FYI, the Mesa developers generally don't use the autoconf/automake system. +We're especially annoyed with the fact that a +5000-line script (libtool) +is needed to make shared libraries (ugh). +</a></p> + +<h2><a name="part2">2.3 Mesa still doesn't compile</a></h2> +<p> +<a name="part2">If the old-style Makefile system doesn't work either, make sure you have +the most recent version of Mesa. +Otherwise, file a bug report or post to the Mesa3d-users mailing list. +Give as much info as possible when describing your problem. +</a></p> + + +<h2><a name="part2">2.4 I get undefined symbols such as bgnpolygon, v3f, etc...</a></h2> +<p> +<a name="part2">You're application is written in IRIS GL, not OpenGL. +IRIS GL was the predecessor to OpenGL and is a different thing (almost) +entirely. +Mesa's not the solution. +</a></p> + + +<h2><a name="part2">2.5 Where is the GLUT library?</a></h2> +<p> +<a name="part2">GLUT (OpenGL Utility Toolkit) is in the separate MesaDemos-x.y.z.tar.gz file. +If you don't already have GLUT installed, you should grab the MesaDemos +package and unpack it before compiling Mesa. +</a></p> + + + +<h2><a name="part2">2.6 What's the proper place for the libraries and headers?</a></h2> +<p> +<a name="part2">On Linux-based systems you'll want to follow the +</a><a href="http://oss.sgi.com/projects/ogl-sample/ABI/index.html">Linux ABI</a> +standard. +Basically you'll want the following: +</p> +<ul> +<li>/usr/include/GL/gl.h - the main OpenGL header +</li><li>/usr/include/GL/glu.h - the OpenGL GLU (utility) header +</li><li>/usr/include/GL/glx.h - the OpenGL GLX header +</li><li>/usr/include/GL/glext.h - the OpenGL extensions header +</li><li>/usr/include/GL/glxext.h - the OpenGL GLX extensions header +</li><li>/usr/include/GL/osmesa.h - the Mesa off-screen rendering header +</li><li>/usr/lib/libGL.so - a symlink to libGL.so.1 +</li><li>/usr/lib/libGL.so.1 - a symlink to libGL.so.1.xyz +</li><li>/usr/lib/libGL.so.xyz - the actual OpenGL/Mesa library. xyz denotes the +Mesa version number. +</li><li>/usr/lib/libGLU.so - a symlink to libGLU.so.1 +</li><li>/usr/lib/libGLU.so.1 - a symlink to libGLU.so.1.3.xyz +</li><li>/usr/lib/libGLU.so.xyz - the OpenGL Utility library. xyz denotes the Mesa +version number. +</li></ul> +<p> +After installing XFree86 and the DRI drivers, some of these files +may be symlinks into the /usr/X11R6/ tree. +</p> +<p> +The old-style Makefile system doesn't install the Mesa libraries; it's +up to you to copy them (and the headers) to the right place. +</p> +<p> +The GLUT header and library should go in the same directories. +</p> +<br> +<br> + + +<a name="part3"> +</a><h1><a name="part3">3. Runtime / Rendering Problems</a></h1> + +<h2><a name="part3">3.1 Rendering is slow / why isn't my graphics hardware being used?</a></h2> +<p> +<a name="part3">Stand-alone Mesa (downloaded as MesaLib-x.y.z.tar.gz) doesn't have any +support for hardware acceleration (with the exception of the 3DFX Voodoo +driver). +</a></p> +<p> +<a name="part3">What you really want is a DRI or NVIDIA (or another vendor's OpenGL) driver +for your particular hardware. +</a></p> +<p> +<a name="part3">You can run the <code>glxinfo</code> program to learn about your OpenGL +library. +Look for the GL_VENDOR and GL_RENDERER values. +That will identify who's OpenGL library you're using and what sort of +hardware it has detected. +</a></p> +<p> +<a name="part3">If your DRI-based driver isn't working, go to the +</a><a href="http://dri.sf.net/">DRI website</a> for trouble-shooting information. +</p> + + +<h2>3.2 I'm seeing errors in depth (Z) buffering. Why?</h2> +<p> +Make sure the ratio of the far to near clipping planes isn't too great. +Look +<a href="http://www.sgi.com/software/opengl/advanced97/notes/node18.html"> +here</a> for details. +</p> +<p> +Mesa uses a 16-bit depth buffer by default which is smaller and faster +to clear than a 32-bit buffer but not as accurate. +If you need a deeper you can modify the parameters to +<code> glXChooseVisual</code> in your code. +</p> + + +<h2>3.3 Why Isn't depth buffering working at all?</h2> +<p> +Be sure you're requesting a depth buffered-visual. If you set the MESA_DEBUG +environment variable it will warn you about trying to enable depth testing +when you don't have a depth buffer. +</p> +<p>Specifically, make sure <code>glutInitDisplayMode</code> is being called +with <code>GLUT_DEPTH</code> or <code>glXChooseVisual</code> is being +called with a non-zero value for GLX_DEPTH_SIZE. +</p> +<p>This discussion applies to stencil buffers, accumulation buffers and +alpha channels too. +</p> + + +<h2>3.4 Why does glGetString() always return NULL?</h2> +<p> +Be sure you have an active/current OpenGL rendering context before +calling glGetString. +</p> + + +<h2>3.5 GL_POINTS and GL_LINES don't touch the right pixels</h2> +<p> +If you're trying to draw a filled region by using GL_POINTS or GL_LINES +and seeing holes or gaps it's because of a float-to-int rounding problem. +But this is not a bug. +See Appendix H of the OpenGL Programming Guide - "OpenGL Correctness Tips". +Basically, applying a translation of (0.375, 0.375, 0.0) to your coordinates +will fix the problem. +</p> + +<br> +<br> + + +<a name="part4"> +</a><h1><a name="part4">4. Developer Questions</a></h1> + +<h2><a name="part4">4.1 How can I contribute?</a></h2> +<p> +<a name="part4">First, join the Mesa3d-dev mailing list. That's where Mesa development +is discussed. +</a></p> +<p> +<a name="part4">The </a><a href="http://www.opengl.org/developers/documentation/specs.html"> +OpenGL Specification</a> is the bible for OpenGL implemention work. +You should read it. +</p> +<p>Most of the Mesa development work involves implementing new OpenGL +extensions, writing hardware drivers (for the DRI), and code optimization. +</p> + +<h2>4.2 How do I write a new device driver?</h2> +<p> +Unfortunately, writing a device driver isn't easy. +It requires detailed understanding of OpenGL, the Mesa code, and your +target hardware/operating system. +3D graphics are not simple. +</p> +<p> +The best way to get started is to use an existing driver as your starting +point. +For a software driver, the X11 and OSMesa drivers are good examples. +For a hardware driver, the Radeon and R200 DRI drivers are good examples. +</p> +<p>The DRI website has more information about writing hardware drivers. +The process isn't well document because the Mesa driver interface changes +over time, and we seldome have spare time for writing documentation. +That being said, many people have managed to figure out the process. +</p> +<p> +Joining the appropriate mailing lists and asking questions (and searching +the archives) is a good way to get information. +</p> + + +</body> +</html> diff --git a/docs/games.html b/docs/games.html new file mode 100644 index 00000000000..5ed799866c1 --- /dev/null +++ b/docs/games.html @@ -0,0 +1,62 @@ +<HTML> + +<TITLE>Games</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Games</H1> + + +<ul> + <li><a href="http://www.psc.edu/%7Esmp/a3d/">Asteroids3D</a> - 3D asteroids game + </li><li><a href="http://evlweb.eecs.uic.edu/aej/AndyBattalion.html" target="_parent">Battalion</a> + - battle game + </li><li><a href="http://bzflag.sourceforge.net/" target="_parent">BZFLAG</a> - 3-D tank + battle game + </li><li><a href="http://www.speakeasy.org/%7Emorse/copter-commander">Copter Commander</a> - 2d multiplayer side scroller + </li><li><a href="http://www.crystalspace.org/" target="_parent">CrystalSpace</a> - Free + 3d game engine + </li><li><a href="http://www.afn.org/%7Ecthugha/" target="_parent">Cthugha</a> - music-sync'ed + graphical effects + </li><li><a href="http://www.sics.se/dive/" target="_parent">DIVE</a> - Distributed Interactive + Virtual Environment + </li><li><a href="http://www.newdoom.com/doomlegacy/" target="_parent">Doom Legacy</a> + - an OpenGL port of id software's popular game, Doom + </li><li><a href="http://www.asimov.de/intern_dropit.html" target="_parent">DropIt</a> - 3-D tetris game + </li><li><a href="http://www.flightgear.org/" target="_parent">Flight Gear</a> - Flight + simulator + </li><li><a href="http://freetrek.linuxgames.com/" target="_parent">Free Trek</a> - Star + Trek battle simulator + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">Gepetto</a> - Dance Choreography + </li><li><a href="http://glchess.sourceforge.net/" target="_parent">GLChess</a> - chess game + </li><li><a href="http://heretic.linuxgames.com/" target="_parent">GLHeretic</a> - Heretic + for Linux + </li><li><a href="http://glider3d.free.fr/" target="_parent">Glider3D</a> - flight simulator + </li><li><a href="http://www.gltron.org/" target="_parent">glTron</a> - Tron lightcycles + game + </li><li><a href="http://gracer.sourceforge.net/" target="_parent">GRacer</a> - 3D Motor + Sports Simulator + </li><li><a href="http://jongl.home.pages.de/" target="_parent">JONGL</a> - Juggling simulator + </li><li><a href="http://samba.anu.edu.au/KnightCap/" target="_parent">KnightCap</a> - + chess game + </li><li><a href="http://www.hackcraft.de/games/linwarrior_3d/">LinWarrior 3D</a> - A Battle Mech Simulator + </li><li><a href="http://www.nada.kth.se/%7Ef96-lfo/lunar/" target="_parent">Lunar Lander + 2000</a> - 3D version of the classis lunar lander game + </li><li><a href="http://www.majik3d.org/" target="_parent">Majik 3D</a> - an online role-playing + world + </li><li><a href="http://www.pobox.com/%7Eshankel/opentrek.html" target="_parent">OpenTrek</a> + - Super Star Trek + </li><li><a href="http://www.idsoftware.com/" target="_parent">Quake(2,3)</a> - the popular + games from id software + </li><li><a href="http://torcs.free.fr/indexm.html" target="_parent">TORCS</a> - car racing + simulator + </li><li><a href="http://www.woodsoup.org/projs/tux_aqfh" target="_parent">TUX-AQFH</a> + - Tux the Penguin - a Quest for Herring + </li><li><a href="http://mordred.8m.com/voidrunner/" target="_parent">Void Runner</a> + - freeware arcade style game + </li><li><a href="http://xracer.annexia.org/" target="_parent">XRacer</a> - Free spaceship + racing game, similar to Wipeout +</li></ul> + + +</body></html>
\ No newline at end of file diff --git a/docs/glu.html b/docs/glu.html new file mode 100644 index 00000000000..e3c9189b460 --- /dev/null +++ b/docs/glu.html @@ -0,0 +1,43 @@ +<HTML> + +<TITLE>SGI GLU</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>SGI SI GLU</H1> + +(Silicon Graphics, Inc. Sample Implementation of the OpenGL Utility library) + +<p> +SGI open-sourced their OpenGL Sample Implementation (SI) in January, 2000. +This includes the GLU library. +</p> + +<p> +The SI GLU library implements GLU version 1.3 whereas the original +Mesa GLU library only implemented version 1.2. +We recommend using the SI GLU library instead of Mesa's GLU library +since it's more up-to-date, complete and reliable. +We're no longer developing the original Mesa GLU library. +</p> + +<p> +The new SI GLU library code is included in the Mesa package. +You don't have to download it separately. +</p> + + +<p> +<b>Olivier Michel</b> has made Linux RPMs of GLU for i386 and PowerPC. +You can download them from the +<a href="http://www.sourceforge.net/project/showfiles.php?group_id=3" +target="_parent">download area</a> under <b>Miscellaneous</b>. +</p> + +<p> +Visit the <a href="http://oss.sgi.com/projects/ogl-sample/" target="_parent"> +OpenGL Sample Implementation home page</a> for more information about the SI. +</p> + +</body> +</html> diff --git a/docs/helpwanted.html b/docs/helpwanted.html new file mode 100644 index 00000000000..b9434d0c034 --- /dev/null +++ b/docs/helpwanted.html @@ -0,0 +1,62 @@ +<HTML> + +<TITLE>Help Wanted</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Help Wanted</H1> + +<p> +We can always use more help with the Mesa project. Here are some +specific areas. If you think you can help out, post to the mesa3d-dev +mailing list. +</p> + +<ul> +<li>Windows 98/NT build/driver maintenance and testing (Karl Schultz has been + doing a great job of this lately) +<li>DOS/DJGPP build/driver maintenance and testing +<li>GGI driver/build maintenance and testing +<li>GNU autoconfig/libtool maintenance (esp. on non-Linux systems) +<li>x86, SSE, 3DNow! and SPARC assembly language programming +<li>Implement WGL font functions in the WGL interface code +<li>Implement off-screen bitmap rendering support in the WGL interface code +<li>Help with writing/testing the new NV_fragment_program extension code +<li>Implement the ARB_vertex/fragment extensions +<li>Download/compile/test Mesa and report any bugs found +</ul> + + +<p> +If you want to help with Mesa, first join the Mesa developer's +mailing list. Then post a message explaining what you might like +to help with. The Mesa web page has a list of a few work items +which you may consider. +</p> + +</p> +Anyone is welcome to contribute code to the Mesa project, provided you +agree to the copyright terms of the relevant code. See the COPYRIGHT +file. +</p> + +<p> +Unfortunately, all the easy work in Mesa was done years ago. Nowadays, the +work is rather complicated and not suited to beginners. +</p> + +<p> +If you're contribution code to the Mesa library itself: +<p> +<ol> +<li>Try to write clean code (uniform indentation, comments, meaningful + identifiers, etc). It must be readable and maintainable! + +<li>Test your code. On several occations I've incorporated code from + users which later turned out to have bugs. Now, I'm pretty hesitant + to use code which doesn't look good. +</ol> + + +</BODY> +</HTML> diff --git a/docs/index.html b/docs/index.html index 9b3c717b540..0edf4325223 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,92 +1,23 @@ -<HTML> -<HEAD> - <TITLE>Index to Mesa Documentation</TITLE> -</HEAD> +<html> -<BODY> +<title>Mesa Home Page</title></head> -<H1>Main Documentation</H1> -<UL> -<LI><A HREF="README">README</A> - general, top-level documentation -<LI><A HREF="INSTALL">INSTALL</A> - compilation/installation instructions for - Unix/X11 -<LI><A HREF="VERSIONS">VERSIONS</A> - version history / change log -<LI><A HREF="COPYRIGHT">COPYRIGHT</A> - copyright and license information -<LI><A HREF="COPYING">COPYING</A> - some parts of Mesa are GPL'd -<LI><A HREF="CONFORM">CONFORM</A> - - results of running the OpenGL conformance tests -<LI><A HREF="DEVINFO">DEVINFO</A> - information for Mesa developers -<LI><A HREF="http://www.mesa3d.org/">www.mesa3d.org</A> - Mesa website -</UL> -<H1>Platform and Driver Information</H1> -<P> -Be warned, some of these files may be very out of date. -</P> -<UL> -<LI><A HREF="README.X11">README.X11</A> - X Window System / Unix / Linux -<LI><A HREF="README.WIN32">README.WIN32</A> - Microsoft Windows -<LI><A HREF="README.VMS">README.VMS</A> - DEC VMS -<LI><A HREF="README.GGI">README.GGI</A> - GGI -<LI><A HREF="README.3DFX">README.3DFX</A> - 3Dfx/Glide driver -<LI><A HREF="README.AMIWIN">README.AMIWIN</A> - Amiga Amiwin -<LI><A HREF="README.BEOS">README.BEOS</A> - BeOS -<LI><A HREF="README.D3D">README.D3D</A> - Direct3D driver -<LI><A HREF="README.DJ">README.DJ</A> - DJGPP -<LI><A HREF="README.LYNXOS">README.LYNXOS</A> - LynxOS -<LI><A HREF="README.MINGW32">README.MINGW32</A> - Mingw32 -<LI><A HREF="README.NeXT">README.NeXT</A> - NeXT -<LI><A HREF="README.OpenStep">README.OpenStep</A> - OpenStep -<LI><A HREF="README.OS2">README.OS2</A> - OS/2 -<LI><A HREF="README.WINDML">README.WINDML</A> - WindML -</UL> +<frameset rows="50,100% " border="1" framespacing="1" frameborder="yes"> +<frame src="banner.html" name="BannerFrame" scrolling="no" marginwidth="1" marginheight="1" resize=""> +<frameset cols="28%,72% " border="1" framespacing="1" frameborder="yes"> +<frame src="contents.html" name="ContentsFrame" marginwidth="2" marginheight="1" resize=""> +<frame src="news.html" name="MainFrame" marginwidth="3" marginheight="1" resize=""> +</frameset> +</frameset> -<H1>Release Notes</H1> -<UL> -<LI><A HREF="RELNOTES-5.1">RELNOTES-5.1</A> -<LI><A HREF="RELNOTES-5.0">RELNOTES-5.0</A> -<LI><A HREF="RELNOTES-4.1">RELNOTES-4.1</A> -<LI><A HREF="RELNOTES-4.0.3">RELNOTES-4.0.3</A> -<LI><A HREF="RELNOTES-4.0.2">RELNOTES-4.0.2</A> -<LI><A HREF="RELNOTES-4.0.1">RELNOTES-4.0.1</A> -<LI><A HREF="RELNOTES-4.0">RELNOTES-4.0</A> -<LI><A HREF="RELNOTES-3.5">RELNOTES-3.5</A> -<LI><A HREF="RELNOTES-3.4.2">RELNOTES-3.4.2</A> -<LI><A HREF="RELNOTES-3.4.1">RELNOTES-3.4.1</A> -<LI><A HREF="RELNOTES-3.4">RELNOTES-3.4</A> -<LI><A HREF="RELNOTES-3.3">RELNOTES-3.3</A> -<LI><A HREF="RELNOTES-3.2.1">RELNOTES-3.2.1</A> -<LI><A HREF="RELNOTES-3.2">RELNOTES-3.2</A> -<LI><A HREF="RELNOTES-3.1">RELNOTES-3.1</A> -</UL> +<noframes> -<H1>Mesa Extension Specifications</H1> -<UL> -<LI><A HREF="MESA_agp_offset.spec">MESA_agp_offset.spec</A> -<LI><A HREF="MESA_copy_sub_buffer.spec">MESA_copy_sub_buffer.spec</A> -<LI><A HREF="MESA_packed_depth_stencil.spec">MESA_packed_depth_stencil.spec</A> -<LI><A HREF="MESA_pack_invert.spec">MESA_pack_invert.spec</A> -<LI><A HREF="MESA_pixmap_colormap.spec">MESA_pixmap_colormap.spec</A> -<LI><A HREF="MESA_release_buffers.spec">MESA_release_buffers.spec</A> -<LI><A HREF="MESA_resize_buffers.spec">MESA_resize_buffers.spec</A> -<LI><A HREF="MESA_set_3dfx_mode.spec">MESA_set_3dfx_mode.spec</A> -<LI><A HREF="MESA_sprite_point.spec">MESA_sprite_point.spec</A> (obsolete) -<LI><A HREF="MESA_trace.spec">MESA_trace.spec</A> (obsolete) -<LI><A HREF="MESA_window_pos.spec">MESA_window_pos.spec</A> -<LI><A HREF="MESA_ycbcr_texture.spec">MESA_ycbcr_texture.spec</A> -</UL> +<BODY> -<H1>Source Code Documentation</H1> -<P> -<A HREF="http://www.doxygen.org">Doxygen</A> is used to automatically -produce cross-referenced documentation from the Mesa sources. -This is not included in the normal Mesa distribution. -Download Mesa from CVS if interested. -</P> <P> -<A HREF="../doxy/core/index.html">Source documentation</A> -</P> +</body> -</BODY> -</HTML> +</noframes> +</html>
\ No newline at end of file diff --git a/docs/install.html b/docs/install.html new file mode 100644 index 00000000000..1dedfa19c45 --- /dev/null +++ b/docs/install.html @@ -0,0 +1,295 @@ +<HTML> + +<TITLE>Compilation and Installation</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Compilation and Installation for Unix/X11</H1> + +<p> +If you're not using a variant of Unix with X11, see the +<a href="systems.html">Supported Systems and Drivers</a> section +for instructions. +</p> + +<p> +There are two methods for building Mesa on Unix/X11 systems: +</p> + +<dl> +<dt><a href="#new">NEW-STYLE</a><dt> +<dd> +Basically, type "./configure" followed by "make" +This <em>should</em> work on most Unix-like operating systems. +Unfortunately, autoconf/automake seems to seldom work reliably on non-Linux +systems. For that reason, the old-style make system is still supported +(and is the preferred method of the Mesa developers). +</dd> +<br> +<dt><a href="#old">OLD-STYLE</a><dt> +<dd> +Simply type <code>make</code> and you'll see a list of supported +system configurations. Pick one and type <code>make</code> <em>config</em>. +More details below. +</dd> +</dl> + +<p> +<B>NOTE</b>: The GLUT library and demonstrations programs are in the +MesaDemos-x.y.z.tar.gz file. If you don't have GLUT or you want to +run some demos, download the MesaDemos package too. +</p> + +<p> +In either case, building Mesa entails the following: +<p> +<ul> +<li>Compiling libGL, the OpenGL-replacement library. +<li>Compiling libGLU, the OpenGL Utility library. +<li>Compiling libglut, the GLUT library (if you downloaded the Mesa demos +package) +<li>Compiling the demonstration programs in the directories: +<code>demos, xdemos, samples</code> and <code>book</code> +(if you downloaded the Mesa demos package.) +</ul> + + +<a name="new"> +<H2>NEW-STYLE compilation and installation</H2> + +<pre> +0) If you've downloaded Mesa via CVS there will not be a "configure" + script. You'll have to run the "bootstrap" script first. This script + may not work on any OS other than Linux. You'll need these programs + to run the bootstrap script: + + autoconf 2.50 + automake 1.4-p2 + libtool 1.4 + + +1) Run the configure script + + ./configure [options] + +For Linux, it is recommended that you use: + ./configure --prefix=/usr +So that the headers and libs are located according to the Linux/OpenGL +standard spec at http://oss.sgi.com/projects/ogl-sample/ABI/ + +Possible options are: + +--prefix=DIR + The toplevel directory of the hierachy in which Mesa + will be installed (DIR/include,DIR/lib etc.). + The default is "/usr/local". + +--sysconfdir=DIR + The directory where Mesa configuration files + will be stored. The default is "$prefix/etc". + You may want to overwrite the default with --sysconfdir=/etc. + +--enable-static + Enable building of static libraries. + Static libraries are NOT built by default. + +--disable-shared + Disable building of shared libraries. + Shared libraries are built by default. + +--with-pic +--without-pic + In normal operation, libtool will build shared libraries from + PIC objects and static archives from non-PIC objects, except where one + or the other is not provided by the target host. By specifying + --with-pic you are asking libtool to build static archives from + PIC objects, and similarly by specifying --without-pic you are asking + libtool to build shared libraries from non-PIC objects. + libtool will only honour this flag where it will produce a + working library, otherwise it reverts to the default. + +--enable-debug + Enable debugging messages (disabled by default). + +--enable-profile + Enable profiling (disabled by default). + +--disable-optimize + Disable extra optimizations (enabled by default, + i.e., optimize for maximum performance). + +--enable-warn + Enable extended compiler warnings (disabled by default). + +--enable-x86[=ARG] +--disable-x86 + Enable/disable x86 assembler support to speed up Mesa + (autodetected by default). You may set `on' or `off'. + +--enable-3dnow[=ARG] +--disable-3dnow + Enable/disable 3Dnow support to speed up Mesa + (autodetected by default). You may set `on' or `off'. + +--enable-mmx[=ARG] +--disable-mmx + Enable/disable MMX support to speed up Mesa + (autodetected by default). You may set `on' or `off'. + +--enable-sse[=ARG] +--disable-sse + Enable/disable SSE support to speed up Mesa + (autodetected by default). You may set `on' or `off'. + If you have a PentiumIII and want to use SSE make sure you have the + PIII Linux kernel-patch installed or things will fail! + You can get the patch from http://www.redhat.com/~dledford/linux_kernel.html + +--with-glide[=DIR] +--without-glide + Enable/disable support for Glide (disabled by default). + DIR is the installation directory of Glide. + If Glide cannot be found, the driver won't be built. + +--with-glut[=DIR] +--without-glut + Don't/use already-installed GLUT (autodetected by default). + DIR is the installation directory of Glut. + If GLUT cannot be found, the version shipped with Mesa will be built. + +--with-ggi[=DIR] +--without-ggi + Enable/disable support for GGI (autodetected by default). + DIR is the installation directory of GGI. + If GGI cannot be found, the driver won't be built. + +--disable-ggi-fbdev + Don't build the GGI fbdev target (autodetected by default). + +--disable-ggi-genkgi + Don't build the GGI generic KGI driver (autodetected by default). + +--disable-ggi-savage4 + Don't build the GGI Savage4 KGI driver (autodetected by default). + +--disable-osmesa + Disable OSmesa (offscreen rendering) support (enabled by default). + +--with-svga[=DIR] +--without-svga + Enable/disable support for SVGALib (autodetected by default). + DIR is the installation directory of SVGALib. + If SVGALib cannot be found, the driver won't be built. + +--x-includes=DIR + Search for the X include files in DIR. + +--x-libraries=DIR + Search for the X library files in DIR. + +User specific compiler options can be set using the shell variable +CFLAGS. For instance, + CFLAGS="-g -O2" ./configure +(on some systems: env CFLAGS="-g -O2" ./configure) +sets the compiler flags to "-g -O2". + +For more options run "./configure --help" and read INSTALL.GNU. + +2) To build the Mesa libraries run: + + make + +When finished, libGL.so will be in src/.libs/, libGLU.so will be in +si-glu/.libs/, etc. + +Optionally, you can strip the libraries using + + make strip + +Now make sure that you have the permissions to install Mesa in the +specified directories, for example, by becoming super user ("su") +Then run: + + make install + +Mesa is now installed. +Please don't move the installed files but rerun all installation +steps if you want to use other directories. + + +3) To test whether Mesa works properly you might want to run the Mesa demos: + + make check + +Builds all demos. + + make exec + +Builds and executes all demos. +</pre> + + +<a name="old"> +<H2>OLD-STYLE compilation and installation</H2> + +<p> +This procedure usually works when <code>./configure ; make</code> fails. +</p> + +<p> +<b>Note</b>: If you tried <code>./configure ; make</code> but it failed, +first copy the top-level <code>Makefile.X11</code> file over +<code>Makefile</code>. +</p> + +<p> +First, just type <code>make</code> alone. +You'll see a list of supported system configurations. +Choose one and type <code>make</code> <em>config</em>. +The Mesa libraries and demo programs will be compiled. +</p> + +<H3>Header and library files</H3> + +<p> +The standard location for the OpenGL header files on Unix-type systems is +in <code>/usr/include/GL/</code>. +The standard location for the libraries is <code>/usr/lib/</code>. +For more information see, the +<a href="http://oss.sgi.com/projects/ogl-sample/ABI/" target="_parent"> +Linux/OpenGL ABI specification</a>. +</p> + +<p> +If you'd like Mesa to co-exist with another implementation of OpenGL that's +already installed, you'll have to choose different directories, like +<code>/usr/local/include/GL/</code> and <code>/usr/local/lib/</code>. +</p> + +<p> +To install the Mesa headers, do this: +<pre> + cp -r include/GL /usr/include +</pre> + +<p> +To install the Mesa libraries, do this: +</p> +<pre> + cp -pd lib/* /usr/lib + + (The -pd options preserve symbolic links) +</pre> + +<H3>LD_LIBRARY_PATH</H3> + +<p> +On Linux and similar operating systems the <code>LD_LIBRARY_PATH</code> +environment variable can be used to indicate a list of directories to +search for shared libraries. +If you don't install Mesa in <code>/usr/lib/</code> you may have to +set the <code>LD_LIBRARY_PATH</code> variable in order to use the Mesa +libraries. +</p> + +</body> +</html> diff --git a/docs/intro.html b/docs/intro.html new file mode 100644 index 00000000000..58c39dabc2d --- /dev/null +++ b/docs/intro.html @@ -0,0 +1,255 @@ +<HTML> + +<TITLE>Mesa Introduction</TITLE> + +<BODY text="#000000" bgcolor="#55bbff"> + +<H1>Introduction</H1> + +<p> +Mesa is a 3-D graphics library with an API which is very similar to +that of <a href="http://www.opengl.org/" target="_parent">OpenGL</a>.* +To the extent that Mesa utilizes the OpenGL command syntax or state +machine, it is being used with authorization from <a +href="http://www.sgi.com/" target="_parent">Silicon Graphics, +Inc.</a>(SGI). However, the author does not possess an OpenGL license +from SGI, and makes no claim that Mesa is in any way a compatible +replacement for OpenGL or associated with SGI. Those who want a +licensed implementation of OpenGL should contact a licensed +vendor. +</p> + +<p> +Please do not refer to the library as <em>MesaGL</em> (for legal +reasons). It's just <em>Mesa</em> or <em>The Mesa 3-D graphics +library</em>. <br> +</p> + +<p> +* OpenGL is a trademark of <a href="http://www.sgi.com/" +target="_parent">Silicon Graphics Incorporated</a>. +</p> + + +<H1>Project History</H1> + +<p> +The Mesa project was founded by me, Brian Paul. Here's a short history +of the project. +</p> + +<p> +August, 1993: I begin working on Mesa in my spare time. The project +has no name at that point. I was simply interested in writing a simple +3D graphics library that used the then-new OpenGL API. I was partially +inspired by the <em>VOGL</em> library which emulated a subset of IRIS GL. +I had been programming with IRIS GL since 1991. +</p> + +<p> +November 1994: I contact SGI to ask permission to distribute my OpenGL-like +graphics library on the internet. SGI was generally receptive to the +idea and after negotiations with SGI's legal department, I get permission +to release it. +</p> + +<p> +February 1995: Mesa 1.0 is released on the internet. I expected that +a few people would be interested in it, but not thousands. +I was soon receiving patches, new features and thank-you notes on a +daily basis. That encouraged me to continue working on Mesa. The +name Mesa just popped into my head one day. SGI had asked me not to use +the terms <em>"Open"</em> or <em>"GL"</em> in the project name and I didn't +want to make up a new acronym. Later, I heard of the Mesa programming +language and the Mesa spreadsheet for NeXTStep. +</p> + +<p> +In the early days, OpenGL wasn't available on too many systems. +It even took a while for SGI to support it across their product line. +Mesa filled a big hole during that time. +For a lot of people, Mesa was their first introduction to OpenGL. +I think SGI recognized that Mesa actually helped to promote +the OpenGL API, so they didn't feel threatened by the project. +</p> + + +<p> +1995-1996: I continue working on Mesa both during my spare time and during +my work hours at the Space Science and Engineering Center at the University +of Wisconsin in Madison. My supervisor, Bill Hibbard, lets me do this because +Mesa is now being using for the <a href="http://www.ssec.wisc.edu/%7Ebillh/vis.html" target="_parent">Vis5D</a> project. +</p><p> +October 1996: Mesa 2.0 is released. It implementes the OpenGL 1.1 specification. +</p> + +<p> +March 1997: Mesa 2.2 is released. It supports the new 3dfx Voodoo graphics +card via the Glide library. It's the first really popular hardware OpenGL +implementation for Linux. +</p> + +<p> +September 1998: Mesa 3.0 is released. It's the first publicly-available +implementation of the OpenGL 1.2 API. +</p> + +<p> +March 1999: I attend my first OpenGL ARB meeting. I contribute to the +development of several official OpenGL extensions over the years. +</p> + +<p> +September 1999: I'm hired by Precision Insight, Inc. Mesa is a key +component of 3D hardware acceleration in the new DRI project for XFree86. +Drivers for 3dfx, 3dLabs, Intel, Matrox and ATI hardware soon follow. +</p> + +<p> +October 2001: Mesa 4.0 is released. +It implements the OpenGL 1.3 specification. +</p> + + +<p> +November 2001: I cofound <a href="http://www.tungstengraphics.com" target="_parent"> +Tungsten Graphics, Inc.</a> with Keith Whitwell, Jens Owen, David Dawes and +Frank LaMonica. +I continue to develop Mesa as part of my resposibilities with Tungsten +Graphics and as a spare-time project. +</p> + +<p> +November 2002: Mesa 5.0 is released. +It implements the OpenGL 1.4 specification. +</p> + +<p> +Ongoing: Mesa is used as the core of many hardware OpenGL drivers for XFree86 +within the +<A href="http://dri.sourceforge.net/" target="_parent">DRI project</A>. +I continue to enhance Mesa with new extensions and features. +</p> + + + +<H1>Major Versions</H1> + +<p> +This is a summary of the major versions of Mesa. Note that Mesa's major +version number tracks OpenGL's minor version number. +</p> + + +<H2>Version 5.x features</H2> +<p> +Version 5.x of Mesa implements the OpenGL 1.4 API with the following +extensions incorporated as standard features: +</p> +<ul> +<li>GL_ARB_depth_texture +<li>GL_ARB_shadow +<li>GL_ARB_texture_env_crossbar +<li>GL_ARB_texture_mirror_repeat +<li>GL_ARB_window_pos +<li>GL_EXT_blend_color +<li>GL_EXT_blend_func_separate +<li>GL_EXT_blend_logic_op +<li>GL_EXT_blend_minmax +<li>GL_EXT_blend_subtract +<li>GL_EXT_fog_coord +<li>GL_EXT_multi_draw_arrays +<li>GL_EXT_point_parameters +<li>GL_EXT_secondary_color +<li>GL_EXT_stencil_wrap +<li>GL_SGIS_generate_mipmap +</ul> + + +<H2>Version 4.x features</H2> + +<p> +Version 4.x of Mesa implements the OpenGL 1.3 API with the following +extensions incorporated as standard features: +</p> + +<ul> +<li>GL_ARB_multisample +<li>GL_ARB_multitexture +<li>GL_ARB_texture_border_clamp +<li>GL_ARB_texture_compression +<li>GL_ARB_texture_cube_map +<li>GL_ARB_texture_env_add +<li>GL_ARB_texture_env_combine +<li>GL_ARB_texture_env_dot3 +<li>GL_ARB_transpose_matrix +</ul> + +<H2>Version 3.x features</H2> + +<p> +Version 3.x of Mesa implements the OpenGL 1.2 API with the following +features: +</p> +<ul> +<li>BGR, BGRA and packed pixel formats +<li>New texture border clamp mode +<li>glDrawRangeElements() +<li>standard 3-D texturing +<li>advanced MIPMAP control +<li>separate specular color interpolation +</ul> + + +<H2>Version 2.x features</H2> +<p> +Version 2.x of Mesa implements the OpenGL 1.1 API with the following +features. +</p> +<ul> +<li>Texture mapping: + <ul> + <li>glAreTexturesResident + <li>glBindTexture + <li>glCopyTexImage1D + <li>glCopyTexImage2D + <li>glCopyTexSubImage1D + <li>glCopyTexSubImage2D + <li>glDeleteTextures + <li>glGenTextures + <li>glIsTexture + <li>glPrioritizeTextures + <li>glTexSubImage1D + <li>glTexSubImage2D + </ul> +<li>Vertex Arrays: + <ul> + <li>glArrayElement + <li>glColorPointer + <li>glDrawElements + <li>glEdgeFlagPointer + <li>glIndexPointer + <li>glInterleavedArrays + <li>glNormalPointer + <li>glTexCoordPointer + <li>glVertexPointer + </ul> +<li>Client state management: + <ul> + <li>glDisableClientState + <li>glEnableClientState + <li>glPopClientAttrib + <li>glPushClientAttrib + </ul> +<li>Misc: + <ul> + <li>glGetPointer + <li>glIndexub + <li>glIndexubv + <li>glPolygonOffset + </ul> +</ul> + + +</body> +</html> diff --git a/docs/libraries.html b/docs/libraries.html new file mode 100644 index 00000000000..44324e7610b --- /dev/null +++ b/docs/libraries.html @@ -0,0 +1,55 @@ +<HTML> + +<TITLE>Libraries and Toolkits</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Libraries and Toolkits</H1> + +<ul> +<li><a href="http://mrpowers.com/Apprentice/">Apprentice</a> - free OpenInventor work-alike +<li><a href="http://www.coin3d.org/coin.html" target="_parent">Coin</a> - OSS Open Inventor clone +<li><a href="http://www.softintegration.com/products/toolkit/opengl/" target="_parent">Ch</a> - OpenGL bindings for the Ch C/C++ interpreter +<li><a href="http://www.cfdrc.com/FOX/fox.html" target="_parent">FOX</a> - GUI Library +<li><a href="http://www.jausoft.com/gl4java.html" target="_parent">GL4Java</a> - a Java wrapper for OpenGL +<li><a href="http://www.student.oulu.fi/%7Ejlof/gtkglarea/" target="_parent">GtkGLArea</a> - OpenGL Gtk widget +<li><a href="http://www.ece.ucdavis.edu/%7Ekenelson/gtk-glarea/" target="_parent">GtkGLArea--</a> - OpenGL Gtk-- widget for C++ +<li><a href="http://gtkpas.sourceforge.net/" target="_parent">GTKpas</a> - OpenGL Gtk widget for <a href="http://www.freepascal.org/" target="_parent">FreePascal</a> +<li><a href="http://freeglut.sourceforge.net/" target="_parent">FreeGLUT</a> - a GLUT work-alike +<li><a href="http://math.nist.gov/f90gl" target="_parent">Fortran77/90 bindings for OpenGL and Mesa</a> - by William Mitchell +<li><a href="http://glow.sourceforge.net/" target="_parent">GLOW</a> - a GUI toolkit for GLUT and OpenGL +<li><a href="http://www.nigels.com/glt/">Glt</a> - an OpenGL C++ toolkit +<li><a href="http://www.opengl.org/developers/documentation/glut/" target="_parent">GLUT (GL Utility Toolkit)</a> - by Mark Kilgard +<li><a href="http://atrey.karlin.mff.cuni.cz/%7E0rfelyus/guileGL/" target="_parent">GuileGL</a> - OpenGL and GtkGLArea language bindings for Guile +<li><a href="http://www.rsinc.com/" target="_parent">IDL</a> - Interactive Data Language +<li><a href="http://www.newplanetsoftware.com/jx/" target="_parent">JX</a> - C++ application framework and GUI library +<li><a href="http://www.vrs3d.org/" target="_parent">MAM/VRS</a> - object-oriented toolkit for 3D graphics +<li><a href="http://www.jwdt.com/%7Epaysan/bigforth.html" target="_parent">MINOS</a> - GUI library +<li><a href="http://sourceforge.net/project/?group_id=2795" target="_parent">OglCLib</a> - C++ wrapper for OpenGL +<li><a href="http://oss.sgi.com/projects/inventor" target="_parent"> Open Inventor</a> - the Open Inventor toolkit from SGI +<li><a href="http://www.tgs.com/" target="_parent">Open Inventor</a> - the Open Inventor toolkit from Template Graphics Software, Inc. +<li><a href="http://openrm.sourceforge.net/" target="_parent">OpenRM</a> +- Open Source, multithreaded, parallel scene graph API +<li><a href="http://www.opensg.org/OpenSGPLUS/index.EN.html" target="_parent"> +Open SG PLUS</a> - a scene-graph library +<li><a href="http://www.openscenegraph.org/" target="_parent">Open Scene Graph +</a> - a scene-graph library +<li><a href="http://www.openvrml.org/" target="_parent">OpenVRML</a> +- a VRML parsing/display library with "lookat" - an example VRML browser +<li><a href="http://www.woodsoup.org/projs/plib" target="_parent">PLIB</a> - A collection of portable games libraries, including an OpenGL GUI and a simple Scene Graph API +<li><a href="ftp://ftp.troll.no/contest/Pryan-1.2.tar.gz" target="_parent">Pryan</a> - an OpenInventor-like toolkit +<li><a href="http://starship.python.net:9673/crew/da/Code/PyOpenGL" target="_parent">PyOpenGL</a> - OpenGL interface for Python +<li><a href="http://www.quesa.org/" target="_parent">Quesa</a> - QuickDraw3D-compatible library based on OpenGL, Mesa or Direct3D +<li><a href="http://www.mesa3d.org/brianp/repgl.txt" target="_parent">repGL</a> - IRIS GL emulated with OpenGL +<li><a href="http://www.scitechsoft.com/dp_mgl.html" target="_parent">SciTech MGL</a> - A multiplatform (Windows, Linux, OS/2, DOS, QNX, SMX, RT-Target & more) graphics library +<li><a href="http://sgl.sourceforge.net/" target="_parent">SGL</a> - a 3D Scene Graph Library +<li><a href="http://www.lal.in2p3.fr/SI/SoFree/" target="_parent">SoFree</a> - a free implementation of Open Inventor +<li><a href="http://togl.sourceforge.net/" target="_parent">Togl</a> - Tcl/Tk widget for OpenGL +<li><a href="http://mesa3d.sourceforge.net/notfound.html">VLE</a> - Virtual Reality Toolkit +<li><a href="http://www.int.com/" target="_parent">View3D Widget</a> - 3-D GUI widget +<li><a href="http://www.kitware.com/vtk.html" target="_parent">VTK</a> - Visualization Toolkit +<li><a href="http://home.earthlink.net/%7Erzeh/YAJOGLB/doc/YAJOGLB.html" target="_parent">YAJOGL</a> - Yet Another Java GL Binding. +</ul> + + +</body></html>
\ No newline at end of file diff --git a/docs/license.html b/docs/license.html new file mode 100644 index 00000000000..475baaaa9c6 --- /dev/null +++ b/docs/license.html @@ -0,0 +1,115 @@ +<HTML> + +<TITLE>License / Cppyright Information</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>License / Copyright Information</H1> + +<p> +The Mesa distribution consists of several components. Different copyrights +and licenses apply to different components. For example, GLUT is copyrighted +by Mark Kilgard, some demo programs are copyrighted by SGI, some of the Mesa +device drivers are copyrighted by their authors. See below for a list of +Mesa's components and the copyright/license for each. +</p> +<p> +The core Mesa library is licensed according to the terms of the XFree86 +copyright (an MIT-style license). This allows integration with the +XFree86/DRI project. Unless otherwise stated, the Mesa source code and +documentation is licensed as follows: +</p> + +<pre> +Copyright (C) 1999-2003 Brian Paul All Rights Reserved. + +Permission is hereby granted, free of charge, to any person obtaining a +copy of this software and associated documentation files (the "Software"), +to deal in the Software without restriction, including without limitation +the rights to use, copy, modify, merge, publish, distribute, sublicense, +and/or sell copies of the Software, and to permit persons to whom the +Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN +AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +</pre> + + +<H1>Attention, Contributors</H1> + +<p> +When contributing to the Mesa project you must agree to relinquish your +work to the holder of the copyright for the particular component you're +contributing to. That is, you can't put your own copyright on the code, +unless it's a modular piece that can be omitted from Mesa (like a new +device driver). If for example, you contribute a bug fix to Mesa's +texture mapping code, your code will become a part of the body of work +which is copyrighted by Brian Paul and licensed by the above terms. +</p> + +<pre> +Mesa Component Licenses: + +Component Files Primary Author License +---------------------------------------------------------------------------- +core Mesa code src/*.[ch] Brian Paul Mesa + include/GL/gl.h + +GLX driver src/X/* Brian Paul Mesa + include/GL/glx.h + include/GL/xmesa.h + +OS/Mesa driver src/OSmesa/* Brian Paul Mesa + include/GL/osmesa.h + +3Dfx driver src/FX/* David Bucciarelli Mesa + include/GL/fxmesa.h + +BeOS R4 driver src/BeOS/* Brian Paul Mesa + +MGL driver src/MGL/* SciTech, Inc SciTech copyright + include/GL/mglmesa.h + +Windows driver src/Windows/* Li Wei copyright by Li Wei + include/GL/wmesa.h + +SVGA driver src/SVGA/* Brian Paul GNU-LGPL + include/GL/svgamesa.h + +DOS driver src/DOS/* Charlie Wallace GNU-LGPL + include/GL/dosmesa.h + +GGI driver src/GGI/* Uwe Maurer GNU-LGPL + include/GL/ggimesa.h + +S3 driver src/S3/* S3, Inc. S3 copyright + +GLUT src-glut/* Mark Kilgard Mark's copyright + include/GL/*glut*.h + +GLU library src-glu/* Brian Paul GNU-LGPL + +SI GLU library si-glu/* SGI SGI Free B + include/GL/glu.h + +Ext registry include/GL/glext.h SGI SGI Free B + include/GL/glxext.h + +demo programs demos/* various see source files + +X demos xdemos/* Brian Paul see source files + +SGI demos samples/* SGI SGI copyright + +RedBook demos book/* SGI SGI copyright +</pre> + +</body> +</html> diff --git a/docs/lists.html b/docs/lists.html new file mode 100644 index 00000000000..2c97d88a1b4 --- /dev/null +++ b/docs/lists.html @@ -0,0 +1,51 @@ +<HTML> + +<TITLE>Mesa Mailing Lists</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Mailing Lists</H1> + + +<p>There are four Mesa mailing lists:</p> +<ul> +<li><b>mesa3d-users</b> - intended for users of the Mesa library. +Newbie questions are appropriate, but please try reading the Mesa documentation first. +</li><li><b>mesa3d-dev</b> - intended for developers of the Mesa library. +This is not for beginners. +</li><li><b>mesa3d-cvs</b> - CVS check-in messages are sent to this list. +This is useful for tracking ongoing development changes. +</li><li><b>mesa3d-announce</b> - announcements of new Mesa versions are sent to this list. +</li></ul> + +<p> +To subscribe or unsubscribe, go to the +<a href="http://www.sourceforge.net/mail/?group_id=3" target="_parent"> +SourceForge lists page.</a> +</p> + +<p>The mailing lists are managed by SourceForge. If you're having trouble +with the mailing lists please contact the SourceForge administrators for help.</p> + +<p>Archives of the old Mesa mailing list which was hosted by unicamp.br +are available <a href="http://groups.yahoo.com/group/mesa/messages/">here</a>.</p> + +<p> +Here are some other OpenGL-related forums you might find useful: +</p> + +<p> +Usenet newsgroups: +<ul> +<li>comp.graphics.algorithms +<li>comp.graphics.api.opengl +<li>comp.os.linux.x +</ul> +</p> + +<p> +<a href="http://www.opengl.org/">OpenGL discussion forums</A> at www.opengl.org +</p> + +</HTML> +</BODY> diff --git a/docs/mangling.html b/docs/mangling.html new file mode 100644 index 00000000000..5aafcb2a68f --- /dev/null +++ b/docs/mangling.html @@ -0,0 +1,26 @@ +<HTML> + +<TITLE>Function Name Mangling</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Function Name Mangling</H1> + +<p> +If you want to use Mesa and native OpenGL in the same application at +the same time you may find it useful to compile Mesa with +<i>name mangling</i>. +This results in all the Mesa functions being prefixed with +<b>mgl</b> instead of <b>gl</b>. +</p> + +<p> +To do this, recompile Mesa with the compiler flag -DUSE_MGL_NAMESPACE. +Add the flag to the other compiler flags in Make-config (if using the +old-style build system) or in src/Makefile if using GNU autoconf/ +automake to build Mesa. +</p> + + +</BODY> +</HTML> diff --git a/docs/modelers.html b/docs/modelers.html new file mode 100644 index 00000000000..aebd2496580 --- /dev/null +++ b/docs/modelers.html @@ -0,0 +1,70 @@ +<HTML> + +<TITLE>Modelers, Renderers and Viewers</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Modelers, Renderers and Viewers</H1> + +<ul> + <li><a href="http://www.ac3d.org/" target="_parent">AC3D</a> - 3-D modeler + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">ARCAD</a> - CAD program + </li><li><a href="http://www.mediascape.com/" target="_parent">Artstream</a> - provides + functionality like Corel Draw and Illustrator + </li><li><a href="http://www.blender.nl/" target="_parent">Blender</a> - 3-D animation + software + </li><li><a href="http://www.bmrt.org/" target="_parent">BMRT</a> - Blue Moon Rendering + Tools + </li><li><a href="http://www.arq.net/%7Ekasten/demtools/" target="_parent">Demtools</a> + - Map viewer + </li><li><a href="http://www.holometric.de/dimension/" target="_parent">DIMENSION</a> + - freeform surface reconstruction + </li><li><a href="http://www.vectaport.com/vhclmaps/demviewer.html" target="_parent">demviewer</a> + - interactive terrain viewer + </li><li><a href="http://www.crc.ca/FreeWRL" target="_parent">FreeWRL</a> - VRML browser + </li><li><a href="http://www.geomview.org/" target="_parent">Geomview</a> - 3-D geometry + exploration + </li><li><a href="http://innovation3d.sourceforge.net/" target="_parent">Innovation3D</a> + - 3D modeling program + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html" target="_parent">KWRL</a> - VRML browser + </li><li><a href="http://www.vermontel.com/%7Ecmorley/vrml.html" target="_parent">LibVRML97/Lookat</a> + - VRML viewer + </li><li><a href="http://aig.cs.man.ac.uk/systems/Maverik/" target="_parent">Maverik</a> + - VR graphics and interaction system + </li><li><a href="http://www.swissquake.ch/chumb.alum-soft" target="_parent">MD2 Viewer</a> + - View .MD2 files + </li><li><a href="http://www.megacads.dlr.de/" target="_parent">MegaCads</a> + - Multiblock-Elliptic-Grid-Generation-And-CAD-System + </li><li><a href="http://www.swissquake.ch/chumbalum-soft/" target="_parent">MilkShape + 3D</a> - 3D modeler/animator + </li><li><a href="http://mindseye.sourceforge.net/" target="_parent">Mindseye</a> - Rendering/Modeling + Package + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">Moonlight Atelier</a> - modeling and rendering package + </li><li><a href="http://www.bittco.com/" target="_parent">NetReality</a> - Virtual Reality + web organizer + </li><li><a href="http://www.sim.no/reducer.html" target="_parent">Rational Reducer</a> + - polygon reduction tool + </li><li><a href="http://www.cs.kuleuven.ac.be/cwis/research/graphics/RENDERPARK/" target="_parent">RenderPark</a> + - photorealistic rendering + </li><li><a href="http://www.hardgeus.com/revolution" target="_parent">Revolution 3D Engine</a> + - .3ds rendering engine + </li><li><a href="http://www.dgp.toronto.edu/%7Emjmcguff/eversion/" target="_parent">sphereEversion</a> + - inside-out sphere visualization + </li><li><a href="http://www.cs.kuleuven.ac.be/cwis/research/graphics/3DOM/" target="_parent">3Dom</a> + - 3-D modeler + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">3D Studio file viewer</a> - by David Farrell + </li><li><a href="http://www.microform.se/" target="_parent">VARKON</a> - product engineering, + design, modeling + </li><li><a href="http://www.sim.no/vrmlview.html" target="_parent">VRMLview</a> - VRML + model viewer + </li><li><a href="http://www.iicm.edu/vrwave/" target="_parent">VRWave</a> - a VRML 2.0 + browser + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">VRweb</a> - VRML browser + </li><li><a href="http://www.csv.ica.uni-stuttgart.de/vrml/dune/" target="_parent">white_dune</a> + - graphical VRML97 Editor and animation tool + </li><li><a href="http://www.wings3d.org/" target="_parent">Wings 3D</a> - static 3D modeller + with VRML export. Uses SDL library. +</li></ul> + + +</body></html> diff --git a/docs/news.html b/docs/news.html new file mode 100644 index 00000000000..643d7001a42 --- /dev/null +++ b/docs/news.html @@ -0,0 +1,568 @@ +<HTML> + +<TITLE>Mesa News</TITLE> + +<BODY text="#000000" bgcolor="#55bbff"> + +<H1>News</H1> + + +<h2>March 7, 2003</h2> +<p> +Website and documentation overhaul. +</p> +<p> +The website content and Mesa documentation (from the doc/ directory) have +been merged together. +All the documentation files have been entered into the CVS repository. +Many of the old plain-text files have been converted to html and modernized. +</p> + + +<h2>November 13, 2002</h2> +<p>Mesa 5.0 has been released. This is a stable release which +implements the OpenGL 1.4 specification. +</p><pre>New: + - OpenGL 1.4 support (glGetString(GL_VERSION) returns "1.4") + - removed some overlooked debugging code + - glxinfo updated to support GLX_ARB_multisample + - GLUT now support GLX_ARB_multisample + - updated DOS driver (Daniel Borca) +Bug fixes: + - GL_POINT and GL_LINE-mode polygons didn't obey cull state + - fixed potential bug in _mesa_align_malloc/calloc() + - fixed missing triangle bug when running vertex programs + - fixed a few HPUX compilation problems + - FX (Glide) driver didn't compile + - setting GL_TEXTURE_BORDER_COLOR with glTexParameteriv() didn't work + - a few EXT functions, like glGenTexturesEXT, were no-ops + - a few OpenGL 1.4 functions like glFogCoord*, glBlendFuncSeparate, + glMultiDrawArrays and glMultiDrawElements were missing + - glGet*(GL_ACTIVE_STENCIL_FACE_EXT) was broken + - Pentium 4 Mobile was mistakenly identified as having 3DNow! + - fixed one-bit error in point/line fragment Z calculation + - fixed potential segfault in fakeglx code + - fixed color overflow problem in DOT3 texture env mode +</pre> + + +<h2>October 29, 2002</h2> +<p>Mesa 4.1 has been released. This is a new development release. +For a stable release, get 4.0.4. +</p><pre>New: + - GL_NV_vertex_program extension + - GL_NV_vertex_program1_1 extension + - GL_ARB_window_pos extension + - GL_ARB_depth_texture extension + - GL_ARB_shadow extension + - GL_ARB_shadow_ambient extension + - GL_EXT_shadow_funcs extension + - GL_ARB_point_parameters extension + - GL_ARB_texture_env_crossbar + - GL_NV_point_sprite extension + - GL_NV_texture_rectangle extension + - GL_EXT_multi_draw_arrays extension + - GL_EXT_stencil_two_side extension + - GLX_SGIX_fbconfig and GLX_SGIX_pbuffer extensions + - GL_ATI_texture_mirror_once extension (Ian Romanick) + - massive overhaul/simplification of software rasterizer module, + many contributions from Klaus Niederkrueger + - faster software texturing in some cases (i.e. trilinear filtering) + - new OSMesaGetProcAddress() function + - more blend modes implemented with MMX code (Jose Fonseca) + - added glutGetProcAddress() to GLUT + - added GLUT_FPS env var to compute frames/second in glutSwapBuffers() + - pbinfo and pbdemo PBuffer programs + - glxinfo -v prints transprent pixel info (Gerd Sussner) +Bug fixes: + - better mipmap LOD computation (prevents excessive blurriness) + - OSMesaMakeCurrent() didn't recognize buffer size changes + - assorted conformance fixes for 16-bit/channel rendering + - texcombine alpha subtraction mode was broken + - fixed some blend problems when GLchan==GLfloat (Gerk Huisma) + - clamp colors to [0,1] in OSMesa if GLchan==GLfloat (Gerk Huisma) + - fixed divide by zero error in NURBS tessellator (Jon Perry) + - fixed GL_LINEAR fog bug by adding clamping + - fixed FP exceptions found using Alpha CPU + - 3dfx/glide driver render-to-window feature was broken + - added missing GLX_TRANSPARENT_RGB token to glx.h + - fixed error checking related to paletted textures + - fixed reference count error in glDeleteTextures (Randy Fayan) +Changes: + - New spec file and Python code to generate some GL dispatch files + - Glide driver defaults to "no" with autoconf/automake + - floating point color channels now clamped to [0,inf) + - updated demos/stex3d with new options +</pre> + + +<h2>October 4, 2002</h2> +<p> +The <a href="http://mesa3d.sourceforge.net/docs/MesaFAQ.html">Mesa FAQ</a> has been rewritten. +</p> + +<h2>October 3, 2002</h2> +<p>Mesa 4.0.4 has been released. This is a stable bug-fix release. +</p><pre> New: + - GL_NV_texture_rectangle extension + - updated glext.h header (version 17) + - updated DOS driver (Daniel Borca) + - updated BeOS R5 driver (Philippe Houdoin) + - added GL_IBM_texture_mirror_repeat + - glxinfo now takes -l option to print interesting OpenGL limits info + - GL_MESA_ycbcr_texture extension + - GL_APPLE_client_storage extension (for some DRI drivers only) + - GL_MESA_pack_invert extension + Bug fixes: + - fixed GL_LINEAR fog bug by adding clamping + - fixed FP exceptions found using Alpha CPU + - 3dfx MESA_GLX_FX=window (render to window) didn't work + - fixed memory leak in wglCreateContest (Karl Schultz) + - define GLAPIENTRY and GLAPI if undefined in glu.h + - wglGetProcAddress didn't handle all API functions + - when testing for OpenGL 1.2 vs 1.3, check for GL_ARB_texture_cube_map + - removed GL_MAX_CONVOLUTION_WIDTH/HEIGHT from glGetInteger/Float/etc() + - error checking in compressed tex image functions had some glitches + - fixed AIX compile problem in src/config.c + - glGetTexImage was using pixel unpacking instead of packing params + - auto-mipmap generation for cube maps was incorrect + Changes: + - max texture units reduced to six to accomodate texture rectangles + - removed unfinished GL_MESA_sprite_point extension code +</pre> + +<h2>June 25, 2002</h2> +<p>Mesa 4.0.3 has been released. This is a stable bug-fix release. +</p><pre> New: + - updated GL/glext.h file (version 15) + - corrected MMX blend code (Jose Fonseca) + - support for software-based alpha planes in Windows driver + - updated GGI driver (Filip Spacek) + Bug fixes: + - glext.h had wrong values for GL_DOT3_RGB[A]_EXT tokens + - OSMesaMakeCurrent() didn't recognize buffer size changes + - assorted conformance fixes for 16-bit/channel rendering + - texcombine alpha subtraction mode was broken + - fixed lighting bug with non-uniform scaling and display lists + - fixed bug when deleting shared display lists + - disabled SPARC cliptest assembly code (Mesa bug 544665) + - fixed a couple Solaris compilation/link problems + - blending clipped glDrawPixels didn't always work + - glGetTexImage() didn't accept packed pixel types + - glPixelMapu[is]v() could explode given too large of pixelmap + - glGetTexParameter[if]v() didn't accept GL_TEXTURE_MAX_ANISOTROPY_EXT + - glXCopyContext() could lead to segfaults + - glCullFace(GL_FRONT_AND_BACK) didn't work (bug 572665) + Changes: + - lots of C++ (g++) code clean-ups + - lots of T&L updates for the Radeon DRI driver + Known bugs: + - mipmap LOD computation (fixed for Mesa 4.1) +</pre> + +<h2>April 2, 2002</h2> +<p>Mesa 4.0.2 has been released. This is a stable bug-fix release. +</p><pre> New: + - New DOS (DJGPP) driver written by Daniel Borca + - New driver interface functions for TCL drivers (such as Radeon DRI) + - GL_RENDERER string returns "Mesa Offscreen16" or "Mesa Offscreen32" + if using deep color channels + - latest GL/glext.h and GL/glxext.h headers from SGI + Bug fixes: + - GL_BLEND with non-black texture env color wasn't always correct + - GL_REPLACE with GL_RGB texture format wasn't always correct (alpha) + - glTexEnviv( pname != GL_TEXTURE_ENV_COLOR ) was broken + - glReadPixels was sometimes mistakenly clipped by the scissor box + - glDraw/ReadPixels didn't catch all the errors that they should have + - Fixed 24bpp rendering problem in Windows driver (Karl Schultz) + - 16-bit GLchan mode fixes (m_trans_tmp.h, s_triangle.c) + - Fixed 1-bit float->int conversion bug in glDrawPixels(GL_DEPTH_COMP) + - glColorMask as sometimes effecting glXSwapBuffers() + - fixed a potential bug in XMesaGarbageCollect() + - N threads rendering into one window didn't work reliably + - glCopyPixels didn't work for deep color channels + - improved 8 -> 16bit/channel texture image conversion (Gerk Huisma) + - glPopAttrib() didn't correctly restore user clip planes + - user clip planes failed for some perspective projections (Chromium) +</pre> + +<h2>December 17, 2001</h2> +<p>Mesa 4.0.1 has been released. This is a stable bug-fix release. +</p><pre> New: + - better sub-pixel sample positions for AA triangles (Ray Tice) + - slightly faster blending for (GL_ZERO, GL_ONE) and (GL_ONE, GL_ZERO) + Bug fixes: + - added missing break statements in glGet*() for multisample cases + - fixed uninitialized hash table mutex bug (display lists / texobjs) + - fixed bad teximage error check conditional (bug 476846) + - fixed demos readtex.c compilation problem on Windows (Karl Schultz) + - added missing glGet() query for GL_MAX_TEXTURE_LOD_BIAS_EXT + - silence some compiler warnings (gcc 2.96) + - enable the #define GL_VERSION_1_3 in GL/gl.h + - added GL 1.3 and GLX 1.4 entries to gl_mangle.h and glx_mangle.h + - fixed glu.h typedef problem found with MSDev 6.0 + - build libGL.so with -Bsymbolic (fixes bug found with Chromium) + - added missing 'const' to glXGetContextIDEXT() in glxext.h + - fixed a few glXGetProcAddress() errors (texture compression, etc) + - fixed start index bug in compiled vertex arrays (Keith) + - fixed compilation problems in src/SPARC/glapi_sparc.S + - fixed triangle strip "parity" bug found in VTK medical1 demo (Keith) + - use glXGetProcAddressARB in GLUT to avoid extension linking problems + - provoking vertex of flat-shaded, color-index triangles was wrong + - fixed a few display list bugs (GLUT walker, molecule, etc) (Keith) + - glTexParameter didn't flush the vertex buffer (Ray Tice) + - feedback attributes for glDraw/CopyPixels and glBitmap were wrong + - fixed bug in normal length caching (ParaView lighting bug) +</pre> + +<h2>October 22, 2001</h2> +<p>Mesa 4.0 has been released. This is a stable release. +</p><pre> New: + - Mesa 4.0 implements the OpenGL 1.3 specification + - GL_IBM_rasterpos_clip extension + - GL_EXT_texture_edge_clamp extension (aka GL_SGIS_texture_edge_clamp) + - GL_ARB_texture_mirrored_repeat extension + - WindML UGL driver (Stephane Raimbault) + - added OSMESA_MAX_WIDTH/HEIGHT queries + - attempted compiliation fixes for Solaris 5, 7 and 8 + - updated glext.h and glxext.h files + - updated Windows driver (Karl Schultz) + Bug fixes: + - added some missing GLX 1.3 tokens to include/GL/glx.h + - GL_COLOR_MATRIX changes weren't recognized by teximage functions + - glCopyPixels with scale and bias was broken + - glRasterPos with lighting could segfault + - glDeleteTextures could leave a dangling pointer + - Proxy textures for cube maps didn't work + - fixed a number of 16-bit color channel bugs + - fixed a few minor memory leaks + - GLX context sharing was broken in 3.5 + - fixed state-update bugs in glPopClientAttrib() + - fixed glDrawRangeElements() bug + - fixed a glPush/PopAttrib() bug related to texture binding + - flat-shaded, textured lines were broken + - fixed a dangling pointer problem in the XMesa code (Chris Burghart) + - lighting didn't always produce the correct alpha value + - fixed 3DNow! code to not read past end of arrays (Andrew Lewycky) +</pre> + + +<h2>June 21, 2001</h2> +<p>Mesa 3.5 has been released. This is a new development release. +</p><pre> New: + - internals of Mesa divided into modular pieces (Keith Whitwell) + - 100% OpenGL 1.2 conformance (passes all conformance tests) + - new AA line algorithm + - GL_EXT_convolution extension + - GL_ARB_imaging subset + - OSMesaCreateContextExt() function + - GL_ARB_texture_env_add extension (same as GL_EXT_texture_env_add) + - GL_MAX_TEXTURE_UNITS_ARB now defaults to eight + - GL_EXT_fog_coord extension (Keith Whitwell) + - GL_EXT_secondary_color extension (Keith Whitwell) + - GL_ARB_texture_env_add extension (same as GL_EXT_texture_env_add) + - GL_SGIX_depth_texture extension + - GL_SGIX_shadow and GL_SGIX_shadow_ambient extensions + - demos/shadowtex.c demo of GL_SGIX_depth_texture and GL_SGIX_shadow + - GL_ARB_texture_env_combine extension + - GL_ARB_texture_env_dot3 extension + - GL_ARB_texture_border_clamp (aka GL_SGIS_texture_border_clamp) + - OSMesaCreateContextExt() function + - libOSMesa.so library, contains the OSMesa driver interface + - GL/glxext.h header file for GLX extensions + - somewhat faster software texturing, fogging, depth testing + - all color-index conformance tests now pass (only 8bpp tested) + - SPARC assembly language TCL optimizations (David Miller) + - GL_SGIS_generate_mipmap extension + Bug Fixes: + - fbiRev and tmuRev were unitialized when using Glide3 + - fixed a few color index mode conformance failures; all pass now + - now appling antialiasing coverage to alpha after texturing + - colors weren't getting clamped to [0,1] before color table lookup + - fixed RISC alignment errors caused by COPY_4UBV macro + - drawing wide, flat-shaded lines could cause a segfault + - vertices now snapped to 1/16 pixel to fix rendering of tiny triangles + Changes: + - SGI's Sample Implementation (SI) 1.3 GLU library replaces Mesa GLU + - new libOSMesa.so library, contains the OSMesa driver interface +</pre> + + +<h2>May 17, 2001</h2> +<p>Mesa 3.4.2 has been released. This is basically just a bug-fix release. +Here's what's new:</p> +<pre> Bug fixes: + - deleting the currently bound texture could cause bad problems + - using fog could result in random vertex alpha values + - AA triangle rendering could touch pixels outside right window bound + - fixed byteswapping problem in clear_32bit_ximage() function + - fixed bugs in wglUseFontBitmapsA(), by Frank Warmerdam + - fixed memory leak in glXUseXFont() + - fragment sampling in AA triangle function was off by 1/2 pixel + - Windows: reading pixels from framebuffer didn't always work + - glConvolutionFilter2D could segfault or cause FP exception + - fixed segfaults in FX and X drivers when using tex unit 1 but not 0 + - GL_NAND logicop didn't work right in RGBA mode + - fixed a memory corruption bug in vertex buffer reset code + - clearing the softwara alpha buffer with scissoring was broken + - fixed a few color index mode fog bugs + - fixed some bad assertions in color index mode + - fixed FX line 'stipple' bug #420091 + Changes: + - optimized writing mono-colored pixel spans to X pixmaps + - increased max viewport size to 2048 x 2048 +</pre> + + +<h2>April 29, 2001</h2> +<p>New Mesa website</p> +<p>Mark Manning ([email protected]) produced the new website.<br> +Thanks, Mark!</p> + + +<h2>February 14, 2001</h2> +<p>Mesa 3.4.1 has been released. Here's what's new:</p> +<pre> New: + - fixed some Linux build problems + - fixed some Windows build problems + - GL_EXT_texture_env_dot3 extension (Gareth Hughes) + Bug fixes: + - added RENDER_START/RENDER_FINISH macros for glCopyTexImage in DRI + - various state-update code changes needed for DRI bugs + - disabled pixel transfer ops in glColorTable commands, not needed + - fixed bugs in glCopyConvolutionFilter1D/2D, glGetConvolutionFilter + - updated sources and fixed compile problems in widgets-mesa/ + - GLX_PBUFFER enum value was wrong in glx.h + - fixed a glColorMaterial lighting bug + - fixed bad args to Read/WriteStencilSpan in h/w stencil clear function + - glXCopySubBufferMESA() Y position was off by one + - Error checking of glTexSubImage3D() was broken (bug 128775) + - glPopAttrib() didn't restore all derived Mesa state correctly + - Better glReadPixels accuracy for 16bpp color - fixes lots of OpenGL + conformance problems at 16bpp. + - clearing depth buffer with scissoring was broken, would segfault + - OSMesaGetDepthBuffer() returned bad bytesPerValue value + - fixed a line clipping bug (reported by Craig McDaniel) + - fixed RGB color over/underflow bug for very tiny triangles + Known problems: + - NURBS or evaluator surfaces inside display lists don't always work +</pre> +<p> +</p><h2>November 3, 2000</h2> +<p>Mesa 3.4 has been released. Here's what's new since the 3.3 release:</p> +<pre> New: + - optimized glDrawPixels for glPixelZoom(1,-1) + Bug Fixes: + - widgets-mesa/src/*.c files were missing from 3.3 distro + - include/GL/mesa_wgl.h file was missing from 3.3 distro + - fixed some Win32 compile problems + - texture object priorities weren't getting initialized to 1.0 + - glAreTexturesResident return value was wrong when using hardware + - glXUseXFont segfaulted when using 3dfx driver (via MESA_GLX_FX) + - glReadPixels with GLushort packed types was broken + - fixed a few bugs in the GL_EXT_texture_env_combine texture code + - glPush/PopAttrib(GL_ENABLE_BIT) mishandled multi-texture enables + - fixed some typos/bugs in the VB code + - glDrawPixels(GL_COLOR_INDEX) to RGB window didn't work + - optimized glDrawPixels paths weren't being used + - per-fragment fog calculation didn't work without a Z buffer + - improved blending accuracy, fixes Glean blendFunc test failures + - glPixelStore(GL_PACK/UNPACK_SKIP_IMAGES) wasn't handled correctly + - glXGetProcAddressARB() didn't always return the right address + - gluBuild[12]DMipmaps() didn't grok the GL_BGR pixel format + - texture matrix changes weren't always detected (GLUT projtex demo) + - fixed random color problem in vertex fog code + - fixed Glide-related bug that let Quake get a 24-bit Z buffer + Changes: + - finished internal support for compressed textures for DRI +</pre> +<p> +</p><h2>April 24, 2000</h2> +<p>Mesa 3.2 has been released. Here's what's new since the beta release:</p> +<pre> Bug fixes: + - fixed memcpy bugs in span.c + - fixed missing glEnd problem in demos/tessdemo.c + - fixed bug when clearing 24bpp Ximages + - fixed clipping problem found in Unreal Tournament + - fixed Loki's "ice bug" and "crazy triangles" seen in Heretic2 + - fixed Loki's 3dfx RGB vs BGR bug + - fixed Loki's 3dfx smooth/flat shading bug in SoF + Changes: + - updated docs/README file + - use bcopy() optimizations on FreeBSD + - re-enabled the optimized persp_textured_triangle() function +</pre> +<p> +</p><h2>March 23, 2000</h2> +<p>I've just upload the Mesa 3.2 beta 1 files to SourceForge at <a href="http://sourceforge.net/project/filelist.php?group_id=3" target="_parent">http://sourceforge.net/project/filelist.php?group_id=3</a><a href="http://sourceforge.net/project/filelist.php?group_id=3"></a></p> +<p>3.2 (note even number) is a stabilization release of Mesa 3.1 meaning it's mainly +just bug fixes.</p> +<p>Here's what's changed: + +</p><ul> + Bug fixes: + <ul> + - mixed drawing of lines and bitmaps sometimes had wrong colors<br> + - added missing glHintPGI() function<br> + - fixed a polygon culling bug<br> + - fixed bugs in gluPartialDisk()<br> + - Z values in selection mode were wrong<br> + - added missing tokens: + <ul> + GL_SMOOTH_POINT_SIZE_RANGE<br> + GL_SMOOTH_POINT_SIZE_GRANULARITY<br> + GL_SMOOTH_LINE_WIDTH_RANGE<br> + GL_SMOOTH_LINE_WIDTH_GRANULARITY<br> + GL_ALIASED_POINT_SIZE_RANGE<br> + GL_ALIASED_LINE_WIDTH_RANGE + </ul> + - fixed glCopyPixels when copying from back to front buffer<br> + - GL_EXT_compiled_vertex_array tokens had _SGI suffix instead of _EXT<br> + - glDrawRangeElements(GL_LINES, 0, 1, 2, type, indices) was broken<br> + - glDeleteTextures() didn't decrement reference count correctly<br> + - GL_SRCA_ALPHA_SATURATE blend mode didn't work correctly<br> + - Actual depth of transformation matrix stacks was off by one<br> + - 24bpp visuals didn't address pixels correctly<br> + - mipmap level of detail (lambda) calculation simplified, more accurate<br> + - 101691 - Polygon clipping and GL_LINE<br> + - 101928 - Polygon clipping and GL_LINE (same fix as above)<br> + - 101808 - Non-glVertexArrays tristrip bug<br> + - 101971 - find_last_3f on Dec OSF (worked around)<br> + - 102369 - segv on dec osf (possibly a duplicate of the above)<br> + - 102893 - orientations of modelview cause segfault + </ul> + New: + <ul> + - updated SVGA Linux driver<br> + - added the MESA_FX_NO_SIGNALS env var, see docs/README.3DFX<br> + - build libGLw.a (Xt/OpenGL drawing area widget) library by default<br> + - changed -O2 to -O3 for a number of gcc configs + </ul> + Changes: + <ul> + - glXCopyContext's mask parameter is now unsigned long, per GLX spec + </ul> +</ul> + +<p>Please report any problems with this release ASAP. Bugs should be filed on the +Mesa3D website at sourceforge.<br> +After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.</p> +<p>-- Brian</p> +<p> +</p><h2>December 17, 1999</h2> +<p>A Slashdot interview with Brian about Mesa (questions submitted by Slashdot readers) +can be found at <a href="http://slashdot.org/interviews/99/12/17/0927212.shtml" target="_parent">http://slashdot.org/interviews/99/12/17/0927212.shtml</a>.</p> +<p> +</p><h2>December 14, 1999</h2> +<p>Mesa 3.1 is released!</p> +<p> +</p><h2>September 21, 1999</h2> +<p>There appear to be two new files on the ftp site, <a href="ftp://ftp.mesa3d.org/mesa/beta/MesaLib-3.1beta3.tar.gz">MesaLib-3.1beta3.tar.gz</a> +and <a href="ftp://ftp.mesa3d.org/mesa/beta/MesaDemos-3.1beta3.tar.gz">MesaDemos-3.1beta3.tar.gz</a>, +that seem to be... yes, I've just received confirmation from the beta center, they +are indeed the <b>THIRD</b> beta release of Mesa 3.1! Happy Days. Happy Days. Thanks +Keith Whitwell for preparing these for us during Brian's absence.</p> +<p> +</p><h2>September 17, 1999</h2> +<p>Re: Brian's email address: Do not send mail to me @ avid.com since I no longer +I won't be regularly reading email until October 11.</p> +<p> +</p><h2>August 30, 1999</h2> +<p>I'm pleased to announce that I've accepted a position with Precision Insight, +Inc. effective October, 1999. I'll be leaving Avid Technology in September.</p> +<p>I've been working on Mesa in my spare time for over five years. With Precision +Insight I now have the opportunity to devote my full attention to advancing Mesa +and OpenGL on Linux.</p> +<p>While I'll be focused on Linux, the X Window System, and hardware acceleration, +my work will continue to be open sourced and available to any other programmers who +may want to contribute to it, or use it for other projects or platforms</p> +<p>PS: I'm going to be traveling until Sep 6 and won't be reading email until then.</p> +<p> +</p><h2>August 23, 1999</h2> +<p>Anonymous CVS access is back online so suck up all the bandwidth you can afford. +Note that this is a new archive, so you will need to re-checkout the archive. That +means don't <i>cvs update</i> from a previous download.</p> +<p> +</p><h2>August 17, 1999</h2> +<p>A <a href="http://mesa3d.sourceforge.net/news/misc/SIGGRAPH99BOF.html">report</a> from the SIGGRAPH '99 Linux/OpenGL +BOF meeting is now available.</p> +<p>-Brian</p> +<p> +</p><h2>August 14, 1999</h2> +<p>www.mesa3d.org is having technical problems due to hardware failures at VA Linux +systems. The Mac pages, ftp, and CVS services aren't fully restored yet. Please be +patient.</p> +<p>-Brian</p> +<p> +</p><h2>June 7, 1999</h2> +<p>RPMS of the nVidia RIVA server can be found at <a href="ftp://ftp.mesa3d.org/mesa/misc/nVidia/">ftp://ftp.mesa3d.org/mesa/misc/nVidia/</a>.</p> +<p> +</p><h2>June 2, 1999</h2> +<p><a href="http://www.nvidia.com/">nVidia</a> has released some Linux binaries for +xfree86 3.3.3.1, along with the <b>full source</b>, which includes GLX acceleration +based on Mesa 3.0. They can be downloaded from <a href="http://www.nvidia.com/Products.nsf/htmlmedia/software_drivers.html">http://www.nvidia.com/Products.nsf/htmlmedia/software_drivers.html</a>.</p> +<p> +</p><h2>May 24, 1999</h2> +<p>Beta 2 of Mesa 3.1 has been make available at <a href="ftp://ftp.mesa3d.org/mesa/beta/">ftp://ftp.mesa3d.org/mesa/beta/</a>. +If you are into the quake scene, you may want to try this out, as it contains some +optimizations specifically in the Q3A rendering path. Remember to report any bugs +submitted bugs are at <a href="http://www.mail-archive.com/[email protected]/">http://www.mail-archive.com/[email protected]/</a>.</p> +<p> +</p><h2>May 13, 1999</h2> +<p>For those interested in the integration of Mesa into XFree86 4.0, Precision Insight +has posted their lowlevel design documents at <a href="http://www.precisioninsight.com/piinsights.html">http://www.precisioninsight.com/piinsights.html</a>.</p> +<p> +</p><h2>May 13, 1999</h2> +<pre>May 1999 - John Carmack of id Software, Inc. has made a donation of +US$10,000 to the Mesa project to support its continuing development. +Mesa is a free implementation of the OpenGL 3D graphics library and id's +newest game, Quake 3 Arena, will use Mesa as the 3D renderer on Linux. + +The donation will go to Keith Whitwell, who has been optimizing Mesa to +improve performance on 3d hardware. Thanks to Keith's work, many +applications using Mesa 3.1 will see a dramatic performance increase +over Mesa 3.0. The donation will allow Keith to continue working on +Mesa full time for some time to come. + +For more information about Mesa see www.mesa3d.org. For more +information about id Software, Inc. see www.idsoftware.com. + +-------------------------------- + +This donation from John/id is very generous. Keith and I are very +grateful. + +</pre> +<p> +</p><h2>May 1, 1999</h2> +<p>John Carmack made an interesting .plan update yesterday: + +</p><ul> + <i>"I put together a document on optimizing OpenGL drivers for Q3 that should + be helpful to the various Linux 3D teams. <br> + </i><a href="http://www.quake3arena.com/news/glopt.html"><i>http://www.quake3arena.com/news/glopt.html</i></a><i>"</i> +</ul> + +<p> +</p><h2>April 7, 1999</h2> +<p>Updated the Mesa contributors section and added links to RPM Mesa packages.</p> +<p> +</p><h2>March 18, 1999</h2> +<p>The new webpages are now online. Enjoy, and let me know if you find any errors. +For an eye-candy free version you can use <a href="http://www.mesa3d.org/txt/">http://www.mesa3d.org/txt/</a>.</p> +<p> +</p><h2>February 16, 1999</h2> +<p><a href="http://www.sgi.com/">SGI</a> releases its <a href="http://www.sgi.com/software/opensource/glx/">GLX +source code</a>.</p> +<p> +</p><h2>January 22, 1999</h2> +<p>www.mesa3d.org established</p> + + +</p> + + +<hr> +$Id: news.html,v 3.1 2003/03/08 17:38:57 brianp Exp $ +</body> +</html>
\ No newline at end of file diff --git a/docs/osmesa.html b/docs/osmesa.html new file mode 100644 index 00000000000..ace42001131 --- /dev/null +++ b/docs/osmesa.html @@ -0,0 +1,74 @@ +<HTML> + +<TITLE>Off-screen Rendering</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Off-screen Rendering</H1> + + +<p> +Mesa 1.2.4 introduced off-screen rendering, a facility for generating +3-D imagery without having to open a window on your display. Mesa's +simple off-screen rendering interface is completely operating system +and window system independent so programs which use off-screen +rendering should be very portable. This feature effectively +enables you to use Mesa as an off-line, batch-oriented renderer. +</p> +<p> +The "OSMesa" API provides 3 functions for making off-screen +renderings: OSMesaCreateContext(), OSMesaMakeCurrent(), and +OSMesaDestroyContext(). See the Mesa/include/GL/osmesa.h header for +more information. See the demos/osdemo.c file for an example program. +There is no facility for writing images to files. That's up to you. +</p> +<p> +If you want to generate large images (larger than 1280x1024) you'll +have to edit the src/config.h file to change MAX_WIDTH and MAX_HEIGHT +then recompile Mesa. Image size should only be limited by available +memory. +</p> + + +<H2>Deep color channels</H2> + +<p> + For some applications 8-bit color channels don't have sufficient + accuracy (film and IBR, for example). If you're in this situation + you'll be happy to know that Mesa supports 16-bit and 32-bit color + channels through the OSMesa interface. When using 16-bit channels, + channels are GLushorts and pixels occupy 8 bytes. When using 32-bit + channels, channels are GLfloats and pixels occupy 16 bytes. +</p> +<p> + To build Mesa/OSMesa with 16-bit color channels: +<pre> + cd Mesa-4.x/src + make -f Makefile.X11 clean + make -f Makefile.OSMesa16 linux-osmesa16 +</pre> + + For 32-bit channels: +<pre> + cd Mesa-4.x/src + make -f Makefile.X11 clean + make -f Makefile.OSMesa16 linux-osmesa32 +</pre> + +<p> +If you're not using Linux, you can easily edit Make-config and add +an appropriate configuration. +</p> +<p> +The Mesa/tests/osdemo16.c file (available via CVS) demonstrates how +to use this feature. +</p> +<p> +BE WARNED: 16 and 32-bit channel support has not been exhaustively +tested and there may be some bugs. However, a number of people have +been using this feature successfully so it can't be too broken. +</p> + + +</BODY> +</HTML> diff --git a/docs/perf.html b/docs/perf.html new file mode 100644 index 00000000000..89f6eae75c9 --- /dev/null +++ b/docs/perf.html @@ -0,0 +1,66 @@ +<HTML> + +<TITLE>Performance Tips</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Performance Tips</H1> + +<p> +Performance tips for software rendering: +</P> +<ol> + +<li> Turn off smooth shading when you don't need it (glShadeModel) +<li> Turn off depth buffering when you don't need it. +<li> Turn off dithering when not needed. +<li> Use double buffering as it's often faster than single buffering +<li> Compile in the X Shared Memory extension option if it's supported + on your system by adding -DSHM to CFLAGS and -lXext to XLIBS for + your system in the Make-config file. +<li> Recompile Mesa with more optimization if possible. +<li> Try to maximize the amount of drawing done between glBegin/glEnd pairs. +<li> Use the MESA_BACK_BUFFER variable to find best performance in double + buffered mode. (X users only) +<li> Optimized polygon rasterizers are employed when: + rendering into back buffer which is an XImage + RGB mode, not grayscale, not monochrome + depth buffering is GL_LESS, or disabled + flat or smooth shading + dithered or non-dithered + no other rasterization operations enabled (blending, stencil, etc) +<li> Optimized line drawing is employed when: + rendering into back buffer which is an XImage + RGB mode, not grayscale, not monochrome + depth buffering is GL_LESS or disabled + flat shading + dithered or non-dithered + no other rasterization operations enabled (blending, stencil, etc) +<li> Textured polygons are fastest when: + using a 3-component (RGB), 2-D texture + minification and magnification filters are GL_NEAREST + texture coordinate wrap modes for S and T are GL_REPEAT + GL_DECAL environment mode + glHint( GL_PERSPECTIVE_CORRECTION_HINT, GL_FASTEST ) + depth buffering is GL_LESS or disabled +<li> Lighting is fastest when: + Two-sided lighting is disabled + GL_LIGHT_MODEL_LOCAL_VIEWER is false + GL_COLOR_MATERIAL is disabled + No spot lights are used (all GL_SPOT_CUTOFFs are 180.0) + No local lights are used (all position W's are 0.0) + All material and light coefficients are >= zero +<li> XFree86 users: if you want to use 24-bit color try starting your + X server in 32-bit per pixel mode for better performance. That is, + start your X server with + startx -- -bpp 32 + instead of + startx -- -bpp 24 +<li> Try disabling dithering with the MESA_NO_DITHER environment variable. + If this env var is defined Mesa will disable dithering and the + command glEnable(GL_DITHER) will be ignored. +</ol> + + +</BODY> +</HTML> diff --git a/docs/relnotes.html b/docs/relnotes.html new file mode 100644 index 00000000000..1ac28614f25 --- /dev/null +++ b/docs/relnotes.html @@ -0,0 +1,33 @@ +<HTML> + +<TITLE>Mesa Release Notes</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Release Notes</H1> + +<p> +The release notes summarize what's new or changed in each Mesa release. +</p> + +<UL> +<LI><A HREF="RELNOTES-5.1">RELNOTES-5.1</A> +<LI><A HREF="RELNOTES-5.0">RELNOTES-5.0</A> +<LI><A HREF="RELNOTES-4.1">RELNOTES-4.1</A> +<LI><A HREF="RELNOTES-4.0.3">RELNOTES-4.0.3</A> +<LI><A HREF="RELNOTES-4.0.2">RELNOTES-4.0.2</A> +<LI><A HREF="RELNOTES-4.0.1">RELNOTES-4.0.1</A> +<LI><A HREF="RELNOTES-4.0">RELNOTES-4.0</A> +<LI><A HREF="RELNOTES-3.5">RELNOTES-3.5</A> +<LI><A HREF="RELNOTES-3.4.2">RELNOTES-3.4.2</A> +<LI><A HREF="RELNOTES-3.4.1">RELNOTES-3.4.1</A> +<LI><A HREF="RELNOTES-3.4">RELNOTES-3.4</A> +<LI><A HREF="RELNOTES-3.3">RELNOTES-3.3</A> +<LI><A HREF="RELNOTES-3.2.1">RELNOTES-3.2.1</A> +<LI><A HREF="RELNOTES-3.2">RELNOTES-3.2</A> +<LI><A HREF="RELNOTES-3.1">RELNOTES-3.1</A> +</UL> + + +</BODY> +</HTML> diff --git a/docs/science.html b/docs/science.html new file mode 100644 index 00000000000..d5686e0dd50 --- /dev/null +++ b/docs/science.html @@ -0,0 +1,64 @@ +<HTML> + +<TITLE>Science and Technical</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Science and Technical</H1> + +<ul> + <li><a href="http://www.softintegration.com/products/toolkit/opengl/" target="_parent">Ch</a> - OpenGL bindings for the Ch C/C++ interpreter + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">CLEO3D</a> - event displayer for the CLEOIII detector + </li><li><a href="http://www.bioz.unibas.ch/%7Exray/dino/" target="_parent">DINO</a> - Visualizing + Structural Biology + </li><li><a href="http://www-xdiv.lanl.gov/XCM/gmv/GMVHome.html" target="_parent">General + Mesh Viewer (GMV)</a> - scientific vis. + </li><li><a href="http://gid.cimne.upc.es/" target="_parent">GiD</a> - finite element + analysis + </li><li><a href="http://sig.co.za/download.htm" target="_parent">glpoisson</a> - A finite + element analysis program that simulates wave in an arbitrary region. + </li><li><a href="http://glwaves.sourceforge.net/" target="_parent">GLWaves</a> - + Electromagnetic wave visualization + </li><li><a href="http://www.geuz.org/gmsh/" target="_parent">Gmsh</a> - + finite element mesh generator / viewer + </li><li><a href="http://laaksonen.csc.fi/gopenmol/gopenmol.htmls" target="_parent">gOpenMol</a> + - computational chemistry + </li><li><a href="http://www.mgix.com/gps3d/" target="_parent">GPS 3D</a> - GPS-based map visualization + </li><li><a href="http://hirame.hiram.edu/%7Eworleyam/" target="_parent">Hitchhiker</a> + - virtual solar system + </li><li><a href="http://www-xdiv.lanl.gov/XCM/Hydra/" target="_parent">Hydra</a> - physics + and engineering pkg + </li><li><a href="http://fox.mit.edu/skunk/soft/lightspeed/" target="_parent">Light Speed</a> + - a real-time, interactive relativistic simulator + </li><li><a href="http://linkwinds.jpl.nasa.gov/" target="_parent">LinkWinds</a> - scientific + vis + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html" target="_parent">MathGL3d</a> - Mathematica viewer + </li><li><a href="http://www.mathworks.com/products/matlab" target="_parent">Mathworks</a> + - mathematics and visualization + </li><li><a href="http://www-rocq.inria.fr/gamma/medit/medit.html" target="_parent">Medit</a> - 3D surface mesh viewer + </li><li><a href="http://www.mol.biol.ethz.ch/wuthrich/software/molmol/" target="_parent">MOLMOL</a> + - molecular modeling and analysis + </li><li><a href="http://www.avatar.se/molscript/" target="_parent">Molscript</a> - molecular + modeling + </li><li><a href="http://www.opendx.org/" target="_parent">OpenDX</a> - Data visualization + system + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">PHLEX</a> - Finite element vis + </li><li><a href="http://root.cern.ch/" target="_parent">ROOT</a> - Object Oriented Data + Analysis Framework + </li><li><a href="http://www.slffea.com/" target="_parent">SLFFEA</a> - GNU finite element + package + </li><li><a href="http://quorum.tamu.edu/jon/spock" target="_parent">Spock</a> - molecular + modeling + </li><li><a href="http://www1.las.es/%7Eamil/ssystem" target="_parent">Ssystem</a> - solar + system simulation + </li><li><a href="http://mesa3d.sourceforge.net/notfound.html">SPARROW</a> - robot simulation + </li><li><a href="http://www.ssec.wisc.edu/%7Ebillh/vis5d.html" target="_parent">Vis5D</a> + - atmospheric visualization + </li><li><a href="http://www.ks.uiuc.edu/Research/vmd/" target="_parent">VMD</a> - molecular + modeling + </li><li><a href="http://www.cyberbotics.com/" target="_parent">Webots</a> - 3-D mobile + robot simulator +</li></ul> + + +</body></html>
\ No newline at end of file diff --git a/docs/sourcedocs.html b/docs/sourcedocs.html new file mode 100644 index 00000000000..21032fe7ba5 --- /dev/null +++ b/docs/sourcedocs.html @@ -0,0 +1,24 @@ +<HTML> + +<TITLE>Source Code Documentation</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Source Code Documentation</H1> + +<p> +<A HREF="http://www.doxygen.org" target="_parent">Doxygen</A> +is used to automatically +produce cross-referenced documentation from the Mesa sources. +This is not included in the normal Mesa distribution. +Download Mesa from CVS if interested. +</P> + +<P> +If you're reading this page from your local copy of Mesa, and have +run the doxygen scripts, you can read the documentation +<A HREF="../doxy/core/index.html">here</A> +</P> + +</BODY> +</HTML> diff --git a/docs/subset.html b/docs/subset.html new file mode 100644 index 00000000000..b1fed668b71 --- /dev/null +++ b/docs/subset.html @@ -0,0 +1,26 @@ +<HTML> + +<TITLE>Mesa Subset</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Mesa Subset</H1> + +<p> +In 2002/2003 Tungsten Graphics was contracted to develop a subset Mesa/Radeon +driver for an embedded environment. The result is a reduced-size DRI driver +for the ATI R200 chip, for use with Linux fbdev rather than XFree86. +</p> + +<p> +The specification for this subset can be found +<a href="subset-A.html">here</a>. +</p> + +<p> +More info to come... +</p> + + +</BODY> +</HTML> diff --git a/docs/systems.html b/docs/systems.html new file mode 100644 index 00000000000..46661d6042f --- /dev/null +++ b/docs/systems.html @@ -0,0 +1,109 @@ +<HTML> + +<TITLE>Supported Systems and Drivers</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Supported Systems and Drivers</H1> + +<p> +Mesa was originally designed for Unix/X11 systems and is still best +supported on those systems. All you need is an ANSI C compiler and the +X development environment to use Mesa. +</p> + +<p>Others have contributed drivers +for the Amiga, Apple Macintosh, BeOS, NeXT, OS/2, MS-DOS, VMS, Windows +9x/NT, and Direct3D. +</p> + +<p> +The following files describe the details for various platforms. +Be warned, some of these files (and drivers) may be very out of date. +</p> + +<UL> +<LI><A HREF="README.X11">README.X11</A> - X Window System / Unix / Linux +<LI><A HREF="README.WIN32">README.WIN32</A> - Microsoft Windows +<LI><A HREF="README.VMS">README.VMS</A> - DEC VMS +<LI><A HREF="README.GGI">README.GGI</A> - GGI +<LI><A HREF="README.3DFX">README.3DFX</A> - 3Dfx/Glide driver +<LI><A HREF="README.AMIWIN">README.AMIWIN</A> - Amiga Amiwin +<LI><A HREF="README.BEOS">README.BEOS</A> - BeOS +<LI><A HREF="README.D3D">README.D3D</A> - Direct3D driver +<LI><A HREF="README.DJ">README.DJ</A> - DJGPP +<LI><A HREF="README.LYNXOS">README.LYNXOS</A> - LynxOS +<LI><A HREF="README.MINGW32">README.MINGW32</A> - Mingw32 +<LI><A HREF="README.NeXT">README.NeXT</A> - NeXT +<LI><A HREF="README.OpenStep">README.OpenStep</A> - OpenStep +<LI><A HREF="README.OS2">README.OS2</A> - OS/2 +<LI><A HREF="README.WINDML">README.WINDML</A> - WindML +</UL> + + +<p> +The standard Mesa distribution only supports software-based rendering, with +the exception of the 3Dfx Glide driver. +Information about other hardware support follows. +</p> + +<ul> +<li>DRI-based hardware support for 3dfx, Intel, Matrox, ATI with XFree86 +<blockquote> + <p>The <a href="http://dri.sourceforge.net/" target="_parent">DRI architecture</a>, + originally developed by Precision Insight, Inc. uses Mesa and + provides hardware acceleration for a number of popular chipsets.<br> + <br> + The DRI is part of XFree86 4.0 and later. + <br><br> + If you download and install XFree86 4.x you do not need to + install Mesa separately. All the important parts of Mesa + will be installed with the rest of XFree86. +</blockquote> + + +<li>3dfx Voodoo1, Voodoo2, Voodoo Rush, Voodoo Banshee, Voodoo3 +<blockquote> +<p>All cards based on these chipsets should work with Linux and +Windows 95 via 3dfx's Glide library. +The Mesa/Glide driver is included with the Mesa distribution. +You'll need to install the Glide header files and runtime library. +</p> +<p> +David Bucciarelli wrote the original 3dfx driver for Mesa.<br> +Daryll Strauss ported Glide to Linux. +</p> +</blockquote> + + +<li>Matrox G200/G400, nVidia RIVA, ATI Rage Pro, Intel i810 on Linux +<blockquote> +<p>The <a href="http://utah-glx.sourceforge.net/" target="_parent"> +Utah GLX project</a> +(no longer active) developed drivers for these chipsets and others. +</blockquote> + +<li>Amiga Warp3D +<blockquote> +<p>Amiga systems can support 3D hardware with the Warp3D API. +See <a href="http://www.haage-partner.com/3dworld" target="_parent">here</a>. +</blockquote> + +<li>Also see +<blockquote> +<p><a href="http://www.linux3d.org/" target="_parent">www.linux3d.org</a> for +other 3D hardware info for Linux. +</blockquote> + +</ul> + +<p> +<b><em>Note:</em></b> +If you have NVIDIA hardware in your computer, +you should download and install NVIDIA's OpenGL library. You may +however, want to download Mesa in order to use its GLU and GLUT +libraries, or assorted demo programs.</p> + + +</body> +</html>
\ No newline at end of file diff --git a/docs/thanks.html b/docs/thanks.html new file mode 100644 index 00000000000..d5bb8fa1413 --- /dev/null +++ b/docs/thanks.html @@ -0,0 +1,139 @@ +<HTML> + +<HEAD> +<TITLE>Acknowledgements</TITLE> +</HEAD> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Acknowledgments</H1> + + +The following individuals and groups are to be acknowledged for their +contributions to Mesa over the years. + + +<ul> +<li>Early Mesa development was done while Brian was part of the +<A HREF="http://www.ssec.wisc.edu/~billh/vis.html" +target="_parent">SSEC Visualization Project</A> at the University of +Wisconsin. He'd like to thank Bill Hibbard for letting him work on +Mesa as part of that project. +<br> +<br> +<li>John Carmack of id Software, Inc. funded Keith Whitwell in 1999 in +order to optimize Mesa's vertex transformation module. This is a very +substantial piece of work. +<br> +<br> +<li>Precision Insight, Inc., VA Linux Systems, Inc., and most recently, +Tungsten Graphics, Inc. have supported the ongoing development of Mesa. +<br> +<br> +<li>The <A HREF="http://sourceforge.net/projects/mesa3d" +target="_parent">Mesa</A> +project is hosted by<A HREF="http://sourceforge.net" +target="_parent"><IMG SRC="http://sourceforge.net/sflogo.php?group_id=3&type=1" +WIDTH="88" HEIGHT="31" ALIGN="BOTTOM" ALT="Sourceforge.net" BORDER="0"></A> +<br> +<br> + +<li><a href="http://www.altsoftware.com/" +target="_parent">alt.software</a> contributed the Direct3D driver. + +<li><b>Bernd Barsuhn</b> +wrote the evaluator code for (splines, patches) in Mesa. + +<li><b>Bernhard Tschirren</b> +wrote the Allegro DJGPP driver. + +<li><b>Bogdan Sikorski</b> wrote the GLU +NURBS and polygon tessellator in Mesa. + +<li><b>Charlie Wallace</b> wrote +the MS-DOS driver. + +<li><b>CJ Beyer</b> is the +www.mesa3d.org webmaster. + +<li><b>Darren Abbott</b> provided the OS/2 driver. + +<li><b>David Bucciarelli</b> wrote and +maintains the 3Dfx Glide driver. Thousands of Linux/Quake players +thank David! + +<li><b>Gareth Hughes</b> wrote new GLU +1.2 Polygon Tessellation code (now superceded by SGI SI GLU). + +<li><b>Holger +Waechtler</b> contributed AMD 3DNow! assembly code which accelerates +vertex transformation in Mesa 3.1. Holger also implemented the +GL_EXT_texture_env_combine extension. + +<li><b>Jeroen van der Zijp</b> and +<b>Thorsten +Ohl</b> contributed the Xt/Motif widget code. + +<li><b>John Stone</b> provided the +multi-threading support in Mesa 3.0. + +<li><b>John Watson</b> assisted with +web page design. + +<li><b>Josh Vanderhoof</b> +contributed Intel x86 assembly code which accelerates vertex +transformation in Mesa 3.x. + +<li><b>Jouk Jansen</b> +contributed and continues to maintain the VMS support. + +<li>Karl Schultz has been maintaining the Windows driver. + +<li><b>Keith Whitwell</b> has made +extension contributions to Mesa since 1999. + +<li><b>Kendall Bennett</b> +wrote the SciTech MGL driver. + +<li><b>Mark Kilgard</b> contributed +antialiased line improvements and several extensions. + +<li>Michael Pichler contributed <em>many</em> bug fixes + +<li><b>Miklos Fazekas</b> wrote and +maintains the Macintosh driver. + +<li><b>Pascal +Thibaudeau</b> wrote the NeXT driver. + +<li><b>Pedro Vazquez</b> setup +and maintains the Mesa Mailing list. + +<li><b>Randy Frank</b> +contributed <em>many</em> bug fixes. + +<li><b>Stefan Zivkovic</b> wrote the +Amiga driver. + +<li><b>Stephane Rehel</b> provided the +Cygnus Win32 support + +<li><b>Ted Jump</b> maintained the +makefiles and project files for Windows 95/98/NT compilation for some time. + +<li><b>Uwe Maurer</b> wrote the +LibGGI driver for Mesa-3.0. + +<li><b>Victor Ng-Thow-Hing</b> +wrote the Amiwin driver for the Amiga. + +</ul> + +<p> +Apologies to anyone who's been omitted. +Please send corrections and additions to Brian. +</p> + + +</BODY> +</HTML> diff --git a/docs/utilities.html b/docs/utilities.html new file mode 100644 index 00000000000..f8dbc977fdd --- /dev/null +++ b/docs/utilities.html @@ -0,0 +1,20 @@ +<HTML> + +<TITLE>Development Utilities</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Development Utilities</H1> + +<ul> + +<li>The Mesa distribution includes several utility routines in the +util/ directory + +<li>Allen Akin's <a href="http://glean.sourceforge.net/" +target="_parent">glean</a> is a framework for OpenGL testing. + +</ul> + +</body> +</html>
\ No newline at end of file diff --git a/docs/utility.html b/docs/utility.html new file mode 100644 index 00000000000..3bbc2c70093 --- /dev/null +++ b/docs/utility.html @@ -0,0 +1,42 @@ +<HTML> + +<TITLE>Utilities</TITLE> + +<BODY text="#000000" bgcolor="#55bbff" link="#111188"> + +<H1>Utilities</H1> + +<ul> +<li><a href="http://fox.mit.edu/skunk/soft/fsv/" + target="_parent">fvs</a> - 3D file system visualizer + +<li><a href="http://www.dgp.utoronto.ca/%7Emac/projects/glbiff.html" + target="_parent">glbiff</a> - GL version of xbiff + +<li><a href="http://glload.netpedia.net/" target="_parent">glload</a> + - CPU load meter + +<li><a href="http://www.scitechsoft.com/gldirect.html" + target="_parent">SciTech GLDirect</a> - Driver to run OpenGL + apps using Direct3D under Windows + +<li><a href="http://threedsia.sourceforge.net/" + target="_parent">3Dsia</a> - 3D user interface + +<li><a href="http://mesa3d.sourceforge.net/notfound.html">VRML Site +Map</a> - 3D GUI + +<li><a href="http://www.vros.com/" target="_parent">VR/OS</a> - VR +user interface + +<li><a href="http://wauug.erols.com/%7Ebagleyd/" +target="_parent">xlockmore</a> - an X screen saver + +<li><a href="http://www.jwz.org/xscreensaver" +target="_parent">xscreensaver</a> - X screen saver + +</ul> + + +</body> +</html> diff --git a/docs/webmaster.html b/docs/webmaster.html new file mode 100644 index 00000000000..8688ae08c9a --- /dev/null +++ b/docs/webmaster.html @@ -0,0 +1,22 @@ +<HTML> + +<TITLE>Mesa Introduction</TITLE> + +<BODY text="#000000" bgcolor="#55bbff"> + +<H1>Webmaster</font></H1> + +<p> +If you have problems, edits or additions for this website send them +to <a href="mailto:[email protected]">Brian</a>. I'm not a skilled +webmaster but I'll do my best. +</p> + +<p> +Mark Manning made the frame-based layout for the website. +Brian's modified it a lot since then. +</p> + + +</body> +</html>
\ No newline at end of file |