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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--
/*
* $RCSfile$
*
* Copyright (c) 2007 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 3D Example Programs</span></h3>
<p>To
build the 3D example programs, you must first checkout the <a
href="http://j3d-examples.dev.java.net/">j3d-examples</a>
svn
repository on java.net. For example, run
the svn checkout command as follows:<br>
</p>
<ul>
<code>cd <j3d-root-dir></code><br>
<code>svn checkout https://j3d-examples.dev.java.net/svn/j3d-examples/trunk j3d-examples</code>
</ul>
<p>
</p>
<h3><span style="text-decoration: underline;">System Requirements</span>
</h3>
<p>Any operating environment that supports the Java Platform and the
Java 3D<sup><font size="-2">TM</font></sup> API 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.5.0</a> </li>
<li><a href="http://jakarta.apache.org/ant">Apache Ant 1.6.1</a> </li>
<li><a href="https://java3d.dev.java.net/">Java 3D
1.5.0</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 <j3d-root-dir>/j3d-examples</code><br>
<code>ant</code>
</ul>
<p>
</p>
<p>This will build all example programs and bundle them into a single
jar
file,<code> j3d-examples.jar</code>, placed in the <code>dist</code>
directory. <br>
</p>
<h3><span style="text-decoration: underline;">Running j3d-examples</span></h3>
<p>To run an example program, you must ensure that your CLASSPATH
contains <code>dist/j3d-examples.jar </code>in its list. For example,
to run the
HelloUniverse program:<br>
</p>
<ul>
<code>cd <j3d-root-dir>/j3d-examples<br>
</code> <code>java
org.jdesktop.j3d.examples.hello_universe.HelloUniverse<br>
</code>
</ul>
<p>
</p>
<p>You may also point your Java-enabled web browser at some Java 3D
applet
examples, such as the <code>src/classes/org/jdesktop/j3d/examples/FourByFour.html</code>
page, and run the Java 3D applet 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>
|
