Added featured projects section to JOGL home page. Reorganized and

updated documentation to move certain non-essential portions of home
page into developer documentation.


git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@995 232f8b59-042b-4e1e-8c03-345bb8c30851

11 files changed, 261 insertions, 167 deletions

diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html
index 76564edd8..8fab8bdbf 100644
--- a/doc/HowToBuild.html
+++ b/doc/HowToBuild.html
@@ -8,9 +8,62 @@
 <h1>How to build the JOGL OpenGL binding for Java</h1>
 <hr>
 
-Here are the steps that are required in order to build the JOGL
-OpenGL binding from a fresh copy of the source distribution:
-
+<P>
+
+The following are the supported build environments and
+platforms for JOGL. All require the <a
+href="http://www.antlr.org/">ANTLR</a> parser generator and the <a
+href="http://ant.apache.org/">Ant</a> build system version 1.6 or
+later to be installed. </p>
+                                                                        
+<ul>
+<li> Solaris/SPARC and Solaris/x86, 32- and 64-bit
+  <ul>
+  <li> <a href="http://www.sun.com/software/solaris/">Solaris 8 or later</a> </li>
+  <li> <a href="http://www.sun.com/software/products/studio/">Sun ONE Studio 8 Compiler Collection or later</a> </li>
+  <li> <a href="http://www.sun.com/software/graphics/opengl/">Sun OpenGL for Solaris</a> (or <a href="http://www.mesa3d.org/">Mesa</a> for Solaris 9 x86) </li>
+  <li> <a href="http://java.sun.com/j2se/1.4.2/">Sun JDK 1.4.2 or later</a> </li>
+  </ul>
+</li>
+<li> Linux/x86, 32- and 64-bit
+  <ul>
+  <li> Red Hat Linux 7.3 or later </li>
+  <li> GCC </li>
+  <li> <a href="http://java.sun.com/j2se/1.4.2/">Sun JDK 1.4.2 or later</a> </li>
+  </ul>
+</li>
+<li> Macintosh PowerPC or Intel
+  <ul>
+  <li> Mac OS X 10.3 (note: will not work with earlier releases) </li>
+  <li> GCC </li>
+  <li> <a href="http://www.apple.com/java/">Java 1.4.2 or later for Mac OS X</a> </li>
+  </ul>
+</li>
+<li> Windows/x86 (32-bit currently, but 64-bit is known to work)
+  <ul>
+  <li> Windows 2000 or later </li>
+  <li> Microsoft Visual C++ 6.0 or later, or <a href="http://www.mingw.org/">MinGW</a> compilers </li>
+  <li> <a href="http://java.sun.com/j2se/1.4.2/">Sun JDK 1.4.2 or later</a> </li>
+  </ul>
+</li>
+</ul>
+
+<P>
+
+Additional platforms such as FreeBSD and HP/UX are handled by the
+build system, but are not officially supported.
+
+</P>
+
+<P>
+Here are the steps that are required in order to build the JOGL OpenGL
+binding from a fresh copy of the source distribution, which can be
+obtained either from <a
+href="https://jogl.dev.java.net/source/browse/jogl/">CVS</a> or a <a
+href="https://jogl.dev.java.net/servlets/ProjectDocumentList">release
+build</a>.
+
+</P>
 <OL>
   <LI> <B>Install the JDK:</B> <br> the JOGL build requires JDK 1.4.2 or later. On AMD64 platforms such as Linux/AMD64, Solaris/AMD64 and Windows/AMD64, the build requires the Sun JDK 5.0 or later, as the 1.4.2 releases did not have an AMD64-specific JVM. On these platforms, it is also currently necessary to have e.g. <code>bin/amd64/java</code> in your PATH, although from a technical standpoint this could be worked around in the build process.
   <LI> <B>Install Ant:</B> <br> Download and unpack the latest version of Ant from <a href="http://ant.apache.org/">http://ant.apache.org</a> and add the <code>bin/</code> subdirectory to your PATH environment variable.
diff --git a/doc/userguide/index.html b/doc/userguide/index.html
index b3d1e408d..62011901a 100644
--- a/doc/userguide/index.html
+++ b/doc/userguide/index.html
@@ -14,6 +14,7 @@
   <LI> Overview
   <LI> Developing with JOGL
   <UL>
