Building the Java 3D Packages

To build the Java 3D packages, you must have the following three CVS repositories:

• j3d-core
  
• j3d-core-utils
  
• vecmath
  

These three top-level directories must be named exactly as shown above and they must be sibling directories.

NOTE: you must first build the javax.vecmath package before building the Java 3D core and utilities packages. See the README-build.html file in the "vecmath" directory for instructions.

System Requirements

The following operating environments have been tested:

• Solaris: Sparc (Ultra60 or better) running Solaris 9 with Forte C compiler version 6.2 or GNU gcc version 3.3.2
• Linux: i386/i586 running SuSE 9 or RedHat 9.0
• Windows: Windows/XP with Microsoft Visual C++ 6.0 or the gcc that comes with MinGW version 3.1.0-1 (Windows 2000 should work, but is untested)
  

The following software must be installed:

• JDK 1.4.2
  
• Apache Ant 1.6.1
  
• C Compiler (Either one of the following depending on the platform)
  
• Solaris:
  
• Sun ONE Studio 8 (formerly Forte Tools)'s Compiler or GNU Compiler Collection, GCC version 3.3.2
  
• Linux:
  
• GNU Compiler Collection, GCC version 3.2.2
  
• Windows
  
• Microsoft Visual C++ 6.0 or later or GNU Compiler Collection, GCC version 3.2.3 that comes with MinGW version 3.1.0-1
  

Building Java 3D

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

• <ant-root-dir>/bin
  
• <jdk-root-dir>/bin
  
• <compiler-root-dir>/bin
  

The default target, jar-opt, creates an optimized jar files and native libraries.

Steps:

cd <java3d-root-dir>/j3d-core
ant

The above steps build both the Java and native code for javax.media.j3d and com.sun.j3d.* packages.

The build will be placed in j3d-core/build/<platform>/opt where <platform> is determined from the ant echo command:

ant echo

The default compiler for native code compilation is set to "gcc". This value is set in the build.properties file located in the j3d-core directory. The compiler property is "build.comp".

On a Solaris platform with Forte compiler installed, build.comp can be set to "forte". On a Windows platform installed Visual C++, build.properties can be set to "vc".

NOTE: For Windows platform only, the property "build.rend" in build.properties can be modified to use "d3d" (Direct3D API for rendering) besides the default value "ogl".

NOTE: You can also modify the properties through ant property command options e.g. "ant -Dbuild.comp=forte"

Running Java 3D

To run Java 3D, please refer to README-build.html in j3d-examples for details building Java 3D example programs.