README-build

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

NOTE: 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 pacakge 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, please check that 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".

To see other targets that are available, type "ant -projecthelp". Note that ant must be run from the top-level directory.

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".

SPECIAL: 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 j3d-examples/README-build.html for details building Java 3D example programs.