+    <LI> Building the source tree
     <LI> Local installation for development
     <LI> Java Web Start integration
     <LI> Applet support
@@ -86,6 +87,18 @@ the JSR has not yet been produced.
 
 <H2> Developing with JOGL </H2>
 
+<H3> Building the source tree </H3>
+
+<P>
+
+Most developers using JOGL will download the most current <a
+href="https://jogl.dev.java.net/servlets/ProjectDocumentList">release
+build</a>. Separate instructions are available on how to <a
+href="https://jogl.dev.java.net/unbranded-source/browse/*checkout*/jogl/doc/HowToBuild.html?rev=HEAD&amp;content-type=text/html">build
+the source tree</a>.
+
+</P>
+
 <H3> Local installation for development </H3>
 
 <P>
diff --git a/www/artofillusion.jpg b/www/artofillusion.jpg
new file mode 100755
index 000000000..a4747f045
--- /dev/null
+++ b/www/artofillusion.jpg
diff --git a/www/chronotext.jpg b/www/chronotext.jpg
new file mode 100755
index 000000000..a50d33f76
--- /dev/null
+++ b/www/chronotext.jpg
diff --git a/www/fenggui.jpg b/www/fenggui.jpg
new file mode 100755
index 000000000..c55a8c1c6
--- /dev/null
+++ b/www/fenggui.jpg
diff --git a/www/glstudio.jpg b/www/glstudio.jpg
new file mode 100755
index 000000000..d11b1388f
--- /dev/null
+++ b/www/glstudio.jpg
diff --git a/www/index.html b/www/index.html
index 0be4ea3af..563efe443 100644
--- a/www/index.html
+++ b/www/index.html
@@ -57,20 +57,24 @@ The JOGL project hosts the development version of the Java&trade;
 Binding for the OpenGL&reg; API (<a
 href="http://jcp.org/en/jsr/detail?id=231">JSR-231</a>), and is
 designed to provide hardware-supported 3D graphics to applications
-written in Java. JOGL is not the official reference implementation of
-the JSR, but an evolving workspace; snapshots are taken from this
-workspace which become the official reference implementations of the
-JSR. JOGL is part of a suite of open-source technologies initiated by
-the Game Technology Group at Sun Microsystems.
-
-                  <p>JOGL provides full access to the APIs in the OpenGL
-2.0 specification as well as nearly all vendor extensions, and integrates
-with the AWT and Swing widget sets.<br>
+written in Java. JOGL provides full access to the APIs in the OpenGL
+2.0 specification as well as nearly all vendor extensions, and
+integrates with the AWT and Swing widget sets. It is part of a suite
+of open-source technologies initiated by the Game Technology Group at
+Sun Microsystems.
                    </p>
                    
                   <p>Please see the <a
  href="https://jogl-demos.dev.java.net/">JOGL demos</a> for illustrations of
-advanced OpenGL techniques now possible with the Java platform.<br>
+advanced OpenGL techniques now possible with the Java platform.
+                   </p>
+
+<p>Documentation is available for <a
+href="https://jogl.dev.java.net/unbranded-source/browse/*checkout*/jogl/doc/userguide/index.html?rev=HEAD&content-type=text/html">developers
+wishing to use</a> JOGL in their applications as well as those wishing
+to <a
+href="https://jogl.dev.java.net/unbranded-source/browse/*checkout*/jogl/doc/HowToBuild.html?rev=HEAD&amp;content-type=text/html">build
+the JOGL source tree</a>.
                    </p>
                      </div>
                       </td>
@@ -81,137 +85,6 @@ advanced OpenGL techniques now possible with the Java platform.<br>
             </table>
                 </td>
               </tr>
