

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


  compr.  uncompr. uncompressed_name              VRweb for ...
  870973  3571688  vrweb-1.1.2-ogl-Irix5.3        ... SGI IRIX 5.x, OpenGL (HW accelerated)
 1033485  4141032  vrweb-1.1.2-mesa-Irix5.3       ... SGI IRIX 5.x, Mesa (for remote display)
  861672  5218304  vrweb-1.1.2-ogl-AlphaOSF1V3.2  ... DEC ALPHA, OpenGL (part of Open3D package)
 1042668  5718016  vrweb-1.1.2-mesa-AlphaOSF1V3.2 ... DEC ALPHA, Mesa (without OpenGL installed)
  950124  3653632  vrweb-1.1.2-mesa-HPUX9.05      ... HPUX 9.0x, Mesa
  781931  2564096  vrweb-1.1.2-mesa-SunOS4.1.3    ... SUN OS 4.x
  700438  2534040  vrweb-1.1.2-mesa-Solaris5.4    ... SUN Solaris 2.x
  589294  2035712  vrweb-1.1.2-mesa-Linux1.2.13   ... LINUX, Mesa
  837023  2973696  vrweb-1.1.2-mesa-Ultrix4.4     ... DEC Ultrix
  936098  3835044  vrweb-1.1-mesa-IBMAIX2.3       ... IBM AIX (still 1.1; 1.1.2 soon available)


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.2.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 <mpichler@iicm.tu-graz.ac.at>
Graz, February 6th 1996
