Joal FAQ - Revision history

Xranby: /* What files do I need at Runtime? */

2013-07-14T08:36:34Z

What files do I need at Runtime?

← Older revision		Revision as of 10:36, 14 July 2013
Line 63:		Line 63:

	== What files do I need at Runtime? ==		== What files do I need at Runtime? ==
	JOAL consists of ~~two~~ files:		JOAL consists of four files:
	* joal.jar		* joal.jar and gluegen-rt.jar
	* and one system dependent native jar (e.g joal-natives-linux-i586.jar or ..).		** You only need to include these two jars in to the classpath of your application.
			* and one set of system dependent native jar's (e.g joal-natives-linux-i586.jar and gluegen-rt-natives-linux-i586.jar ..).
			** joal and gluegen-rt expect to find the system dependent native jar's next to the joal.jar and gluegen-rt.jar URL. The native jars will be found automatically at runtime.

	== How do I Get Started? ==		== How do I Get Started? ==

Xranby at 20:55, 13 July 2013

2013-07-13T20:55:29Z

← Older revision		Revision as of 22:55, 13 July 2013
Line 1:		Line 1:
	__TOC__		__TOC__

			== What is the History of JOAL? ==
			* https://jogamp.org/wiki/index.php/Joal_Overview#History

	== What OpenAL platforms / Operating Systems / JDKs are supported? ==		== What OpenAL platforms / Operating Systems / JDKs are supported? ==

Xranby: /* How can I test if OpenAL is properly set up on my system? */

2013-07-13T20:54:13Z

How can I test if OpenAL is properly set up on my system?

← Older revision		Revision as of 22:54, 13 July 2013
Line 70:		Line 70:
	* run some of the [http://jogamp.org/joal-demos/www/ devmaster joal commandline tutorials or webstart demos]		* run some of the [http://jogamp.org/joal-demos/www/ devmaster joal commandline tutorials or webstart demos]
	: '''note1:''' replace ':' with ';' on windows		: '''note1:''' replace ':' with ';' on windows
			** https://jogamp.org/wiki/index.php/Joal_Tutorial

	== Is it possible to run JOAL based app without JOGL? ==		== Is it possible to run JOAL based app without JOGL? ==
	Yes. JOAL is independent from JOGL and can be used without JOGL in the classpath.		Yes. JOAL is independent from JOGL and can be used without JOGL in the classpath.

Xranby: JOAL FAQ created!

2013-07-13T20:53:12Z

JOAL FAQ created!

New page

__TOC__

== What OpenAL platforms / Operating Systems / JDKs are supported? ==
OpenAL Platforms:
* all of them. We are testing every build (in fact every commit) using OpenAL-soft.
* If you are running on a different platform or would like to provide a build server, please let us know.

Operating Systems:
* Linux 32/64, Mac OS, Windows 32/64, Android
* Building JOAL on other systems is easy provided that a OpenAL implementation for that system.
** OpenAL-soft is easily portable to systems where no OpenAL drivers exist.

Java Runtime Environments:
* We are testing on Oracle JDK and OpenJDK
* Java 5+ is required to run JOAL.

== OpenAL on Mobile ARM SoC ==
=== Android ===
JogAmp provide OpenAL bindings using the JOAL .apk files on Android.

Since Android do not support J2SE users may have to implement their own classes to unpack audio formats.
https://jogamp.org/bugzilla/show_bug.cgi?id=684 - Make JOAL Platform Agnostic for non J2SE VMs (Remove use of javax.sound; Replace WaveLoader code, ..)

=== GNU/Linux ===
JogAmp provide OpenAL bindings using the JOAL jar for use on ARM GNU/Linux systems, we support both the soft-float and hard-float ABI.

JogAmp JOAL bundle OpenAL-soft drivers in order to make JOAL usefull out of the box.

== How do I get the Source Code? ==
The project repository is located on [http://jogamp.org/git/?p=joal.git jogamp],

You can create a local copy/branch of the git repository,
either anonymous from jogamp:

* git clone git://jogamp.org/srv/scm/gluegen.git gluegen
* git clone git://jogamp.org/srv/scm/joal.git joal
* git clone git://jogamp.org/srv/scm/joal-demos.git joal-demos

or github, e.g.:
* git clone https://github.com/JogAmp/joal.git joal

.. etc ..

or via SSH and your user credential, so you can easily push back your
changes to the github server:

* git clone git@github.com:username/gluegen.git gluegen
* git clone git@github.com:username/joal.git joal
* git clone git@github.com:username/joal-demos.git joal-demos

== What are the Build Dependencies? ==
JOAL depends on [[GlueGen_Wiki|GlueGen]]

JDK6 and ANT 1.8 or later. JUnit tests require OpenAL capable hardware and OpenAL drivers.

== I have all the Sourcecode, how do I build it? ==
cd joal/make
# Then run the matching build script for your platform
sh scripts/scripts/make.joal.all.linux-x86_64.sh

== What files do I need at Runtime? ==
JOAL consists of two files:
* joal.jar
* and one system dependent native jar (e.g joal-natives-linux-i586.jar or ..).

== How do I Get Started? ==
* [http://jogamp.org/joal-demos/www JOAL Demo Projects]

== How can I test if OpenAL is properly set up on my system? ==
* run some of the [http://jogamp.org/joal-demos/www/ devmaster joal commandline tutorials or webstart demos]
: '''note1:''' replace ':' with ';' on windows

== Is it possible to run JOAL based app without JOGL? ==
Yes. JOAL is independent from JOGL and can be used without JOGL in the classpath.