-             <tr>
-               <td>                                                     
-           
-            <table bgcolor="#6E94B7" border="0" cellpadding="5"
- cellspacing="1" width="100%">
-                   <tbody>
-                   <tr>
-                     <td bgcolor="#6E94B7" width="589">                 
-                                                                        
-    
-                  <div align="left"><font color="#ffffff"><strong>Project
-                     Status</strong></font></div>
-                      </td>
-                    </tr>
-                   <tr>
-                     <td bgcolor="#F8F8F8">                             
-                                                                 
-                  <div align="justify">The initial implementation of the JOGL
-                     API is available for download from <a
- href="https://jogl.dev.java.net/source/browse/jogl/">CVS</a>.           
-    </div>
-                      </td>
-                    </tr>
-                                                               
-              </tbody>                                                  
- 
-            </table>
-                </td>
-              </tr>
-             <tr>
-               <td>                                                     
-           
-            <table bgcolor="#6E94B7" border="0" cellpadding="5"
- cellspacing="1" width="100%">
-                   <tbody>
-                   <tr>
-                     <td bgcolor="#6E94B7" width="589">                 
-                                                                        
-    
-                  <div align="left"><font color="#ffffff"><strong>Getting
-  Started                    </strong></font></div>
-                      </td>
-                    </tr>
-                   <tr>
-                     <td bgcolor="#F8F8F8" valign="top">                
-                                                                        
-     
-                  <p>This project has been built in the following       
-            environments. All require the <a
- href="http://www.antlr.org/">ANTLR</a> parser generator and the <a
- href="http://ant.apache.org/">Ant</a> build system version 1.6 or later to be installed; please
-see the <a
- href="https://jogl.dev.java.net/unbranded-source/browse/*checkout*/jogl/doc/HowToBuild.html?rev=HEAD&amp;content-type=text/html">build
-documentation</a> for details. </p>
-                                                                        
-                          
-                  <ul>
-     		    <li> Solaris                                                 
-                                                               
-                      <ul>
-                            <li> <a
- href="http://www.sun.com/software/solaris/">Solaris         
-             8 or later</a>  		      </li>
-                            <li> <a
- href="http://www.sun.com/software/products/studio/">Sun        
-              ONE Studio 8 Compiler Collection or later</a> 		       		      </li>
-                            <li> <a
- href="http://www.sun.com/software/graphics/opengl/">Sun     
-                 OpenGL for Solaris</a> (or <a href="http://www.mesa3d.org/">Mesa</a> for Solaris 9 x86)  		      </li>
-                            <li> <a
- href="http://java.sun.com/j2se/1.4.2/">Sun  J2SDK 		      1.4.2 or later</a>     
-                </li>
-                                                                         
-                     
-                      </ul>
-      		    </li>
-                        <li> Linux                                      
-                                                                        
- 
-                      <ul>
-                           <li> Red Hat Linux 7.3 for x86 or later 		      </li>
-                            <li> GCC 		      </li>
-                            <li> <a
- href="http://java.sun.com/j2se/1.4.2/">Sun  J2SDK 		      1.4.2 or later</a> 		  
- </li>
-                                                                         
-                     
-                      </ul>
-      		    </li>
-                        <li> Macintosh                                  
-                                                                        
-     
-                      <ul>
-                           <li> Mac OS X 10.3 (note:
-                      will not work with earlier releases)  		      </li>
-                            <li> GCC  		      </li>
-                            <li> <a href="http://www.apple.com/java/">Java
- 		       1.4.2 or later for Mac OS X</a> 		    </li>
-                                                                         
-                     
-                      </ul>
-      		    </li>
-                        <li> Windows                                    
-                                                                        
-   
-                      <ul>
-                           <li> Windows 2000 or later for x86  		      </li>
-                            <li> Microsoft Visual C++                   
-   6.0 or later, or <a href="http://www.mingw.org/">MinGW</a> compilers  		 
-    </li>
-                            <li> <a
- href="http://java.sun.com/j2se/1.4.2/">Sun  J2SDK                       1.4.2 or later</a>
- 		    </li>
-                                                                         
-                     
-                      </ul>
-                                                                        
-                                      
-                      <p></p>
-                        </li>
-                                                                        
-      
-                  </ul>
-                      </td>
-                    </tr>
-                                                               
-              </tbody>                                                  
- 
-            </table>
-                </td>
-              </tr>
                                        
         </tbody>                            
       </table>
@@ -293,14 +166,17 @@ documentation</a> for details. </p>
                       <td valign="top" bgcolor="#F8F8F8">               
                                                            
                   <ul>
-                         <li><a
- href="https://jogl.dev.java.net/servlets/ProjectDocumentList"
- target="_blank">Precompiled binaries and documentation</a></li>
+                         <li><a href="#NIGHTLY">Current nightly build</a></li>
 
                          <li><a
 
  href="https://jogl.dev.java.net/servlets/ProjectDocumentList?folderID=5971&expandFolder=5971"
  target="_blank">Current release build (JSR-231 1.0.0)</a></li>
