summaryrefslogtreecommitdiffstats
path: root/README-build.html
blob: 5a2c3e8cbee272c88eb8dfc4efc0e934135f89d8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<!--
/*
 * $RCSfile$
 *
 * Copyright (c) 2004 Sun Microsystems, Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistribution of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 *
 * - Redistribution in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in
 *   the documentation and/or other materials provided with the
 *   distribution.
 *
 * Neither the name of Sun Microsystems, Inc. or the names of
 * contributors may be used to endorse or promote products derived
 * from this software without specific prior written permission.
 *
 * This software is provided "AS IS," without a warranty of any
 * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
 * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
 * EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
 * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
 * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
 * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
 * ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
 * CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
 * REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
 * INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGES.
 *
 * You acknowledge that this software is not designed, licensed or
 * intended for use in the design, construction, operation or
 * maintenance of any nuclear facility.
 *
 * $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 examples&nbsp; programs<br>
<br>
</span>To build the Java 3D examples programs, you must first download
the j3d-examples
CVS repository:<span
 style="font-weight: bold; text-decoration: underline;"><br>
<br>
System Requirements<br>
<br>
</span>Any operating environment that supports J2SE and Java 3D should
work.We have built j3d-examples on the following operating environments:<br>
<ul>
  <li>Solaris: Sparc (Ultra60 or better) running Solaris 9</li>
  <li>Linux: i386/i586 running SuSE 9 or RedHat 9.0</li>
  <li>Windows: Windows/XP (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><a href="http://java.sun.com/products/java-media/3D/">Java 3D
1.3.1</a> or later.<br>
  </li>
</ul>
<span style="font-weight: bold; text-decoration: underline;">Building
j3d-examples<br>
<br>
</span> 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>
<br>
NOTE that Java 3D must be installed into the JDK that you have in your
path <span style="font-weight: bold;">OR</span> you must put the Java
3D &amp; vecmath jar files in your CLASSPATH and the Java 3D libraries
in your LD_LIBRARY_PATH.<br>
<br>
To build all examples:<br>
<br>
&nbsp;&nbsp;&nbsp; cd &lt;java3d-root&gt;/j3d-examples<br>
&nbsp;&nbsp;&nbsp; ant<br>
<br>
This will build all example programs, each one being placed in the
corresponding src/&lt;ExampleProgram&gt; directory.&nbsp; You may run
ant from a subdirectory in order to just build that program. For
example, to<br>
build the HelloUniverse program:<br>
<br>
&nbsp;&nbsp;&nbsp; cd &lt;java3d-root&gt;/j3d-examples/src/HelloUniverse<br>
&nbsp;&nbsp;&nbsp; ant<br>
<br>
</body>
</html>