How To Install and Compile Xj3D

Required Libs | PATH/CLASSPATH | Building Xj3D |


What is Xj3D

Xj3D is an example implementation for the X3D and VRML specifications.

This page is intended to help users install the unix edition. If you are a windows user and wish an autoinstaller you can find it here.


Install Xj3D

Install Xj3D into the directory of your choice(examples use /home/Xj3D) using the tar command: tar xvzf Xj3D-M6-unix.tar.gz

Setting up your environment

You must have Java and Java3D installed. Xj3D requires a JDK version >= 1.2.1 and Java3D version >= 1.3. Get these from Sun or alternates like Blackdown for Linux Java3D.

There are several jars required to run Xj3D. We have seperated the jars into logical packages to facilitate repacking the components as your project needs. Each jar must have a seperate entry in your classpath. A sample bashrc which has the proper environment setup is provided here

Running the Example Programs

There are two commons ways to use Xj3D; either as a stand-alone project to run X3D/VRML content, or inside your own application. To run X3D/VRML content in standalone mode we recommend either the apps/browser or examples/DIYBrowser projects. The apps/browser directory contains the start of a full fledged browser. The examples/DIYBrowser is a simple example to show how to create standalone players. To load X3D/VRML content into your Java3D applications look at examples/loader. This uses Java3D's loader interface to read X3D/VRML geometry. It has a several restrictions because of X3D/Java3D loader mismatches. See the loader Javadoc for more details.

At this point you might want to look at the "How to Use Xj3D Tutorial" to see how you can use Xj3d in your projects.

Last Revised: $Date: 2008/10/12 04:05:34 $