Instructions for Unzipping the Java 3D 1.5.2 Release

The 1.5.2 version of the Java 3DTM API 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 release of the Java 3D API for Windows 2000, Windows XP (x86 or amd64), and Windows Vista runs on JDK version 1.5.0 and higher. To manually install this release, 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 release of the Java 3D API for Linux or Solaris runs on JDK version 1.5.0 and higher. To manually install this release, 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:


  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 release of the Java 3D API for Mac OS X runs on JDK version 1.5.0 and higher. To manually install this release, 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:


  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:


  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.