diff options
Diffstat (limited to 'README-build.html')
| -rw-r--r-- | README-build.html | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/README-build.html b/README-build.html new file mode 100644 index 0000000..09eedad --- /dev/null +++ b/README-build.html @@ -0,0 +1,147 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> + +<!-- +/* + * $RCSfile$ + * + * Copyright (c) 2004 Sun Microsystems, Inc. All rights reserved. + * + * Use is subject to license terms. + * + * $Revision$ + * $Date$ + * $State$ + */ + --> + +<html> +<head> + + <meta content="text/html; charset=ISO-8859-1" + http-equiv="content-type"> + <title>README-build</title> +</head> + <body> + <span style="font-weight: bold; text-decoration: underline;">Building the +Java 3D Packages<br> + <br> + </span>To build the Java 3D packages, you must have the following three CVS<br> + repositories:<br> + <br> + j3d-core<br> + j3d-core-utils<br> + vecmath<br> + <br> + NOTE: these three top-level directories must be named exactly as shown<br> + above and they must be sibling directories.<br> + <br> + NOTE: you must first build the javax.vecmath pacakge before building<br> + the Java 3D core and utilities packages. See the <a + href="../vecmath/README-build.html">README-build.html</a><br> + file in the "vecmath" directory for instructions.<br> + <span style="font-weight: bold; text-decoration: underline;"><br> + <br> + System Requirements<br> + <br> + </span>The following operating environments have been tested:<br> + +<ul> + <li>Solaris: Sparc (Ultra60 or better) running Solaris 9 with Forte C compiler +version 6.2 or GNU gcc version 3.3.2</li> + <li>Linux: i386/i586 running SuSE 9 or RedHat 9.0</li> + <li>Windows: Windows/XP with Microsoft Visual C++ 6.0 or the gcc that comes +with <a href="http://www.mingw.org">MinGW version 3.1.0-1</a> (Windows 2000 +should work, but is untested)<br> + </li> + +</ul> + The following software must be installed:<br> + +<ul> + <li><a href="http://java.sun.com/j2se">JDK 1.4.2 </a> <br> + </li> + <li><a href="http://jakarta.apache.org/ant">Apache Ant 1.6.1 </a> + <br> + </li> + <li>C Compiler (Either one of the following depending on the platform) </li> + +</ul> + +<div style="margin-left: 40px;">- Solaris <br> + Sun ONE Studio 8 (formerly Forte Tools)'s Compiler or GNU Compiler Collection, +<a href="http://gcc.gnu.org">GCC version 3.3.2</a> <br> + <br> + </div> + +<div style="margin-left: 40px;">- Linux<br> + GNU Compiler Collection, <a href="http://gcc.gnu.org">GCC version 3.2.2</a> +<br> + </div> + <br> + +<div style="margin-left: 40px;">- Windows<br> + </div> + +<div style="margin-left: 40px;">Microsoft Visual C++ 6.0 or later or GNU Compiler +Collection, GCC version 3.2.3 that comes with<br> + </div> + +<div style="margin-left: 40px;"><a href="http://www.mingw.org">MinGW version +3.1.0-1</a> <br> + </div> + <br> + <br> + <span style="font-weight: bold; text-decoration: underline;">Building Java +3D</span><br> + Before you start building, please check that your PATH must include the following +directories:<br> + . <ant-root-dir>/bin<br> + . <jdk-root_dir>/bin<br> + . <compiler-root-dir>/bin<br> + <br> + The default target, jar-opt, creates an optimized jar files and native +libraries.<br> + <br> + Steps:<br> + <br> + cd <java3d-root-dir>/j3d-core<br> + ant<br> + <br> + The above steps build both the Java and native code for javax.media.j3d and +com.sun.j3d.* packages. <br> + <br> + The build will be placed in j3d-core/build/<platform>/opt where <platform> +is determined from the ant echo command:<br> + "ant echo".<br> + <br> + To see other targets that are available, type "ant -projecthelp". Note +that ant must be run from the top-level directory.<br> + <br> + The default compiler for native code compilation is set to "gcc". This value +is set in the <a href="build.properties">build.properties</a> file located +in the j3d-core directory. The compiler property is "build.comp".<br> + <br> + 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".<br> + <br> + 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".<br> + <br> + NOTE: You can also modify the properties through ant property command options +e.g. "ant -Dbuild.comp=forte"<br> + <br> + <br> + <span style="font-weight: bold; text-decoration: underline;">Running Java +3D</span><br> + <br> + To run Java 3D, please refer to j3d-examples/<a + href="../j3d-examples/README-build.html">README-build.html</a> for details +building Java 3D example programs. <br> + <br> + <br> + <br> + <br> +</body> +</html> |