+
+                         <li><a
+ href="https://jogl.dev.java.net/servlets/ProjectDocumentList"
+ target="_blank">Archived release and pre-release builds</a></li>
+
                         
                   </ul>
                       </td>
@@ -311,10 +187,171 @@ documentation</a> for details. </p>
             </table>
                 </td>
               </tr>
+                                                 
+        </tbody>                            
+      </table>
+          </td>
+        </tr>
+               
+  </tbody>    
+</table>
 
-             <tr>
-               <td>                                                     
-           
+<table border="0" cellpadding="0" cellspacing="1" width="100%">
+       <tbody>
+       <tr>
+         <td valign="top" width="100%">                                  
+            <table bgcolor="#6E94B7" border="0" cellpadding="5"
+ cellspacing="1" width="100%">
+                   <tbody>
+                   <tr>
+                     <td bgcolor="#6E94B7" width="589">                 
+                                                                        
+    
+                  <div align="left"><font color="#ffffff"><strong>Featured Projects</strong></font></div>
+                      </td>
+                    </tr>
+                   <tr>
+                     <td bgcolor="#F8F8F8">                             
+                  <table border="0" cellpadding="0" cellspacing="0" width="100%">
+                  <tr>
+                  <td>
+The following are a few examples of projects and products using
+JOGL. To have your project featured here, please email the <a
+href="mailto:[email protected]">project owners</a>.
+                  </td>
+                  </tr>
+                  </table>
+                  <br>
+                  <table border="0" cellpadding="0" cellspacing="0" width="100%">
+                   <tr>
+                   <td bgcolor="#F8F8F8">
+                   <table border="0" cellspacing="15">
+                   <tbody>
+                   <tr>
+                   <td bgcolor="#F8F8F8" width="50%">
+
+<a href="http://bytonic.de/html/jake2.html"><img src="jake2.jpg"
+width="160" height="128" align="left" alt="Jake2">Jake2</a> is a port
+of id Software's GPL'd Quake II engine from C to Java done by <a
+href="http://bytonic.de/">bytonic software</a>. You can run the game
+via <a href="http://bytonic.de/html/jake2_webstart.html">Java Web
+Start</a> with <b>no manual installation</b> on all of JOGL's
+supported platforms.
+
+                   </td>
+                   <td bgcolor="#F8F8F8">
+
+<a href="http://www.artofillusion.org/"><img src="artofillusion.jpg"
+width="160" height="117" align="left" alt="Art Of Illusion">Art of
+Illusion</a> is a free, open source 3D modelling and rendering
+studio. Many of its capabilities rival those found in commercial
+programs. Some of the highlights include subdivision surface based
+modelling tools, skeleton based animation, and a graphical language
+for designing procedural textures and materials. It uses JOGL for
+real-time OpenGL rendering in its modeling views.
+
+
+                   </td>
+                   </tr>
+
+                   <tr>
+                   <td bgcolor="#F8F8F8" width="50%">
+
+<a href="http://chronotext.org/"><img src="chronotext.jpg" width="160"
+height="72" align="left" alt="chronotext">chronotext</a> is a series
+of visual design experiments involving animated text and 3D objects
+and surfaces. Several examples can be run on-line via <a
+href="http://chronotext.org/scriptorium/behind/index.htm">Java Web
+Start</a>.
+
+                   </td>
+                   <td bgcolor="#F8F8F8">
+
+<a href="http://www.fenggui.org/"><img src="fenggui.jpg" width="160"
+height="127" align="left" alt="FengGUI">FengGUI</a> is a graphical
+user interface (GUI) application programming interface (API) based on
+OpenGL. FengGUI provides all typical GUI components like buttons,
+sliders, trees, text areas, frames, tabs, etc. which are required to
+build a complete GUI system. Since it is based on OpenGL, FengGUI fits
+well in multimedia and game environments.
+
+                   </td>
+                   </tr>
+
+                   <tr>
+                   <td bgcolor="#F8F8F8" width="50%">
+
+<a
+href="http://www.simulation.com/products/glstudio/glstudio.html"><img
+src="glstudio.jpg" width="160" height="135" align="left" alt="GL
+Studio">GL Studio</a> is the world's first and only object oriented
+rapid virtual prototyping tool. GL Studio's powerful and intuitive
+WYSIWYG modeling system allows you to rapidly create rich, interactive
+graphical user interfaces to prototype new interfaces or to simulate
+existing electronic and analog human machine interfaces. Its <a
+href="http://www.simulation.com/products/glstudio/java/java.html">Java
+code generator</a> produces platform-independent Java code using JOGL.
+
+
+                   </td>
+                   <td bgcolor="#F8F8F8">
+
+<a href="http://www.javapause.com/"><img src="jackflowers.jpg"
+width="160" height="120" align="left" alt="Jack Flowers">Jack
+Flowers</a> is a 3D platform action and adventure game under
+development. Jack is a flower collector (a kind of mutant beetle) who
+loves flowers so much that he can't help collecting them. Your goal
+through the game is to help Jack pick up flowers to progress through
+vegetal levels.
+
+                   </td>
+                   </tr>
+
+                   <tr>
+                   <td bgcolor="#F8F8F8" width="50%">
+
+<a href="http://processing.org/"><img src="processing.jpg" width="160"
+height="158" align="left" alt="processing">Processing</a> is an open
+source programming language and environment for people who want to
+program images, animation, and sound. It is used by students, artists,
+designers, architects, researchers, and hobbyists for learning,
+prototyping, and production. Processing is developed by artists and
+designers as an alternative to proprietary software tools in the same
+domain. It uses JOGL for its hardware accelerated 3D rendering
+support.
+
+                   </td>
+                   <td bgcolor="#F8F8F8">
+
+<a href="http://www.vlsolutions.com/"><img src="vldocking.jpg"
+width="160" height="113" align="left" alt="VLDocking">VLDocking</a> is
+a set of Java components that helps the Swing developer to build
+applications with Docking capabilities, and even raise existing
+applications to higher standards. It supports docking via drag and
+drop, enhanced toolbars, closable tabs, and more. It fully supports
+heavyweight components such as JOGL's GLCanvas in a docking
+environment.
+
+                   </td>
+                   </tr>
+
+
+                   </tbody>
+                   </table>
+            </tbody>
+            </table>
+        </td>
+        </tr>
+</tbody>
+</table>
+
+
+
+
+<table border="0" cellpadding="0" cellspacing="1" width="100%">
+       <tbody>
+       <tr>
+         <td valign="top" width="100%">                                  
             <table bgcolor="#6E94B7" border="0" cellpadding="5"
  cellspacing="1" width="100%">
                    <tbody>
