File: README-Unix

package info (click to toggle)
vrweb 1.5-5.1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 15,124 kB
  • ctags: 27,485
  • sloc: cpp: 134,333; ansic: 95,670; sh: 1,072; asm: 712; makefile: 610; pascal: 536; perl: 347; csh: 26
file content (165 lines) | stat: -rw-r--r-- 5,060 bytes parent folder | download | duplicates (6)
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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165

VRweb 1.5 for UNIX
==================


This is the UNIX/X11 version of the VRweb VRML browser. VRweb is
developed by the Institute for Information Processing and Computer
Supported New Media (IICM) of Graz University of Technology, Austria.

More information can be found at the VRweb home page:
http://www.iicm.edu/vrweb

You should have read the README of the VRweb distribution (ftp parent
directory) first.

The current release (incl. source code) is VRweb 1.5.



Files
-----


a) general information (upgraded to latest info):

README-Unix     ... this file

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

COPYRIGHT       ... copyright notice

LICENCE         ... GNU GENERAL PUBLIC LICENSE, Version 2


b) release specific files in subdir vrweb-1.5:

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

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

SceneViewer.ad.gz    ... documentation of VRweb's Xattributes

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


compressed  uncompr.  vrweb-1.5-          VRweb for ...
   895759   3560360   ogl-Irix5.3         ... SGI IRIX 5.x, OpenGL (HW accelerated)
  1124563   4350888   mesa-Irix5.3        ... SGI IRIX 5.x, Mesa (for remote display)
   991929   3866624   ogl-AlphaOSF1V4.0   ... DEC ALPHA, OpenGL (part of Open3D package)
  1244182   4620288   mesa-AlphaOSF1V4.0  ... DEC ALPHA, Mesa (without OpenGL installed)
  1184962   3821568   mesa-HPUX9.05       ... HPUX 9.0x
  1013504   2736128   mesa-SunOS4.1.3     ... SUN OS 4.x
   970859   2843092   mesa-Solaris5.5     ... SUN Solaris 2.x
   772326   2155684   mesa-LinuxELF2.0.27 ... LINUX ELF
   941917   2330624   mesa-BSDI2.1        ... BSDI 2.1
  1154386   3792771   mesa-IBMAIX4.1      ... IBM AIX 4.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)


An upgrade of harscened, the VRweb 3D Scene Viewer for Harmony (the
Hyperwave Unix client), to version 1.5 is available under the
Hyperwave/updates directory of your nearest Hyperwave mirror.



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

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

  gzip -cd help-1.5.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.



AsciiText
---------

For AsciiText support (labels/strings in 3D space) please download
file fonts.tar.gz and unpack it in ~/.vrweb (which creates a subdir
fonts):

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

See the online help about how to use a different place.
(In case you have downloaded fonts.tar.gz prior to July 16 1996,
please fetch the current version.)



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).

Be aware that some internet tools may strip off the .gz extension
without having uncompressed the file. Check the file size with the
table above, then rename and gunzip the file manually if necessary.

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.3.tar.gz | tar xvf -
All further necessary steps are explained in file INSTALLATION
contained in the archive.


To use VRweb as a helper application with a Web browser, you will need
an entry for VRML files in your ~/.mailcap file:

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 these 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
earlier versions).

With Harmony (the Hyperwave UNIX/X11 client) use the appropriate
version of harscened (for more information on Harmony see
http://www.iicm.edu/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 home page
http://www.iicm.edu/vrweb for instructions.



Michael Pichler
Graz, May 27, 1997