de0340b166
Added the possibility to change renderer. Added JOGL. Changed the brightness icon and some skins. Added per-screen icons on statusbar. Added the SURD-DECIMAL mode icon on the statusbar.
190 lines
7.3 KiB
Plaintext
190 lines
7.3 KiB
Plaintext
/**
|
|
* 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: com.jogamp.openal.* & com.jogamp.openal.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 <gpierce@gregorypierce.com>
|
|
-- This file updated 12/21/2005 by Kenneth Russell <kbr@dev.java.net>
|
|
|
|
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)
|
|
|
|
-- OpenAL Soft: OpenAL: ALSA, OSS, PulseAudio, WaveFile, Null
|
|
|
|
apt-get install cmake autoconf \
|
|
libpulse-dev libpulse0:amd64 libpulse0:i386 pulseaudio \
|
|
libasound2-dev libasound2:amd64 libasound2:i386
|
|
|
|
* 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")
|
|
|
|
JOAL requires the GlueGen workspace to be checked out as a sibling
|
|
directory to the joal directory ("cvs co gluegen"). GlueGen will be
|
|
built automatially during the JOAL build process.
|
|
|
|
Directory Organization:
|
|
=======================
|
|
|
|
-- make Build-related files and the main build.xml
|
|
-- src The actual source for the JOAL APIs.
|
|
-- build (generated directory) Where the Jar and DLL files get built to
|
|
-- javadoc_public (generated directory) Where the public Javadoc gets built to
|
|
-- unit_tests A couple of small tests
|
|
-- www JOAL 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.
|
|
|
|
More up-to-date versions are available from openal.org in the
|
|
downloads section. Install first the openal-[version].i586.rpm and
|
|
then the openal-devel-[version]-i586.rpm. Unfortunately, due to
|
|
confusion in the OpenAL version numbering, the version from
|
|
openal.org may seem to be "older" than the version preinstalled on
|
|
the Linux distribution, even though it is more recent. To work
|
|
around this problem, do the following steps:
|
|
|
|
# rpm --force --upgrade openal-0.0.8-1.i586.rpm
|
|
# rpm -i openal-devel-0.0.8-1.i586.rpm
|
|
|
|
Now test to make sure the RPMs are installed:
|
|
|
|
# rpm -qa | grep -i openal
|
|
openal-0.0.8-1
|
|
openal-devel-0.0.8-1
|
|
|
|
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 openal.org and install it.
|
|
|
|
|
|
GIT
|
|
====
|
|
|
|
JOAL can be build w/ openal-soft, which is a git submodule of JOAL.
|
|
This is the default for our JogAmp build.
|
|
|
|
Cloning [and pulling] JOAL incl. openal-soft
|
|
can be performed w/ the option '--recurse-submodules'.
|
|
|
|
git clone --recurse-submodules git://jogamp.org/srv/scm/joal.git
|
|
cd joal ; git pull --recurse-submodules
|
|
|
|
JOAL Build Instructions:
|
|
===================
|
|
|
|
Download the current ANTLR jar file (http://www.antlr.org/).
|
|
|
|
Copy the gluegen.properties file from the make/ subdirectory of the
|
|
GlueGen workspace into your home directory, or in particular where the
|
|
Java system property user.home points to (on Windows, this is
|
|
C:\Documents and Settings\username\). Edit the value of the antlr.jar
|
|
property this file to point to the full path of the ANTLR jar. ANTLR
|
|
is used during the glue code generation process.
|
|
|
|
Copy the joal.properties file from the make/ subdirectory into your
|
|
home directory, or in particular where the Java system property
|
|
user.home points to (on Windows, this is C:\Documents and
|
|
Settings\username\).
|
|
On Windows, you may want to edit the win32.c.compiler property to
|
|
indicate the C compiler you prefer to use (vc6, vc7 or mingw).
|
|
|
|
On OS X, you can produce 'fat' dual PowerPC/x86 binaries on an
|
|
appropriately-equipped machine by uncommenting the declaration of the
|
|
'macosxfat' property.
|
|
|
|
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.
|