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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--
/*
* $RCSfile$
*
* Copyright (c) 2006 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$
*/
-->
<meta content="text/html; charset=ISO-8859-1"
http-equiv="content-type">
<title>README-build: build instructions for the j3d-examples project</title>
</head>
<body>
<h3><span style="text-decoration: underline;">Building
the Java 3D Example Programs</span></h3>
<p>To
build the Java 3D example programs, you must first checkout the <a
href="http://j3d-examples.dev.java.net/">j3d-examples</a>
CVS
repository on java.net. For example, run
the cvs checkout command as follows:<br>
</p>
<ul>
<code>cd <cvs-root-dir></code><br>
<code>cvs checkout j3d-examples</code>
</ul>
<p>
</p>
<h3><span style="text-decoration: underline;">System Requirements</span>
</h3>
<p>Any operating environment that supports J2SE and Java 3D should
work.We have built j3d-examples on the following operating environments:<br>
</p>
<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>
<p>The following software must be installed:</p>
<ul>
<li><a href="http://java.sun.com/j2se">JDK 1.4.2</a> </li>
<li><a href="http://jakarta.apache.org/ant">Apache Ant 1.6.1</a> </li>
<li><a href="http://java.sun.com/products/java-media/3D/">Java 3D
1.3.1</a> or later. </li>
</ul>
<h3><span style="text-decoration: underline;">Building
j3d-examples</span><span
style="font-weight: bold; text-decoration: underline;"></span><br>
</h3>
<p>Before you start building, please check that your PATH must
include the
following directories:</p>
<ul>
<li><ant-root-dir>/bin</li>
<li><jdk-root_dir>/bin</li>
</ul>
<p>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 and vecmath jar files (j3dcore.jar, j3dutils.jar and
vecmath.jar) in your CLASSPATH and the directory containing the
Java 3D libraries in your LD_LIBRARY_PATH (Solaris or Linus) or
PATH (Windows).<br>
</p>
<p>To build all examples:</p>
<ul>
<code>cd <cvs-root-dir>/j3d-examples</code><br>
<code>ant</code>
</ul>
<p>
</p>
<p>This will build all example programs, each one being placed in the
corresponding <code>src/<ExampleProgram></code> directory.
You may run
ant from a subdirectory in order to just build that program. For
example, to build the HelloUniverse program:<br>
</p>
<ul>
<code>cd <cvs-root-dir>/j3d-examples/src/HelloUniverse</code><br>
<code>ant</code>
</ul>
<p>
</p>
<h3><span style="text-decoration: underline;">Running j3d-examples</span></h3>
<p>To run an example program, cd to the desired directory and execute
java from there. You must ensure that CLASSPATH is either not set, or
contains "." in its list of directories. For example, to run the
HelloUniverse program:<br>
</p>
<ul>
<code>cd <cvs-root-dir>/j3d-examples/src/HelloUniverse</code><br>
<code>java HelloUniverse<br>
</code>
</ul>
<p>
</p>
<p>You may also point your Java-enabled web browser at the
<code>src/index.html</code> page and run Java 3D example programs
from within your browser. Java 3D must be installed into the JDK
in order to run Java 3D programs from within a browser.<br>
<br>
</p>
</body>
</html>
|
