## 3D Graphics API for the Java Platform 1.5.2 Pre-Release

This software is licensed by Sun, as specified in the LICENSE-GPLv2.txt file. You must only use this software in accordance with the terms under which the code is licensed.

## Instructions for Unzipping 3D Graphics API for the Java Platform 1.5.2 Pre-Release

The 1.5.2-XXX pre-release version of 3D graphics API for the Java platform runs on JDK version 1.5.0 and higher. It has been released for the Windows, Linux, Solaris, and Mac OS X operating environments.

NOTE: Installing the j3d jars and native libs into the "ext" directory of the JRE is discouraged, especially on Mac OS X where JOGL is used as the rendering engine. Doing so can cause conflicts with third-party applications launched via Java Web Start, and causes confusion later when upgrading the distribution.

### Windows

The 1.5.2 pre-release version of 3D graphics API for the Java platform for Windows/XP and Windows 2000 runs on JDK version 1.5.0 and higher. To manually install this build, do the following:

1. Download and unzip `j3d-1_5_2-XXX.zip` (using Windows Explorer or an unzip tool such as WinZip) to a temporary download folder, for example, `c:\Downloads`. This will create a `j3d-1_5_2-XXX` subfolder in your download folder where the downloaded files can be found. The file you need for manual installation is `j3d-jre.zip`.
2. Create a folder for the j3d jar files and native libraries, for example, `C:\Users\myhome\j3d`, and unzip `j3d-jre.zip` into this folder.
3. Modify your `CLASSPATH` environment variable to include the full paths to `j3dcore.jar`, `j3dutils.jar`, and `vecmath.jar`. For example, add the following to your `CLASSPATH` variable, using the System control panel, Advanced tab, Environment Variables button:
   `.;C:\Users\myhome\j3d\lib\ext\j3dcore.jar;C:\Users\myhome\j3d\lib\ext\j3dutils.jar;C:\Users\myhome\j3d\lib\ext\vecmath.jar`
4. Modify your `PATH` environment variable to contain the full path to the `lib\i386` folder (or `lib\amd64` for Windows/x64). For example, on 32-bit Windows, add the following to your `PATH` variable, using the System control panel, Advanced tab, Environment Variables button.
   `C:\Users\myhome\j3d\lib\i386`

At this point your Java installation should be able to see the j3d class files. Users of IDEs such as NetBeans and Eclipse should consult the IDE's documentation to see how to add jar files and native libraries to their current project.

### Linux, Solaris

The 1.5.2 pre-release version of 3D graphics API for the Java platform for Linux or Solaris runs on JDK version 1.5.0 and higher. To manually install this build, do the following:

1. Download and unzip `j3d-1_5_2-XXX.zip` into a temporary download directory, for example, `/tmp`. This will create a `j3d-1_5_2-XXX` subdirectory in `/tmp` where the downloaded files can be found. The file you need for manual installation is `j3d-jre.zip`.
2. Create a folder for the j3d jar files and native libraries, for example, `/myhome/j3d`, and unzip `j3d-jre.zip` into this directory as follows:
   `cd /myhome/j3d`
   `unzip /tmp/j3d-1_5_2-*/j3d-jre.zip`
3. Modify your `CLASSPATH` environment variable to include the full paths to `j3dcore.jar`, `j3dutils.jar`, and `vecmath.jar`. For example:
   `export CLASSPATH=.:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar`
4. Modify your `LD_LIBRARY_PATH` environment variable to contain the full path to the `lib/<ARCH>` directory. For example, on 32-bit Linux:
   `export LD_LIBRARY_PATH=/myhome/j3d/lib/i386`

At this point your Java installation should be able to see the j3d class files. Users of IDEs such as NetBeans and Eclipse should consult the IDE's documentation to see how to add jar files and native libraries to their current project.

### Mac OS X

The 1.5.2 pre-release version of 3D graphics API for the Java platform for Mac OS X runs on JDK version 1.5.0 and higher. To manually install this build, do the following:

1. Download and unzip `j3d-1_5_2-XXX.zip` into a temporary download directory, for example, `/tmp`. This will create a `j3d-1_5_2-XXX` subdirectory in `/tmp` where the downloaded files can be found. The file you need for manual installation is `j3d-jre.zip`.
2. Create a folder for the j3d jar files, for example, `/myhome/j3d`, and unzip `j3d-jre.zip` into this directory as follows:
   `cd /myhome/j3d`
   `unzip /tmp/j3d-1_5_2-*/j3d-jre.zip`
3. Modify your `CLASSPATH` environment variable to include the full paths to `j3dcore.jar`, `j3dutils.jar`, and `vecmath.jar`. For example:
   `export CLASSPATH=.:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar`
4. Download a recent version of JOGL for the Mac platform into a temporary download directory, for example, `/tmp`.
5. Create a folder for the jogl jar files and native libraries, for example, `/myhome/jogl`, and unzip `jogl-*.zip` into this directory as follows:
   `cd /myhome/jogl`
   `unzip /tmp/jogl-*.zip`
6. Modify your `CLASSPATH` environment variable to include the full paths to `jogl.jar` and `gluegen-rt.jar`. For example:
   `export CLASSPATH="${CLASSPATH}:/myhome/jogl/lib/jogl.jar:/myhome/jogl/lib/gluegen-rt.jar`
7. Modify your `DYLD_LIBRARY_PATH` environment variable to contain the full path to the `lib` directory. For example:
   `export DYLD_LIBRARY_PATH=/myhome/jogl/lib`

At this point your Java installation should be able to see the j3d and jogl class files. Users of IDEs such as NetBeans and Eclipse should consult the IDE's documentation to see how to add jar files and native libraries to their current project.