aboutsummaryrefslogtreecommitdiffstats
path: root/README-build.html
diff options
context:
space:
mode:
authorKevin Rushforth <[email protected]>2004-06-09 04:25:41 +0000
committerKevin Rushforth <[email protected]>2004-06-09 04:25:41 +0000
commit343b658c32a6473c545187c1e276ee5d06c2686a (patch)
treead2606538b7db1c3553c53a79ccccb2ed5b5e4e2 /README-build.html
parent06cebb1e576da6f7222f999ab059dcfa3d8edd39 (diff)
Initial creation of j3d-core-utils sources in CVS repository
git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@7 ba19aa83-45c5-6ac9-afd3-db810772062c
Diffstat (limited to 'README-build.html')
-rw-r--r--README-build.html147
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>
+ &nbsp;&nbsp;&nbsp; j3d-core<br>
+ &nbsp;&nbsp;&nbsp; j3d-core-utils<br>
+ &nbsp;&nbsp;&nbsp; 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.&nbsp; 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&nbsp;</a> <br>
+ </li>
+ <li><a href="http://jakarta.apache.org/ant">Apache Ant 1.6.1&nbsp;</a>
+ <br>
+ </li>
+ <li>C Compiler (Either one of the following depending on the platform)&nbsp;&nbsp;&nbsp;&nbsp;</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>&nbsp; <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>
+ &nbsp;&nbsp;&nbsp; .&nbsp;&nbsp;&nbsp; &lt;ant-root-dir&gt;/bin<br>
+ &nbsp;&nbsp;&nbsp; .&nbsp;&nbsp;&nbsp; &lt;jdk-root_dir&gt;/bin<br>
+ &nbsp;&nbsp;&nbsp; .&nbsp;&nbsp;&nbsp; &lt;compiler-root-dir&gt;/bin<br>
+ <br>
+ The default target, jar-opt, creates an optimized jar files&nbsp; and native
+libraries.<br>
+ <br>
+ Steps:<br>
+ <br>
+ &nbsp;&nbsp;&nbsp; cd &lt;java3d-root-dir&gt;/j3d-core<br>
+ &nbsp;&nbsp;&nbsp; ant<br>
+ <br>
+ The above steps build both the Java and native code for javax.media.j3d and
+com.sun.j3d.* packages.&nbsp; <br>
+ <br>
+ The build will be placed in j3d-core/build/&lt;platform&gt;/opt where &lt;platform&gt;
+is determined from the ant echo command:<br>
+ "ant echo".<br>
+ <br>
+ To see other targets that are available, type "ant -projecthelp".&nbsp; 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,&nbsp; 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>