## 3D Graphics API for the Java Platform 1.5.2-beta1 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 installing the 3D Graphics API for the Java Platform

The 1.5.2-build1 version of the j3d package runs on JDK version 1.5.0 and higher. It has been released for the Windows, Linux, Solaris, and Mac OS X operating environments. See the release notes for more information.

### Preferred method

Developers who wish to develop an application using the j3d package are encouraged to download the j3d-1_5_2-beta1-XXX-i586.zip file for their platform, and manually install the necessary files into a directory on their local disk. To do this, unzip the downloaded file, and follow the instructions in the unzipped README.txt file.

### Alternative method

Alternatively, you can run the installer as shown below, keeping in mind that it is not recommended to install the j3d jar files and native libraries directly into the JRE.

#### Windows

To install the j3d package on Windows, download the binary installer and then execute it, by double-clicking on the j3d-1_5_2-beta1-windows-i586.exe (or j3d-1_5_2-beta1-windows-amd64.exe) icon.

#### Linux or Solaris

To install the j3d package on Linux or Solaris, download the self-extracting binary file, chdir to the desired directory, and then execute it. For example, on a 32-bit Linux system:

cd /myhome/j3d
sh /path-to-download-files/j3d-1_5_2-beta1-linux-i586.bin

After doing this, you will need to 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

Then 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

#### Mac OS X

No installer is available for the Mac OS X operating environment. You will need to download the j3d-1_5_2-beta1-macosx.zip file, unzip it, and follow the instructions in the unzipped README.txt file.