What if the JMARS 3D layer doesn't work

If you are using the JMARS 3.0.0 or newer the following does not apply.

The following will help you get the JMARS 3D layer working on your computer if it is not functioning.

The instructions, however, are definitely technical and if you are not comfortable with executing them, or you do not have administrative access to your computer, then locate your system administrator and give the instructions to him or her.


Ubuntu 32 and 64-bit

The following directions originated from https://help.ubuntu.com/community/Java3dUbuntu and have been updated for this application.

Download Java 3d from this url:

For 32-bit: http://download.java.net/media/java3d/builds/release/1.5.2/j3d-1_5_2-linux-i586.zip

For 64-bit: http://download.java.net/media/java3d/builds/release/1.5.2/j3d-1_5_2-linux-amd64.zip

Download and unzip j3d-1_5_2-XXX.zip into a temporary download directory, for example, /tmp.

      cd /tmp

      unzip j3d-1_5_2-XXX.zip

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-1_5_2-XXX/j3d-jre.zip.

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

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

Modify your LD_LIBRARY_PATH environment variable to contain the full path to the lib/XXX 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.

The Ubuntu /lib also needs to be filled with:

     libj3dcore-ogl-cg.so (32 bit only)  or  libj3dcore-ogl.so (32 bit and 64 bit)

These files are located at <extracted path>/lib/XXX/*.

For example: <extracted path>/lib/i386/*

Use following code to copy:

     $> sudo cp /myhome/j3d/lib/XXX/* /lib/

For example: $> sudo cp /myhome/j3d/lib/i386/* /lib/


Linux or Solaris 32 and 64-bit

To install the Java 3D API on Linux or Solaris, download the self-extracting binary file from:

For 32-bit: http://download.java.net/media/java3d/builds/release/1.5.2/j3d-1_5_2-linux-i586.bin

For 64-bit: http://download.java.net/media/java3d/builds/release/1.5.2/j3d-1_5_2-linux-amd64.bin

Then chdir to the download directory and execute it. For example:

     cd /myhome/j3d

     sh /path-to-download-files/j3d-1_5_2-linux-XXX.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/XXX directory. For example, on 32-bit Linux:

     export LD_LIBRARY_PATH=/myhome/j3d/lib/i386


Windows 32-bit

To install the Java 3D API on Windows, download the binary installer from:

For Windows XP: http://download.java.net/media/java3d/builds/release/1.3.1/java3d-1_3_1-windows-i586-directx-rt.exe

For Windows 7/Vista: http://download.java.net/media/java3d/builds/release/1.5.2/j3d-1_5_2-windows-i586.exe

Then execute it by double-clicking on the .exe file from the download location.


Windows 64-bit

Currently the Java3d package does not work correctly with JMARS.