diff options
| -rw-r--r-- | www/README.txt | 176 | ||||
| -rw-r--r-- | www/index.html | 17 |
2 files changed, 187 insertions, 6 deletions
diff --git a/www/README.txt b/www/README.txt new file mode 100644 index 0000000..2f16ff6 --- /dev/null +++ b/www/README.txt @@ -0,0 +1,176 @@ +/** +* Copyright (c) 2003 Sun Microsystems, Inc. All Rights Reserved. +* +* Redistribution and use in source and binary forms, with or without +* modification, are permitted provided that the following conditions are met: +* +* -Redistribution of source code must retain the above copyright notice, +* this list of conditions and the following disclaimer. +* +* -Redistribution 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 Sun Microsystems, Inc. or the names of contributors may +* be used to endorse or promote products derived from this software without +* specific prior written permission. +* +* This software is provided "AS IS," without a warranty of any kind. +* ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING +* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR +* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS +* LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A +* RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. +* IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT +* OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR +* PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, +* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS +* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. +* +* You acknowledge that this software is not designed or intended for use in the +* design, construction, operation or maintenance of any nuclear facility. +*/ + +Project: net.java.games.joal.* & net.java.games.sound3d.* +Purpose Open Source Java Bindings for OpenAL and Object-Oriented 3D sound toolkit +Author: + -- JOAL/Sound3D API Original Author + Athomas Goldberg + Wildcard + Java Games Initiative + Software Advanced Technologies Group, + Sun Microsystems + -- This file updated 08/19/2003 by Ole Arndt <ole at sugarshark dot com> + -- This file updated 11/23/2003 by Gregory Pierce <[email protected]> +Introduction: +============= + +This is the source tree for the Java Game Initiative (JGI) Open Source +client game programming APIs for OpenAL and Sound3D. + + +Build Requirements: +=================== + +This project has been built under Win32, Linux, and OSX. The following +packages and tools have been used: + +* All Systems: + -- Sun J2SDK 1.4.2 (available at java.sun.com) + -- ANT 1.5.3 (available at apache.org) + -- JUnit 3.8.1 (available at junit.org) copy junit.jar to the apache-ant lib directory + +* Windows: + -- Win32 (Win XP in the case of our machine) + -- OpenAL1.0 SDK from Creative Labs (available at http://developer.creative.com + under "Gaming -> Development Kits -> Open AL") + -- MinGW 2.0.0 plus the following updates: (all available at www.mingw.org) + -- binutils 2.13.90 + -- w32api-2.2 + -- mingw-runtime-2.4 + +* Linux: + -- Linux i386 (Redhat 9.0) + -- gcc 3.2.2, binutils 2.13.90 + -- OpenAL CVS version from opensource.creative.com (see CVS instructions at + www.openal.org) + +* OSX + -- OSX 10.2 or later + -- OSX Developer Tools + -- OpenAL1.0 SDK from Creative Labs (avaulable at http://developer.creative.com under "Gaming->Development Kits->Open AL") + + +Directory Organization: +======================= + +The root contains a master ANT build.xml and the following sub directories: + + -- apidocs Where the javadocs get built to + -- lib Where the Jar and DLL files get built to + -- src The actual source for the JGI APIs. + -- www JGI project webpage files + + +Preparations: +============= + +* Windows: + Grab the OpenAL SDK from the openal.org downloads and install it. + +* Linux: + OpenAL comes with various Linux distributions. You might have it already. + If not, try rpmfind, apt-get or emerge. + + For the newest version you need to compile OpenAL yourself from CVS: + + -- follow the instruction at www.openal.org to check out a fresh copy + -- in the linux subdir type './autogen.sh + -- look at the build options with ./configure --help + -- configure it with./configure --enable-sdl --enable-vorbis [-enable-more] + (see openal.spec for a full set) + -- build it with make && make test and run the tests + -- as root type make install + -- add /usr/local/lib to you /etc/ld.so.conf and run ldconfig + +* OSX: + Grab the OpenAL SDK from Creative Labs and install it. + +JOAL Build Instructions: +=================== + +Edit the value of the jdk.home property in the root build.xml file to point +to your Java 2 SDK installation (ex: c:/j2sdk1.4.2 ,/opt/j2sdk1.4.2, or /Library/Java/Home) + +Edit the value of the openal.home property in the root build.xml file to point +to your OpenAL SDK installation. For Windows this might be +"c:/program files/creative labs/openal 1.0 sdk". +Under Linux set the property to the toplevel directory of your OpenAL CVS version. +If OpenAl came with your distribution and the header files are in /usr/include/AL, +set the property to '/usr'. Under OSX the default distribution will install to "/Library/Frameworks/OpenAL.framework ". + +To clean: ant clean +To build: ant all (or just ant) +To build docs: ant javadoc +To test: ant runtests + + +Release Info: + Initial Release: This release contains an implementation of the Java + bindings for OpenAL, as well as the Sound3D Object-Oriented toolkit for games. + +Additional Information + This release includes source code adapted from the Lightweight Java Games Library + subject to the following terms and conditions: + + * Copyright (c) 2002 Light Weight 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. + + diff --git a/www/index.html b/www/index.html index 2c8bef6..0417cbc 100644 --- a/www/index.html +++ b/www/index.html @@ -65,8 +65,8 @@ </tr> <tr> <td valign="top" bgcolor="#F8F8F8"><p>This project has been built - under Win32 and Linux. The following packages and tools have - been used:</p> + under Win32, Linux and OSX. The following packages and tools + have been used:</p> <ul> <li>All Systems: <ul> @@ -92,7 +92,7 @@ </li> </ul> </li> - <li> Linux: + <li> Linux: <ul> <li>Linux i386 (Redhat 9.0)</li> <li>gcc 3.2.2, binutils 2.13.90</li> @@ -103,11 +103,16 @@ </li> <li>OSX <ul> - <li> to be ported<br> + <li> OSX 10.2 or later</li> + <li>OSX Developer Tools</li> + <li>OpenAL1.0 SDK (available at <a href="http://developer.creative.com">http://developer.creative.com</a> + under "Gaming -> Development Kits -> OpenAL")<br> </li> </ul> - </li> - </ul></td> + Please refer to <a href="README.txt">README.txt</a> for + additional build information.</li> + </ul> + </td> </tr> </table></td> </tr> |