@@ -322,7 +359,7 @@ documentation</a> for details. </p>
                      <td bgcolor="#6E94B7" width="589">                 
                                                                         
     
-                  <div align="left"><font color="#ffffff"><strong>Current nightly build</strong></font></div>
+                  <div align="left"><font color="#ffffff"><strong><a name="NIGHTLY">Current nightly build</a></strong></font></div>
                       </td>
                     </tr>
                    <tr>
@@ -413,23 +450,14 @@ documentation</a> for details. </p>
 </TR>
 </TABLE>
 <!- END NIGHTLY -->
-                                                                 
-                      </td>
-                    </tr>
-                                                               
-              </tbody>                                                  
- 
-            </table>
-                </td>
-              </tr>
+    </td>
+    </tr>
+    </table>
 
-                                                 
-        </tbody>                            
-      </table>
-          </td>
-        </tr>
-               
-  </tbody>    
+</td>
+</tr>
+</tbody>
 </table>
+
 </body>
 </html>
diff --git a/www/jackflowers.jpg b/www/jackflowers.jpg
new file mode 100755
index 000000000..21e072f58
--- /dev/null
+++ b/www/jackflowers.jpg
diff --git a/www/jake2.jpg b/www/jake2.jpg
new file mode 100755
index 000000000..dd7bf96f7
--- /dev/null
+++ b/www/jake2.jpg
diff --git a/www/processing.jpg b/www/processing.jpg
new file mode 100755
index 000000000..cf833d4d0
--- /dev/null
+++ b/www/processing.jpg
diff --git a/www/vldocking.jpg b/www/vldocking.jpg
new file mode 100755
index 000000000..a4afaaf22
--- /dev/null
+++ b/www/vldocking.jpg