From 9d9bdb76b4a201256332d5cef70a08fae91f34e2 Mon Sep 17 00:00:00 2001 From: athomas Date: Sun, 23 Nov 2003 19:17:44 +0000 Subject: 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 --- www/README.txt | 176 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ www/index.html | 17 ++++-- 2 files changed, 187 insertions(+), 6 deletions(-) create mode 100644 www/README.txt (limited to 'www') 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 + -- This file updated 11/23/2003 by Gregory Pierce +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 @@

This project has been built - under Win32 and Linux. The following packages and tools have - been used:

+ under Win32, Linux and OSX. The following packages and tools + have been used:

  • All Systems:
      @@ -92,7 +92,7 @@
    • -
  • Linux: +
  • Linux:
    • Linux i386 (Redhat 9.0)
    • gcc 3.2.2, binutils 2.13.90
      • @@ -103,11 +103,16 @@
    • OSX
        -
      • to be ported
        +
      • OSX 10.2 or later
        • +
      • OSX Developer Tools
        • +
      • OpenAL1.0 SDK (available at http://developer.creative.com + under "Gaming -> Development Kits -> OpenAL")
      -
      • -
    + Please refer to README.txt for + additional build information.
    • +
+ -- cgit v1.2.3