
VRweb 1.1 for UNIX
==================

This is the UNIX/X11 version of the VRweb VRML browser. VRweb is a
joint project between IICM, home of Hyper-G, NCSA, home of Mosaic, and
the University of Minnesota, home of Gopher.

More information can be found at the VRweb technical home page:
http://hyperg.iicm.tu-graz.ac.at/vrweb



Files
-----

README-Unix     ... this file

help.tar.gz     ... on-line HELP (HTML files)

FAQ-Unix.gz     ... Frequently Asked Questions about VRweb

COPYRIGHT       ... copyright notice

vrweb-1.1-*     ... VRweb binaries for viewing VRML files
                    in conjunction with your Web client or standalone
                    (see table below about which version to download)

harscened-*     ... VRweb for Harmony
                    Only usable with Harmony, the Hyper-G client for UNIX/X11.

vrweb.src-1.1.tar.gz ... VRweb UNIX source code


  compr.  uncompr. uncompressed_name            VRweb for ...
  864104  3485672  vrweb-1.1s-ogl-Irix5.3       ... SGI IRIX 5.x, OpenGL (HW accelerated) (*)
 1015705  4018168  vrweb-1.1s-mesa-Irix5.3      ... SGI IRIX 5.x, Mesa (for remote display) (*)
  855155  5120000  vrweb-1.1-ogl-AlphaOSF1V3.2  ... DEC ALPHA, OpenGL (part of Open3D package)
  995565  5529600  vrweb-1.1-mesa-AlphaOSF1V3.2 ... DEC ALPHA, Mesa (without OpenGL installed)
  906352  3506176  vrweb-1.1-mesa-HPUX9.05      ... HPUX 9.0x, Mesa (current version)
  835288  2605056  vrweb-1.1-mesa-HPUX9.01      ... HPUX 9.0x, Mesa (if 9.05 is not running)
  693602  2392064  vrweb-1.1-mesa-SunOS4.1.3    ... SUN OS 4.x
  661896  2386508  vrweb-1.1-mesa-Solaris5.4    ... SUN Solaris 2.x
  552649  1904640  vrweb-1.1-mesa-Linux1.2.13   ... LINUX, Mesa
  838259  3428281  vrweb-1.1-mesa-IBMAIX2.3     ... IBM AIX
  793861  2818048  vrweb-1.1-mesa-Ultrix4.4     ... DEC Ultrix

(*)  ... 1.1s for SGI includes spaceball support (thanks to Dave Gosselin
         <drg@spacetec.com>); in all other aspects identical to release 1.1

ogl  ... OpenGL: available for SGI, DEC Alpha;
         requires OpenGL capable machine (test it with xdpyinfo | fgrep GLX)
         xglinfo (see directory ../utils) gives detailed visual info

mesa ... Mesa (via X protocol; for all platforms)



Installing the VRweb Help Pages
-------------------------------

Having downloaded the VRweb Help files, uncompress them the following
way:

  gzip -cd help.tar.gz | tar xvf -

This will create a subdirectory help, which includes the VRweb
Installation Guide as a file called install.html and the VRweb Help
entry page as vrwebhlp.html.

The information below is also contained in the VRweb Help files, so
you may, if you wish, stop reading here, download the hyperlinked help
pages, and browse those instead.



How to use VRweb for UNIX/X11
-----------------------------

The UNIX binaries are compressed with gzip. Run gunzip on the
appropriate version of VRweb and you have an executable. Make sure
that execute permission is set for the file (if necessary using the
command chmod +x).

Download and unpack the Help files as described above.

The *source* code distribution is a gzipped tar archive. You can
uncompress and untar it in one step with the command
  gzip -cd vrweb.src-1.1.tar.gz | tar xvf -
All further necessary steps are explained in file INSTALLATION
contained in the archive.

With your Web viewer you will need an entry for VRML files
in your ~/.mailcap:

a) Netscape:
   x-world/x-vrml; vrweb -URL %u %s

b) Mosaic:
   x-world/x-vrml; vrweb -mosaic %s

In both cases make sure to place the full name of the binary
instead of "vrweb" (e.g. vrweb-ogl on SGI, vrweb-mesa on other
platforms, if you renamed the binary to that shorter name).

VRweb will run gunzip on compressed files automatically if necessary
(this is often done by your Web browser).

With Harmony (the Hyper-G UNIX/X11 client) use the appropriate version
of harscened (for more information on Harmony see
http://hyperg.iicm.tu-graz.ac.at/harmony).

Call any program with argument -h for a short description of
its arguments.



VRweb Mailing List and Feedback
-------------------------------

See the README file in the parent directory or the VRweb technical
home page http://hyperg.iicm.tu-graz.ac.at/vrweb for instructions.



Michael Pichler <mpichler@iicm.tu-graz.ac.at>
Graz, December 11th 1995
