@@@STARTPACK(vrwave;Interactive 3D Virtual Reality Scene Viewer)

<DL>
<DT><B>Authors</B></DT>

<DL>
<DT>Keith Andrews (kandrews@iicm.edu): VRwave project leader </DT>

<DT>Michael Pichler (mpi@iicm.edu): VRwave X11 lead programmer </DT>
</DL>

<DT><B>Contributed by</B></DT>

<DD>Meredith Whyles (mwhyles@merlyn.net) </DD>

<DD>For more information, visit <A HREF="http://www.merlyn.net/">http://www.merlyn.net/</A>.
</DD>

<DT><B>SCO &quot;Skunkmom&quot; Sponsor</B> </DT>

<DD>Ron Record (rr@sco.com) </DD>

<DT><B>Obtained from</B> </DT>

<DD>ftp://ftp.iicm.edu/pub/VRwave/vrwave-0.9/VRwave-0.9-src.tar.gz </DD>
<DD>ftp://ftp.iicm.edu/pub/VRwave/vrwave-0.9/UNIX/Common-VRwave-0.9-Unix.tar.gz </DD>

<DT><B>Restrictions</B> </DT>

<DD>Refer to the COPYRIGHT and LICENCE files. </DD>

<DT><B>Description</B> </DT>

<DD>VRwave is a freely available browser for 3D worlds and scenes modeled
in VRML 2.0 (the latest version of the Virtual Reality Modeling Language).
It is being developed by the Institute for Information Processing and Computer
Supported New Media (IICM) of Graz University of Technology, Austria, the
team who brought you the VRweb VRML 1.0 browser. Visit <A HREF="http://www.iicm.edu/">http://www.iicm.edu/
</A>for information about the IICM. </DD>
<BR>

<BR>
<DD>VRwave is the only free VRML browser
available in full source code which does not require commercial packages
such as Inventor or Motif and which will run on (almost) any Unix or Windows
platform. For more information on VRwave, visit <A HREF="http://www.iicm.edu/vrwave">http://www.iicm.edu/vrwave
</A>. The new name VRwave is intended to distinguish the VRML 2.0 browser
written largely in Java from VRweb, which was written in C++. In terms
of look and feel, VRwave is a direct successor to VRweb. For more information
about VRweb, visit <A HREF="http://artemis.sco.com/skunkware2/x11/viewers/index.html#vrweb">http://skunkware.dev/skunkware/x11/viewers/
</A>. </DD>

<DT><B>Productivity</B> </DT>

<DD>This program displays VRML 2.0 files for the user to manipulate. When
used with a web browser, such as Netscape or Mosaic, this 3D viewer allows
access to the increasing number of web sites offering virtual reality content
and to the advanced HyperWave servers (formerly known as &quot;Hyper-G&quot;).
HyperWave servers represent the next generation web solution for publishing
rich hypermedia documents in the Internet's World Wide Web and internal
TCP/IP networks. For more information about HyperWave, visit <A HREF="http://www.hyperwave.de/">http://www.hyperwave.de/</A>.
</DD>

<DT><B>Work Planned</B> </DT>

<DD>None </DD>

<DT><B>Documentation</B> </DT>

<DD>Preliminary on-line help for VRwave is included in the archive
&quot;Common-VRwave-0.9-Unix.tar.gz&quot;.  For additional information,
view the VRweb User Guide at <A HREF="http://www.iicm.edu/vrweb/help">
http://www.iicm.edu/vrweb/help
</A>. </DD>

<DT><B>Verification</B> </DT>

<DD>Run &quot;vrwave <I>filename</I> &amp;&quot;
(or &quot;$VRWAVE_HOME/vrwave <I>filename</I> &amp;&quot;),
where <I>filename</I> is any VRML 2.0 file. If VRweb (the C++ predecessor
of VRwave) is executed, it will automatically invoke VRwave when a VRML
2.0 file is encountered. Both VRML 1.0 and VRML 2.0 files have a file suffix
of &quot;.wrl&quot;. </DD>

<DT><B>Known Limitations</B> </DT>

<DD>Currently, VRwave for Unix is unable to process VRML 1.0 files.  For more
information, visit <A HREF="http://hiwaay.net/~crispen/vrml/faq.html#q2">
http://hiwaay.net/~crispen/vrml/faq.html#q2</A>.
</DD>
</DL>

<P>
<HR></P>

<H2>How to get the source</H2>

<P>Visit <A HREF="http://skunkware.dev/skunkware/src/x11/viewers">http://skunkware.dev/skunkware/
</A>or <A HREF="ftp://ftp.sco.com/skunkware/src/x11/viewers">ftp://ftp.sco.com/skunkware/src/x11/viewers
</A>to obtain a copy of the source in gzip format. To create the executable
from the source code (on OpenServer 5.0.4), follow these steps: </P>

<UL>
<LI>Install the &quot;SVR5 based UnixWare release (codenamed Gemini)&quot;
version of the Universal Development Kit (UDK) and Java Development Kit 1.1 (JDK). </LI>

<LI>Obtain (or build) and install the <B>UDK</B> version of the Mesa Graphics
Library (version 2.4), which is available from SCO SkunkWare.  Only the two
primary Mesa libraries (libMesaGL.a and libMesaGLU.a) are required. </LI>

<LI>Use ksh. </LI>

<LI>Ensure that the execution search path includes the directory containing
the UDK C/C++ compilers (e.g., &quot;/udk/usr/ccs/bin&quot;)
<B>BEFORE</B> any other compiler directories (e.g.,
&quot;/usr/bin/&quot; for the SCO Development System compilers). </LI>

<LI>Execute the command: &quot;export CPU=SCO&quot;. </LI>

<LI> Decompress and untar the archive &quot;vrwave-0.9.tar.gz&quot;. </LI>

<LI>See file BUILDING for an installation guide. </LI>

<LI>The unbuilt source directory hierarchy requires about 3 Meg, and the
built hierarchy requires about 5 Meg of disk space. The shared object
is under 1 Meg. </LI>

<LI> Decompress and untar the archive &quot;Common-VRwave-0.9-Unix.tar.gz&quot;. </LI>

<LI>Set environment variable VRWAVE_HOME to the directory which was
created on unpacking the archive (vrwave-0.9). This directory 
contains the vrwave wrapper script, help, icons, etc. </LI>
</UL>

<P>

@@@UW2DIST(http://skunkware.dev/skunkware/java/vrwave/)
@@@OSR5DIST(http://skunkware.dev/skunkware/java/vrwave/)
@@@SOURCE(http://www.iicm.edu/vrwave/release/licence.html)
@@@HOMEPAGE(http://www.iicm.edu/vrwave)
@@@ENDPACK
