docs: consolidate html header and footer
[mesa.git] / docs / viewperf.html
index c294255acb866bf6622ed27da2a57f13fdc89e1a..6c3faf68ce368b17e6ccfb06f806f555d2475113 100644 (file)
@@ -1,10 +1,11 @@
-<HTML>
-
-<TITLE>Viewperf Issues</TITLE>
-
-<link rel="stylesheet" type="text/css" href="mesa.css"></head>
-
-<BODY>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8">
+  <title>Viewperf Issues</title>
+  <link rel="stylesheet" type="text/css" href="mesa.css">
+</head>
+<body>
 
 <h1>Viewperf Issues</h1>
 
@@ -32,6 +33,10 @@ These issues have been reported to the SPEC organization in the hope that
 they'll be fixed in the future.
 </p>
 
+<p>
+Some of the Viewperf tests use a lot of memory.
+At least 2GB of RAM is recommended.
+</p>
 
 
 <h2>Catia-03 test 2</h2>
@@ -80,6 +85,11 @@ If the Mesa driver doesn't support this extension the rendering will
 be incorrect and the test will fail.
 </p>
 
+<p>
+Also, the color of the line drawings in test 2 seem to appear in a random
+color.  This is probably due to some uninitialized state somewhere.
+</p>
+
 
 
 <h2>sw-02 test 6</h2>
@@ -152,9 +162,40 @@ If the fallback texture created in _mesa_get_fallback_texture() is
 initialized to be full white instead of full black the rendering appears
 correct.
 However, we have no plans to implement this work-around in Mesa.
+</p>
+
+
+<h2>Maya-03 test 2</h2>
 
+<p>
+This test makes some unusual calls to glRotate.  For example:
+</p>
+<pre>
+glRotate(50, 50, 50, 1);
+glRotate(100, 100, 100, 1);
+glRotate(52, 52, 52, 1);
+</pre>
+<p>
+These unusual values lead to invalid modelview matrices.
+For example, the last glRotate command above produces this matrix with Mesa:
+<pre>
+1.08536e+24 2.55321e-23 -0.000160389 0 
+5.96937e-25 1.08536e+24 103408 0 
+103408 -0.000160389 1.74755e+09 0 
+0 0 0 nan 
+</pre>
+and with NVIDIA's OpenGL:
+<pre>
+1.4013e-45 0 -nan 0 
+0 1.4013e-45 1.4013e-45 0 
+1.4013e-45 -nan 1.4013e-45 0 
+0 0 0 1.4013e-45 
+</pre>
+<p>
+This causes the object in question to be drawn in a strange orientation
+and with a semi-random color (between white and black) since GL_FOG is enabled.
 </p>
 
 
-</BODY>
-</HTML>
+</body>
+</html>