### Building the 3D Example Programs

To build the 3D example programs, you must first checkout the j3d-examples CVS repository on java.net. For example, run the cvs checkout command as follows:

`cd <cvs-root-dir>`
`cvs checkout j3d-examples`

### System Requirements

Any operating environment that supports the Java Platform and the Java 3DTM API should work. We have built j3d-examples on the following operating environments:

- Solaris: Sparc (Ultra60 or better) running Solaris 9
- Linux: i386/i586 running SuSE 9 or RedHat 9.0
- Windows: Windows/XP (Windows 2000 should work, but is untested)

The following software must be installed:

- JDK 1.5.0
- Apache Ant 1.6.1
- Java 3D 1.5.0 or later.

### Building j3d-examples

Before you start building, please check that your PATH must include the following directories:

- <ant-root-dir>/bin
- <jdk-root_dir>/bin

NOTE that Java 3D must be installed into the JDK that you have in your path OR you must put the Java 3D and vecmath jar files (j3dcore.jar, j3dutils.jar and vecmath.jar) in your CLASSPATH and the directory containing the Java 3D libraries in your LD_LIBRARY_PATH (Solaris or Linus) or PATH (Windows).

To build all examples:

`cd <cvs-root-dir>/j3d-examples`
`ant`

This will build all example programs and bundle them into a single jar file,`j3d-examples.jar`, placed in the `dist` directory.

### Running j3d-examples

To run an example program, you must ensure that your CLASSPATH contains `dist/j3d-examples.jar` in its list. For example, to run the HelloUniverse program:

`cd <cvs-root-dir>/j3d-examples
` `java org.jdesktop.j3d.examples.hello_universe.HelloUniverse
`

You may also point your Java-enabled web browser at some Java 3D applet examples, such as the `src/classes/org/jdesktop/j3d/examples/FourByFour.html` page, and run the Java 3D applet example programs from within your browser. Java 3D must be installed into the JDK in order to run Java 3D programs from within a browser.