summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorathomas <[email protected]>2003-11-23 19:17:44 +0000
committerathomas <[email protected]>2003-11-23 19:17:44 +0000
commit9d9bdb76b4a201256332d5cef70a08fae91f34e2 (patch)
tree62a08d2c9d45fbdab15839a08874e7c87e17c707
parenta3fb1a694926bc8a3e500f3621e2fb04cb479e85 (diff)
updated home page with OSX information
git-svn-id: file:///home/mbien/NetBeansProjects/JOGAMP/joal-sync/git-svn/../svn-server-sync/joal/trunk@77 03bf7f67-59de-4072-a415-9a990d468a3f
-rw-r--r--www/README.txt176
-rw-r--r--www/index.html17
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 &quot;Gaming -&gt; Development Kits -&gt; OpenAL&quot;)<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>