File: README

package info (click to toggle)
vreng 1.6.3-3
  • links: PTS
  • area: main
  • in suites: potato
  • size: 2,400 kB
  • ctags: 3,097
  • sloc: ansic: 15,988; sh: 1,845; perl: 1,330; makefile: 59
file content (137 lines) | stat: -rw-r--r-- 4,119 bytes parent folder | download
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
WHAT IS VRENG ?
---------------
VReng (Virtual Reality Engine) is a distributed 3D application
allowing navigation in virtual worlds connected over the Internet
using Multicast technology.

PREREQUISITS
------------
Your machine and your network must support IP Multicast.
You need the X-Window System (X11R5 or X11R6).
Your screen must have a color depth of 8 or 16.

Eventually you need the classical MBone tools like vat, vic and wb
which are used by VReng as external applications and netscape or mMosaic.

To improve performances VReng uses threads library POSIX compatible,
but if your system doesn't support this feature you can compile
without the -DWITHTHREAD flag (see Makefile).

SUPPORTED PLATFORMS
-------------------
	- solaris2.x
	- sunos4.1.x
	- linux-intel
	- linux-sparc
	- netbsd1.2-sparc

VReng has not been ported on other platforms yet, but any
port will be welcome.

DOWNLOADING
-----------
The VReng sources are available at URL
ftp://ftp.enst.fr/pub/mbone/vreng/vreng.tar.gz

COMPILING
---------

VReng uses an OpenGL emulation library. The configure script will
usually figure out which one is installed on your system. There are
basically three possibilities:

- Your system already has a commercial OpenGL library installed.

- You want to use the Mesa free OpenGL emulation library. You can
retrieve it from: http://www.ssec.wisc.edu/~brianp/Mesa.html.

- You want to use TinyGL, which is the fastest software OpenGL emulation
library for vreng. You can get it from
http://www.enst.fr/~bellard/TinyGL.html . 

If your OpenGL library is not visible through the standard paths, you
can use the configure option: --with-GL-prefix=DIR. DIR must be an
absolute path. You can force the use of a given OpenGL library with
the options --with-lib-xxxxGL. Launch 'configure --help' to have more
options.

In general, to compile vreng, you first type

	configure

and then

	make

INSTALLING
----------
The vreng executable will be installed by default in /usr/local/bin.
To do this, type:

	make install
or
	make install-strip

You must also install the sdr plugin in your ~/.sdr/plugins directory

CONFIGURING
-----------
After installing the sdr plugin, you can use sdr to launch vreng
clicking on the media "games".
Vreng will retreive automatically world description by http from the URL:
http://www.inf.enst.fr/vreng/

To add your pictural representation, build a gif of your face
of size 256x256 pixel (using xv), put it in the directory

	~/public.html/vreng/yourfrontface.gif

and update your .Xdefaults with something like:

	vreng.skinf: http://www.yoursite/~yourlogin/vreng/yourfrontbody.gif
	vreng.skinb: http://www.yoursite/~yourlogin/vreng/yourbackbody.gif

and do a xrdb -load ~/.Xdefaults

HOW TO NAVIGATE ?
-----------------
Use the arrow keys on your keyboard. There are 6 spatial degrees of freedom:
	- key_up to go straight on
	- key_down to move back
	- key_right to turn on your right
	- key_left to turn on your left
	- key_pageup to look up
	- key_pagedown to look down
plus
	- key_home to look forward
	- key_end to accelerate
	- key_insert to rise up
	- key_delete to land on the ground

To identify objects, click on the button1 of the mouse, the name
of the pointed object will appear, maybe with a pushdown menu containing buttons
to activate an action on this object (for example open/close for a door).


AUTHORS
-------
Fabrice Bellard <bellard@email.enst.fr> : 3D rendering
Stephane Belmon <belmon@email.enst.fr> : network interface
Samuel Orzan <orzan@email.enst.fr> : world management
Lionel Ulmer <ulmer@email.enst.fr> : the GUI under X11
Philippe Dax <dax@inf.enst.fr> : project manager

CONTACTS
--------
VReng has been written by a group of students who are not very available
for the moment, See http://www.stud.enst.fr/~orzan/vreng/ for details.

The mailing-list <vreng@inf.enst.fr> has been opened for any discussion
about the VReng application and its evolution. To be added on this
mailing-list, send a message to <vreng-request@inf.enst.fr>.

You can send BUG reports and comments at <vreng@inf.enst.fr>.

Have fun!

-- Philippe Dax -- <dax@inf.enst.fr>