|
From: Brian M. <ma...@us...> - 2004-03-30 17:30:17
|
Update of /cvsroot/java-game-lib/LWJGL/www In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12642 Added Files: about.php changelog.php contact.php credits.php default.css demos.php documentation.php download.php faq.php forum.php index.php installation.php license.php links.php projects.php Log Message: readded site under www --- NEW FILE: projects.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("projects"); ?> <script type="text/javascript" language="javascript"> // our window var ssWindow = null; // shows the screenshot using supplied name. File to show is based on document & number function showScreenShot(name, document, number, imgWidth, imgHeight) { // nuke old if exists if (ssWindow != null) { ssWindow.close(); } // calculate sizes var docWidth = imgWidth + 1; var docHeight = imgHeight + 40; var centerX = (screen.width) ? (screen.width-docWidth)/2 : 0; var centerY = (screen.height) ? (screen.height-docHeight)/2 : 0; var extra = (navigator.userAgent.toLowerCase().indexOf("msie") > -1) ? 15 : 0; // if screen is < image, make window window size - scrollbar size if (screen.width < imgWidth) { docWidth = screen.width - 50; } if (screen.height < imgHeight) { docHeight = screen.height - 50; } // open our window ssWindow = window.open("", name, "left=" + centerX + ",top=" + centerY + ",width=" + docWidth + ", height=" + (docHeight + extra) + ",location=no,menubar=no,status=no,toolbar=no,scrollbars=no,resizable=no"); // write the html ssWindow.document.open(); ssWindow.document.write("<html>\n"); ssWindow.document.write(" <head>\n"); ssWindow.document.write(" <title>" + name + "</title>\n"); ssWindow.document.write(" <link rel=\"STYLESHEET\" href=\"default.css\" type=\"text/css\"\n>"); ssWindow.document.write(" </head>\n"); ssWindow.document.write(" <body leftmargin=\"0\" topmargin=\"0\">\n"); ssWindow.document.write(" <a href=\"javascript:window.close()\"><img src=\"" + "images/projects/" + document + "_" + number + ".jpg\" border=\"0\" width=\"" + imgWidth + "\" height=\"" + imgHeight + "\"></a>\n"); ssWindow.document.write(" <p>\n"); ssWindow.document.write(" <div align=\"center\"><font family=\"Fixedsys\"><a href=\"javascript:window.close()\">close window</a></font>\n"); ssWindow.document.write(" </body>\n"); ssWindow.document.write("<html>"); ssWindow.document.close(); // come hence forth, my true popup! ssWindow.focus(); } </script> <!-- Introduction --> <div class="paragraph_item"> <h2>Projects</h2> <p> The following is a list of projects that use LWJGL:<br> <i>Please write to <a href="mailto:in...@lw...">in...@lw...</a> if you have a project you want to have listed</i> </p> <!-- ALIEN FLUX --> <p><u>Alien Flux</u></p> <p> <table width="600" border="0"> <tr> <td width="75">Website: </td> <td><a href="http://puppygames.net/info.php?game=Alien_Flux" target="_blank">http://puppygames.net</a></td> </tr> <tr> <td width="75">Type: </td> <td>Commercial game</td> </tr> <tr valign="top "> <td width="75">Description:</td> <td>Defend the cutest, fluffiest little creatures in the Galaxy from a horde of evil aliens from the fifth dimension! With only fast reactions, animal cunning and a very big laser cannon to help you, you must rescue the Fluffies as malevolent Bubbles attempt to turn them into lime jelly. Fast, fun and furious original arcade action, incredible graphics, and atmospheric sound effects combine to make Alien Flux the best arcade shoot-em-up you've played for over a decade!</td> </tr> <tr> <td colspan="2"> </td> </tr> </table> <table width="600" border="0"> <tr> <td><a href="javascript:showScreenShot('AlienFlux', 'alienflux', '1', 499, 379);"><img src="images/projects/alienflux_small_1.jpg" border="0" width="150" height="112"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('AlienFlux', 'alienflux', '2', 499, 379);"><img src="images/projects/alienflux_small_2.jpg" border="0" width="150" height="112"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('AlienFlux', 'alienflux', '3', 499, 379);"><img src="images/projects/alienflux_small_3.jpg" border="0" width="150" height="112"><a/></td> </tr> </table> </p> <!-- TRIBAL TROUBLE --> <p> </p> <p> </p> <p><u>Tribal Trouble</u></p> <p> <table width="600" border="0"> <tr> <td width="75">Website: </td> <td><a href="http://www.tribaltrouble.com/" target="_blank">http://www.tribaltrouble.com/</a></td> </tr> <tr> <td width="75">Type: </td> <td>Commercial game</td> </tr> <tr valign="top "> <td width="75">Description:</td> <td>Take the role of a chieftain and lead your clueless kinsmen to new discoveries and victories as tribal clashes rage across a group of tropical islands. Tribal Trouble is a fast paced realtime strategy game where you will find yourself pitted against your computer or online players as you collect resources, research new ground-breaking technologies (such as the spear) and rejoice as your armies burn down enemy villages.</td> </tr> <tr> <td colspan="2"> </td> </tr> </table> <table width="600" border="0"> <tr> <td><a href="javascript:showScreenShot('TribalTrouble', 'tribaltrouble', '1', 1024, 768);"><img src="images/projects/tribaltrouble_small_1.jpg" border="0" width="150" height="113"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('TribalTrouble', 'tribaltrouble', '2', 1024, 768);"><img src="images/projects/tribaltrouble_small_2.jpg" border="0" width="150" height="113"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('TribalTrouble', 'tribaltrouble', '3', 1024, 768);"><img src="images/projects/tribaltrouble_small_3.jpg" border="0" width="150" height="113"><a/></td> </tr> </table> </p> <!-- EXTORRIS --> <p> </p> <p> </p> <p><u>Extorris</u></p> <p> <table width="600" border="0"> <tr> <td width="75">Website: </td> <td><a href="http://extorris.com/" target="_blank">http://extorris.com/</a></td> </tr> <tr> <td width="75">Type: </td> <td><i>not provided</i></td> </tr> <tr valign="top "> <td width="75">Description:</td> <td><i>not provided</i></td> </tr> <tr> <td colspan="2"> </td> </tr> </table> <table width="600" border="0"> <tr> <td><a href="javascript:showScreenShot('Extorris', 'extorris', '1', 1024, 768);"><img src="images/projects/extorris_small_1.jpg" border="0" width="150" height="113"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('Extorris', 'extorris', '2', 1024, 768);"><img src="images/projects/extorris_small_2.jpg" border="0" width="150" height="113"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('Extorris', 'extorris', '3', 1024, 768);"><img src="images/projects/extorris_small_3.jpg" border="0" width="150" height="113"><a/></td> </tr> </table> </p> <!-- MARATHON --> <p> </p> <p> </p> <p><u>Marathon</u></p> <p> <table width="600" border="0"> <tr> <td width="75">Website: </td> <td><a href="http://www.digitalage.gr/zdimensions/" target="_blank">http://www.digitalage.gr/zdimensions/</a></td> </tr> <tr> <td width="75">Type: </td> <td><i>not provided</i></td> </tr> <tr valign="top "> <td width="75">Description:</td> <td><i>not provided</i></td> </tr> <tr> <td colspan="2"> </td> </tr> </table> <table width="600" border="0"> <tr> <td><a href="javascript:showScreenShot('Marathon', 'marathon', '1', 600, 450);"><img src="images/projects/marathon_small_1.jpg" border="0" width="150" height="113"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('Marathon', 'marathon', '2', 1024, 768);"><img src="images/projects/marathon_small_2.jpg" border="0" width="150" height="113"><a/></td> <td witdh="10"> </td> <td><a href="javascript:showScreenShot('Marathon', 'marathon', '3', 600, 450);"><img src="images/projects/marathon_small_3.jpg" border="0" width="150" height="113"><a/></td> </tr> </table> </p> </div> <?php printFooter(); ?> --- NEW FILE: changelog.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("changelog"); function printChangelog($version) { echo "<a name=\"$version\"></a>\n"; echo "<h3>LWJGL $version <a href=\"#top\">top</a></h3>\n"; echo "<div style=\"padding-left: 20px;\">\n"; echo "<pre>"; @readfile("changelogs/$version-changelog.txt"); echo "</pre>\n"; echo "</div>\n"; } ?> <a name="top"></a> <!-- Introduction --> <div class="paragraph_item"> <h2>Changelog</h2> <p>The following is a list of changes of LWJGL per release.</p> <p> <ul> <li><a href="changelogs/full-changelog.txt">Full changelog</a></li> <li><a href="#0.89">LWJGL 0.89</a></li> <li><a href="#0.80">LWJGL 0.80</a></li> <li><a href="#0.70">LWJGL 0.70</a></li> <li><a href="#0.60">LWJGL 0.60</a></li> <li><a href="#0.50">LWJGL 0.50</a></li> <li><a href="#0.40">LWJGL 0.40</a></li> <li><a href="#0.30">LWJGL 0.30</a></li> <li><a href="#0.20">LWJGL 0.20</a></li> <li><a href="#0.10">LWJGL 0.10</a></li> </ul> </p> <?php printChangelog("0.89"); ?> <?php printChangelog("0.80"); ?> <?php printChangelog("0.70"); ?> <?php printChangelog("0.60"); ?> <?php printChangelog("0.50"); ?> <?php printChangelog("0.40"); ?> <?php printChangelog("0.30"); ?> <?php printChangelog("0.20"); ?> <?php printChangelog("0.10"); ?> </div> <?php printFooter(); ?> --- NEW FILE: index.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("home"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Introduction</h2> <p> The Lightweight Java Game Library (LWJGL) is a solution aimed directly at professional and amateur Java programmers alike to enable commercial quality games to be written in Java. LWJGL provides developers access to high performance crossplatform libraries such as OpenGL (Open Graphics Library) and OpenAL (Open Audio Library) allowing for state of the art 3D games and 3D sound. Additionally LWJGL provides access to controllers such as Gamepads, Steering wheel and Joysticks. All in a simple and straight forward API. </p> <p> LWJGL is not meant to make writing games particularly easy; it is primarily an enabling technology which allows developers to get at resources that are simply otherwise unavailable or poorly implemented on the existing Java platform. We anticipate that the LWJGL will, through evolution and extension, become the foundation for more complete game libraries and "game engines" as they have popularly become known, and hide some of the new evils we have had to expose in the APIs. </p> <p> LWJGL is available under a BSD license, which means it's open source and freely available at no charge. However, we won't mind a <a href="http://sourceforge.net/donate/index.php?group_id=58488">donation</a>. </p> </div> <?php printNews(); printFooter(); ?> --- NEW FILE: links.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("links"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Links</h2> <p> The following list of links are sites that either relate to our effort, or we just think are cool:<br><br> - <a href="http://www.javagaming.org/" target="blank">http://www.javagaming.org/</a><br> Site related to Java gamming <br> <br> - <a href="http://www.puppygames.net/" target="blank">http://www.puppygames.net/</a><br> First commercial game using LWJGL! <br> <br> - <a href="http://www.tribaltrouble.com/" target="blank">http://www.tribaltrouble.com/</a><br> Awesome new commercial game using LWJGL <br> <br> - <a href="http://sourceforge.net/projects/spgl/" target="blank">http://sourceforge.net/projects/spgl/</a><br> Game library building on top of lwjgl <br> <br> - <a href="http://www.mojomonkeycoding.com/" target="blank">http://www.mojomonkeycoding.com/</a><br> jME (or jMonkeyEngine) is an attempt at a fully functional game engine using the Java programming language. <br> <br> - <a href="http://www.hardcode.de/jxinput/" target="blank">http://www.hardcode.de/jxinput/</a><br> More feature complete input support for java </p> </div> <?php printFooter(); ?> --- NEW FILE: credits.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("credits"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Credits</h2> <p> The following people have helped to make this project what it is today: <br> <br> <b>Active developers:</b><br> - Caspian Rychlik-Prince<br> - Brian Matzon<br> - Elias Naur<br> - Erik Duijs<br> - Ioannis Tsakpinis<br> <br> <br> <b>Contributors:</b><br> - Niels Jørgensen<br> - Tristan Campbell<br> - Gregory Pierce<br> - Luke Holden<br> <br> <br> <b>Additional credits goes to:</b><br> - Joseph I. Valenzuela [OpenAL stuff]<br> - Lev Povalahev [OpenGL Extensions]<br> </p> </div> <?php printFooter(); ?> --- NEW FILE: forum.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("forum"); ?> <div class="iframe"> <iframe FRAMEBORDER="0" width="100%" height="2800" src="http://forum.lwjgl.org/"></iframe> </div> <?php printFooter(); ?> --- NEW FILE: faq.php --- <?php require 'include/default.php'; require 'include/faq.php'; printHeader(null, null); printMenu("faq"); ?> <?php printFAQ(); ?> <?php printFooter(); ?> --- NEW FILE: documentation.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("documentation"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Documentation</h2> <p> Here you will find documentation for LWJGL. Currently only javadoc is available. </p> <p> <a href="/https/sourceforge.net/javadoc" target="_blank">LWJGL javadoc</a> </p> </div> <?php printFooter(); ?> --- NEW FILE: contact.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("contact"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Contact</h2> <p> The LWJGL project is an opensource project, being actively developed by several people from all over the world. Any contact to the project as a group is therefore best done using either:<br> <ul> <li><a href="http://forum.lwjgl.org/" target="_blank">LWJGL forum</a></li> <li><a href="irc://irc.freenode.net/lwjgl">#LWJGL IRC channel</a> on the freenode network</li> </ul> </p> <p> If you wish to contact the LWJGL developers directly, please send an email to <a href="mailto:in...@lw...">in...@lw...</a> </p> </div> <?php printFooter(); ?> --- NEW FILE: demos.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("demos"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Demos</h2> <p>The following is a list of webstartable demos of LWJGL, all from the <code>org.lwjgl.test.*</code> package</p> <p><b>Input</b></p> <p><pre> ControllerCreationTest [<a href="jnlp/lwjgl-demo.php/input.ControllerCreationTest">launch</a> | <a href="jnlp/source.php?path=input/ControllerCreationTest.java" target="_blank">source</a>] ControllerTest [<a href="jnlp/lwjgl-demo.php/input.ControllerTest">launch</a> | <a href="jnlp/source.php?path=input/ControllerTest.java" target="_blank">source</a>] HWCursorTest [<a href="jnlp/lwjgl-demo.php/input.HWCursorTest">launch</a> | <a href="jnlp/source.php?path=input/HWCursorTest.java" target="_blank">source</a>] KeyboardTest [<a href="jnlp/lwjgl-demo.php/input.KeyboardTest">launch</a> | <a href="jnlp/source.php?path=input/KeyboardTest.java" target="_blank">source</a>] MouseCreationTest [<a href="jnlp/lwjgl-demo.php/input.MouseCreationTest">launch</a> | <a href="jnlp/source.php?path=input/MouseCreationTest.java" target="_blank">source</a>] MouseTest [<a href="jnlp/lwjgl-demo.php/input.MouseTest">launch</a> | <a href="jnlp/source.php?path=input/MouseTest.java" target="_blank">source</a>]</pre> </p> <p><b>OpenAL</b></p> <p><pre> ALCTest [<a href="jnlp/lwjgl-demo.php/openal.ALCTest">launch</a> | <a href="jnlp/source.php?path=openal/ALCTest.java" target="_blank">source</a>] PositionTest [<a href="jnlp/lwjgl-demo.php/openal.PositionTest">launch</a> | <a href="jnlp/source.php?path=openal/PositionTest.java" target="_blank">source</a>] EAXTest [<a href="jnlp/lwjgl-demo.php/openal.EAXTest">launch</a> | <a href="jnlp/source.php?path=openal/EAXTest.java" target="_blank">source</a>] MovingSoundTest [<a href="jnlp/lwjgl-demo.php/openal.MovingSoundTest">launch</a> | <a href="jnlp/source.php?path=openal/MovingSoundTest.java" target="_blank">source</a>] OpenALCreationTest [<a href="jnlp/lwjgl-demo.php/openal.OpenALCreationTest">launch</a> | <a href="jnlp/source.php?path=openal/OpenALCreationTest.java" target="_blank">source</a>] PlayTest [<a href="jnlp/lwjgl-demo.php/openal.PlayTest">launch</a> | <a href="jnlp/source.php?path=openal/PlayTest.java" target="_blank">source</a>] PlayTestMemory [<a href="jnlp/lwjgl-demo.php/openal.PlayTestMemory">launch</a> | <a href="jnlp/source.php?path=openal/PlayTestMemory.java" target="_blank">source</a>] SourceLimitTest [<a href="jnlp/lwjgl-demo.php/openal.SourceLimitTest">launch</a> | <a href="jnlp/source.php?path=openal/SourceLimitTest.java" target="_blank">source</a>] StressTest [<a href="jnlp/lwjgl-demo.php/openal.StressTest">launch</a> | <a href="jnlp/source.php?path=openal/StressTest.java" target="_blank">source</a>]</pre> </p> <p><b>OpenGL</b></p> <p><pre> FullScreenWindowedTest [<a href="jnlp/lwjgl-demo.php/opengl.FullScreenWindowedTest">launch</a> | <a href="jnlp/source.php?path=opengl/FullScreenWindowedTest.java" target="_blank">source</a>] Game [<a href="jnlp/lwjgl-demo.php/opengl.Game">launch</a> | <a href="jnlp/source.php?path=opengl/Game.java" target="_blank">source</a>] Grass [<a href="jnlp/lwjgl-demo.php/opengl.Grass">launch</a> | <a href="jnlp/source.php?path=opengl/Grass.java" target="_blank">source</a>] PbufferTest [<a href="jnlp/lwjgl-demo.php/opengl.PbufferTest">launch</a> | <a href="jnlp/source.php?path=opengl/PbufferTest.java" target="_blank">source</a>] VBOIndexTest [<a href="jnlp/lwjgl-demo.php/opengl.VBOIndexTest">launch</a> | <a href="jnlp/source.php?path=opengl/VBOIndexTest.java" target="_blank">source</a>] VBOTest [<a href="jnlp/lwjgl-demo.php/opengl.VBOTest">launch</a> | <a href="jnlp/source.php?path=opengl/VBOTest.java" target="_blank">source</a>]</pre> </p> <p><b>org.lwjgl</b></p> <p><pre> SysTest [<a href="jnlp/lwjgl-demo.php/SysTest">launch</a> | <a href="jnlp/source.php?path=SysTest.java" target="_blank">source</a>] DisplayTest [<a href="jnlp/lwjgl-demo.php/DisplayTest">launch</a> | <a href="jnlp/source.php?path=DisplayTest.java" target="_blank">source</a>] WindowCreationTest [<a href="jnlp/lwjgl-demo.php/WindowCreationTest">launch</a> | <a href="jnlp/source.php?path=WindowCreationTest.java" target="_blank">source</a>]</pre> </p> </div> <?php printFooter(); ?> --- NEW FILE: about.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("about"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>About</h2> <p> <i>Taken from a <a href="http://www.javagaming.org/cgi-bin/JGNetForums/YaBB.cgi?board=LWJGL;action=display;num=1067072465;start=31#31" target="_blank">post</a> by Caspian on Javagaming.org</i> <br> <br> In response to everything here I'd like to state our goals with LWJGL: <ul> <li>Speed<br></li> <li>Simplicity<br></li> <li>Ubiquity<br></li> <li>Smallness<br></li> <li>Security<br></li> <li>Robustness<br></li> <li>Minimalism<br></li> </ul> <p> and this will help explain how we got to where we are today and more importantly where we're going and <i>where we're not going</i>. <p><u><b>Speed</b></u><br> The whole point of LWJGL was to bring the speed of Java rendering into the 21st century. This is why we have: <br> <ul> <br> <li>Thrown out methods designed for efficient C programming that make no sense at all in java, such as glColor3fv. <br></li> <li>Made the library throw an exception when hardware acceleration is not available on Windows. No point in running at 5fps is there? <br></li> </ul> <br> <p><u><b>Ubquity</b></u><br> Our library is designed to work on devices as small as phones right the way up to multiprocessor rendering servers. Just because there aren't any phones or consoles yet with fast enough JVMs and 3d acceleration is neither here nor there - there will be, one day. We're carefully tailoring the library so that when it happens we'll have OpenGL ES support in there just like that. This means that: <br> <ul> <li>We had to have a very small footprint or it'll never catch on in the J2ME space at all. That's why the binary distribution is under half a meg, and that takes care of 3d sound, graphics, and IO. <br> </li><li> Even under desktop environments having a 1-2mb download just to call a few 3D functions is daft. <br></li> <li> We've worked to a lowest common denominator principle rather than attempting to design for all possibilities, but we've made sure that 99% of required uses are covered. That's why we've only got one window, and why we don't guarantee that windowed mode is even supported (it's officially a debug mode and hence we don't even supply some very basic windowy abilities that you'd get in AWT) and why we don't allow multiple thread rendering contexts. <br></li> </ul> <br> <p><u><b>Simplicity</b></u><br> LWJGL needed to be simple for it to be used by a wide range of developers. We wanted relative newbies to be able to get on with it, and professionals to be able to use it professionally, maybe typically coming from a C++ background. We had to choose a paradigm that actually fits with OpenGL, and one that fits with our target platforms which ranges from PDA to desktop level. This is why: <br> <ul><br> <li>We aren't catering for single-buffered drawing<br></li> <li>We don't require that an instance of GL is passed around all over the place but <i>we do not prevent this style of coding</i>. See below for why. <br></li> <li>We removed a lot of stuff that 99% of games programmers need to know nothing about <br> </li> <li>We have decided that consistency is better than complexity. Rather than allowing multiple ways to call the same methods and bloating the library we've just said, "Right, no arrays. They're slower anyway. Get used to buffers, as this is what buffers are meant to be used for." </li> </ul> <br> <p><u><b>Smallness</b></u> <br> See ubiquity above. We had to be small. <br> <ul><br> <li>Small == simple. The less ways there are to do something, the easier it is to learn the only way that works or is allowed. <br> </li> <li>Small == <i>our code</i> is less buggy. Wouldn't you rather be hunting for bugs in your own code, not ours? <br> </li> <li>Small == downloadable. No version nightmares. LWJGL is small enough to download with every application that uses it. <br></li> <li>Small == J2ME. <br> </li> </ul><br> <p><u><b>Security</b></u> <br> We realised a few months ago that no-one was going to take us seriously if we couldn't guarantee the security of the LWJGL native libraries. This is why we: <br> <ul><br> <li>No longer use pointers but exclusively use buffers instead <br> </li> <li> Are gradually adding further checks to buffer positions and limits to ensure that the values are within allowed ranges to prevent buffer attacks <br></li> </ul> <br><p> <u><b>Robustness</b></u> <br> Similarly to security we have now realised that a reliable system is far more useful than a fast system. When we actually had a proper application to benchmark finally we had some real data. Many of our original design decisions were based on microbenchmarks - well, you have to start somewhere! But with a real application to benchmark we now know we can throw out asserts and replace them with a proper if (...) check and a thrown exception. We know also that we can move all that GL error checking out of native code and into Java code and we will no longer need a separate DLL for debug mode. <br> <br> As for runtime exceptions, they have their place. There's not a reasonably well defined argument as to when you should use a runtime exception and when you should use a checked exception. When I made OpenGLException a checked exception all it did was end up littering my code with try {} catch {} sections - except that if you've got an OpenGLException there is very little sensible you can do to rectify it because it should never have occurred in the first place. That's why it's a runtime exception. You should simply not write code than can throw it because it is generally not recoverable nicely. However for robustness (and security) we are required to throw an exception if something is amiss. It falls, I believe, into exactly the same category of trouble as NPEs, ArrayIndexOOBs and ClassCastExceptions: should never occur but needs to be trapped somewhere. <br> <p> <u><b>Minimalism</b></u> <br> This is another critical factor in our design decisions. If it doesn't need to be in the library, it's not in the library. Our original aim was to produce a library that provided the bare minimum required to access the hardware that Java couldn't access, and by and large we're sticking to this mantra. The vector math code in the LWJGL is looking mighty scared at the moment because it's probably for the chop - well, at least, from the core library - as it's not an enabling technology at all, and there are numerous more fully featured alternatives. We chucked out GLU because it's mostly irrelevant to game developers except for a few functions that we really need to get redeveloped in pure Java - but basically, GLU is just a library of code built on top of the enablement layer. </p> </div> <?php printFooter(); ?> --- NEW FILE: installation.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("installation"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Installation</h2> <p> As LWJGL is more or less self contained, the actual installation typically amounts to extracting the archive, and asserting that everything works fine by running an example. The following paragraphs will walk you through the installation on the supported platforms. </p> <p>For IDE integration click <a href="#ide">here</a>.</p> <!-- Windows --> <h3>Windows</h3> <p> 1. <a href="http://sourceforge.net/project/showfiles.php?group_id=58488">Download</a> the distribution<br> 2. Unpack the archive, file contents should include (amongst other things): <pre> lwjgl.dll lwjglaudio.dll lwjgl.jar lwjgl_test.jar</pre> </p> <p> 3. Test LWJGL by opening a command prompt, and navigating to the folder where the archive was extracted. once navigated, issue the following command: <pre> java -cp lwjgl.jar;lwjgl_test.jar; org.lwjgl.test.WindowCreationTest</pre> </p> <p> a window should appear, and you should see the following output: <pre> Found <number> display modes 240, 320, WindowCreationTest Display created</pre> </p> <p> 4. Should you wish to place the dll's in some other directory than you're class files (say /native as opposed to /classes) you could do so, by using the java.library.path property. For example <pre> java -cp classes; -Djava.library.path=native org.lwjgl.test.WindowCreationTest</pre> </p> <!-- linux --> <p> </p> <h3>Linux</h3> <p> 1. <a href="http://sourceforge.net/project/showfiles.php?group_id=58488">Download</a> the distribution<br> 2. Unpack the archive, file contents should include (amongst other things): <pre> liblwjgl.so libopenal.so lwjgl.jar lwjgl_test.jar</pre> </p> <p> 3. Test LWJGL by opening a command prompt, and navigating to the folder where the archive was extracted. once navigated, issue the following command: <pre> java -cp lwjgl.jar:lwjgl_test.jar: org.lwjgl.test.WindowCreationTest</pre> </p> <p> a window should appear, and you should see the following output: <pre> Found <number> display modes 240, 320, WindowCreationTest Display created</pre> </p> <p> 4. Should you wish to place the so files in some other directory than you're class files (say /native as opposed to /classes) you could do so, by using the java.library.path property. For example <pre> java -cp classes -Djava.library.path=native org.lwjgl.test.WindowCreationTest</pre> </p> <!-- Mac OS X --> <p> </p> <h3>Mac OS X</h3> <p> 1. <a href="http://sourceforge.net/project/showfiles.php?group_id=58488">Download</a> the distribution<br> 2. Unpack the archive, file contents should include (amongst other things): <pre> liblwjgl.jnilib libopenal.dylib lwjgl.jar lwjgl_test.jar</pre> </p> <p> 3. Test LWJGL by opening a command prompt, and navigating to the folder where the archive was extracted. once navigated, issue the following command: <pre> java -cp lwjgl.jar:lwjgl_test.jar: org.lwjgl.test.WindowCreationTest</pre> </p> <p> a window should appear, and you should see the following output: <pre> Found <number> display modes 240, 320, WindowCreationTest Display created</pre> </p> <p> 4. Should you wish to place the so files in some other directory than you're class files (say /native as opposed to /classes) you could do so, by using the java.library.path property. For example <pre> java -cp classes -Djava.library.path=native org.lwjgl.test.WindowCreationTest</pre> </p> </div> <p> </p> <a name="ide"></a> <div class="paragraph_item"> <h2>IDE integration</h2> <p> Using LWJGL in your IDE is as as simple as including the jar and telling where the native files are to be located. The following lists how to install LWJGL in some popular IDEs. </p> <!-- Eclipse --> <h3>Eclipse</h3> <p> 1. Having installed LWJGL on your platform of choice, fire up Eclipse.<br> 2. Create a new project, and add lwjgl.jar to the build path of your project (Project->Properties->Java build path) by clicking 'Add External JARs' under the Libraries tab<br><br> <img src="images/installation/eclipse-1.png"><br><br> 3. Having created a class to run, create a new run target by selecting the 'Run' icon or using the menu (Run -> Run...)<br><br> <img src="images/installation/eclipse-2.png"><br><br> select 'New' from the dialog box<br><br> <img src="images/installation/eclipse-3.png"><br><br> Supply a name for your new target, and make SURE you add the path to the dll files supplying the -Djava.library.path argument to the vm. The path you supply is relative to the working directory. Adjust this too if needed.<br><br> <img src="images/installation/eclipse-4.png"><br><br> 4. You should now be able to run the application directly from Eclipse. Run the newly created target to confirm. </p> <!-- Netbeans --> <p> </p> <h3>Netbeans</h3> <p> <i>no text yet</i> </p> <!-- JCreator --> <p> </p> <h3>JCreator</h3> <p> 1. At the top, click Project -> Project Properties<br> 2. Click a tab that says "Required Libraries"<br> 3. Then click the "new" button<br> 4. A new window should pop up. At the top text box, put LWJGL<br> 5. Then click add --> add path, and select the file were you put the .class/dll files<br> 6. Click add -> add archive and add both .jar files<br> </p> </div> <?php printFooter(); ?> --- NEW FILE: license.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("license"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>License</h2> <p> <pre> /* * Copyright (c) 2002-2004 Lightweight Java Game Library Project * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * * Neither the name of 'Light Weight Java Game Library' nor the names of * its contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ </pre> </p> </div> <?php printFooter(); ?> --- NEW FILE: download.php --- <?php require 'include/default.php'; require 'include/news.php'; printHeader(null, null); printMenu("download"); ?> <!-- Introduction --> <div class="paragraph_item"> <h2>Download</h2> <p> Latest stable release is 0.8. Please download it here:<br> <a href="http://sourceforge.net/project/showfiles.php?group_id=58488&package_id=54362&release_id=192924" target="_blank">LWJGL 0.8 alpha</a> </p> <p> Latest CVS tarball. Please download it here:<br> <a href="http://cvs.sourceforge.net/cvstarballs/java-game-lib-cvsroot.tar.bz2">CVS Tarball</a> </p> <p> For a list of all releases of LWJGL please follow this link:<br> <a href="http://sourceforge.net/project/showfiles.php?group_id=58488" target="_blank">LWJGL all releases</a> </p> </div> <?php printFooter(); ?> --- NEW FILE: default.css --- /* default body style */ body { font-family: Verdana, Arial; font-size: 13px; margin: 0px; vertical-align: top; } /* Top header */ div.header { color: #ffffff; padding: 30px 0em 30px 7em; background-color: #666666; text-align: center; vertical-align: middle; font-size: 36px; font-weight: bold; } /* footer */ div.footer { color: #999999; text-align: center; vertical-align: bottom; padding: 1.5em 0em 1.5em 7em; } /* left menu */ div.menu { vertical-align: top; background-color: #666666; float: left; width: 10em; } /* header menu items */ div.menu_header { padding-left: 0.5em; color: #ff0000; font-size: 14px; text-decoration: none; font-weight: bold; line-height: 125%; } /* menu item links */ a { text-decoration: none; } a:hover { text-decoration: underline; } /* menu item links */ a.menu_item { padding-left: 1.0em; color: #ffffff; text-decoration: none; display: block; } a.menu_item:hover { color: #5D90ED; text-decoration: underline; } /* menu item links */ a.header { color: #ffffff; text-decoration: none; } /* menu item links */ a.footer { color: #999999; text-decoration: none; } a.footer:hover { color: #5D90ED; text-decoration: underline; } /* menu item links */ div.current_page { padding-left: 1.0em; color: #ffffff; text-decoration: none; font-weight: bold; display: block; } /* introduction area */ div.paragraph_item { margin-left: 10.5em; } div.paragraph_item > h2:first-child { color: #ff0000; } div.paragraph_item > p { margin-left: 1em; } /* news area */ div.news { margin-left: 10.5em; } div.news > h2:first-child { color: #ff0000; } div.news_item { margin-left: 1em; } /* introduction area */ div.iframe { margin-left: 10em; } /* faq area */ div.faq { margin-left: 10.5em; } div.faq > h2:first-child { color: #ff0000; } div.faq_item { margin-left: 1em; } |