VRweb 1.1.2e 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.html.gz .. Frequently Asked Questions about VRweb

COPYRIGHT       ... copyright notice

vrweb-1.1.2e-*  ... 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.2e.tar.gz ... VRweb UNIX source code


 compr.  uncompr. uncompressed_name               VRweb for ...
 908695  3759528  vrweb-1.1.2e-ogl-Irix5.3        ... SGI IRIX 5.x, OpenGL (HW accelerated)
1085839  4394408  vrweb-1.1.2e-mesa-Irix5.3       ... SGI IRIX 5.x, Mesa (for remote display)
 900112  5439488  vrweb-1.1.2e-ogl-AlphaOSF1V3.2  ... DEC ALPHA, OpenGL (part of Open3D package)
1095944  5996544  vrweb-1.1.2e-mesa-AlphaOSF1V3.2 ... DEC ALPHA, Mesa (without OpenGL installed)
1000818  3862528  vrweb-1.1.2e-mesa-HPUX9.05      ... HPUX 9.0x, Mesa
 818689  2703360  vrweb-1.1.2e-mesa-SunOS4.1.3    ... SUN OS 4.x
 741937  2686092  vrweb-1.1.2e-mesa-Solaris5.4    ... SUN Solaris 2.x
 625486  2166784  vrweb-1.1.2e-mesa-Linux1.2.13   ... LINUX, Mesa
 875758  3137536  vrweb-1.1.2e-mesa-Ultrix4.4     ... DEC Ultrix
 880188  2855502  vrweb-1.1.2e-mesa-IBMAIX4.1     ... IBM AIX


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.2e.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' -remote %s

b) Mosaic:
  x-world/x-vrml; vrweb -mosaic -remote %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).

Omit "-remote" to start a new instance for every new scene (like in
previous versions).

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 <[email protected]>
Graz, March 13th 1996