Java 3D 1.1.3 API Install Notes

Print-friendly Version

Java 3D 1.1.3 Requirements

• For Solaris (OpenGL version):
  • Sparc system with a frame buffer that supports OpenGL
    (e.g. Elite3D, Creator3D, Creator, TGX, GX, SX, ZX)
  • Solaris 2.5.1 or later; Solaris 2.6 or later is recommended
  • Java2 SDK 1.2 fcs or later. This can be obtained from the JavaSoft web site. However it is recommended that the Java2 Solaris Production Release SDK 1.2 be used on the Solaris platform. This is available from: http://www.sun.com/software/solaris/java
  • OpenGL 1.1.2 for Solaris or later; OpenGL 1.2 is recommended. OpenGL for Solaris can be obtained at: http://www.sun.com/software/solaris/opengl
  • Note: Solaris users running OpenGL 1.1.2 must install one of the following OpenGL patches, depending on the version of Solaris.
    • Solaris 2.5.1 or Solaris 2.6:
      patch 106735-07 or later
    • Solaris 7 (32-bit mode):
      patch 107104-04 or later
    • Solaris 7 (64-bit mode):
      patch 107105-04 or later
  • SUNWi1of (ISO-8859-1 (Latin-1) Optional Fonts) package
• For Windows (OpenGL version):
  • Windows/NT 4.0 (Service Pack 3), Windows/95 or Windows/98
  • Java2 SDK 1.2 from JavaSoft ( http://java.sun.com/products/jdk/1.2/download-windows.html
  • OpenGL 1.1 from Microsoft or an accelerator which supports OpenGL 1.1. For more information about OpenGL: http://www.opengl.org/

Java 3D 1.1.3 Install instructions:

1. Download the appropiate Java 3D runtime executable from the download page on the java.sun.com web site.

   The downloaded objects are executables.
   On Win32, it's an InstallShield executable;
   On Solaris, it's a self-extracting tar file.

2. Installing on Solaris:

   A. Install the Java 3D Runtime environment and examples for the JDK:

   1. cd $installdir/jdk1.2
   2. chmod +x $downloaddir/java3d1_1_3-solsparc.bin
   3. $downloaddir/java3d1_1_3-solsparc.bin

   where $installdir is the directory where JDK1.2 was extracted, and $downloaddir is the directory into which you downloaded the .bin file.

   IMPORTANT: If you do not "cd" to the jdk1.2 directory before extracting the J3D Runtime files, then Java 3D programs will not work correctly.

   You may remove the java3d1_1_3-solsparc.bin file after you are done extracting it.

3. Installing on Windows

   Choose one or both of the following options depending on whether you downloaded the Java 3D Runtime and Examples for the JDK or the Java 3D Runtime for the JRE.

   A. Install the Java 3D Runtime environment and examples for the JDK:

   • Run the executable by double-clicking on the
     java3d1_1_3-win-opengl_sdk.exe

   Java 3D should be installed in the same place as JDK1.2. By default, this should be "c:\jdk1.2.2".

   You may remove the java3d1_1_3-win-opengl_sdk.exe file after you are done extracting it.

   - OR -

   B. Install the Java 3D Runtime environment for the JRE:

   • Run the executable by double-clicking on the
     java3d1_1_3-win-opengl-rt.exe

   Java 3D should be installed in the same place as the JRE. By default, this should be "c:\Program Files\JavaSoft\Jre\1.2".

   You may remove the java3d1_1_3-win-opengl-rt.exe file after you are done extracting it.

   NOTE: The Java2 SDK 1.2 installs Java into both the JDK location (c:\jdk1.2.2 by default) and into the JRE location (C:\Program Files\JavaSoft\Jre\1.2 by default). Additionally, a shortcut to java.exe is installed in the WINNT/System32 (for NT systems) or Windows/System (for Windows 95 & 98) directory. Developers need to be aware of this when working with the Java2 1.2 SDK. Unless the path to the 1.2 SDK bin directory is placed in the PATH environment variable ahead of the system directory, the SDK java.exe will not be executed. If any extensions (such as Java 3D) are only installed into the SDK and not the JRE as well, then these extensions will not be found during program execution.

4. After Java 3D is installed

   Once the release has been extracted, the documentation for Java 3D may be downloaded/extracted.

   Read the README file for instructions on how to do this.

5. Setting CLASSPATH

   If Java 3D is installed into the JDK or JRE, you do not need to include the Java 3D jar files in your CLASSPATH, nor do you need to include the Java 3D shared libraries in your PATH or LD_LIBRARY_PATH. You should include "." in your CLASSPATH or ensure that CLASSPATH is not set.