#Copyright (C) 1998 Tuomas J. Lukka, 2001 John Stewart, CRC Canada.
#DISTRIBUTED WITH NO WARRANTY, EXPRESS OR IMPLIED.
#See the GNU Library General Public License (file COPYING in the distribution)
#for conditions of use and redistribution, EXCEPT on the files
#which belong under the mozilla public license.
I have tested the FreeWRL build on brand new installs of:
Others have tested FreeWRL on:
NOTE: when build options were presented, I chose the "Development Workstation" options - you may not have to do one or two of the steps outlined below if you install everything. Comments/help/Additional build notes more than welcome.
This install is divided up into the following sections:
(updated 07 June 2001 - john.stewart@crc.ca)
(updated 08 May 2001 - john.stewart@crc.ca)
(updated 08 April 2001 - john.stewart@crc.ca)
(updated 31 August 2000 - remi@cohen-scali.com)
(updated 19 June 2000 - john.stewart@crc.ca)
Notes: All files are available here:
You can also access the cvs repository. The way to do it is explained at:
- http://sourceforge.net/cvs/?group_id=9120
If you have a Linux compatible 3D accel. card, then simply install it, and follow the directions from the manufacturer.
NOTE:Voodoo3 cards, now obsolete, have the following problems with Redhat 7.1, and possibly other releases:
Perform steps 1, 4, 5, 6, 7 and 9 in the "General" section below.
This install was quite complex.
Digest-MD5-2.09
HTML-Parser-2.25
MIME-Base64-2.11
URI-1.04
libnet-1.0607
libwww-perl-5.47
Image-Base-1.07
Installing these modules is a no-brainer; just untar
each module, then go into the directory, and
perl Makefile.PL
make install
perl Makefile.PL
In the main FreeWRL directory. There will be an error for the Javascript library. If there are any other errors, correct them first.
to compile the Mozilla javascript code:
cd JS/js
make
cd ../..
Then, re-run the build for the main make file:
perl Makefile.PL
make install
- mknod.javapipej p
- mknod.javapipep p
There are quite a few tests in the "tests" directory.
Run all of the numbered files (And any others that you want!) in the tests directory. Note that some use javascript, so you will be testing javascript, too.
3.1) Javascript:
In the basic install, you should have installed the java support to allow some of the test programs in the tests directory to work. (eg, 7.wrl, 8.wrl, and 10.wrl)
If these programs don't run, then go back and make FreeWRL it so that it does work.
3.2) EAIcode:
NOTE: This is in active development, so may not work.
3.2) SAIcode:
NOTE: This is in active development, so may not work.
4) Getting it all to work with Netscape.
4.1) Go to the Plugin directory, and follow the instructions.
5) Getting it to work with external sensors.
5.1) CRC's "Flying Chair".
This chair can be seen in the "links" section. The code to run this chair is freely available, at: http://sourceforge.net/projects/mvip/
5.2) Thrustmaster style Joystick
The 2-D joystick interface is available at: http://www.crc.ca/FreeWRL/download/joystick/Joystick-1.0.tar.gz, and the 3D joystick interface is available as part of the chair code, as outlined above.
5.3) Data Glove.
This interface is being actively worked on.
5.4) Spaceball 3D positioning mouse.
This interface is being actively worked on.
5.4) Touchscreens.
One of our FreeWRL users has made a very interesting touchscreen interface to FreeWRL. This code will be incorporated into FreeWRL when it is complete.
5.6) Polhemus/Virtual Research goggles with position sensor.
This works very well with the "Flying Chair" mentioned above, but if you wish to run this alone, without joystick (and chair!), here are the directions:5.6.1) Polhemus Position Sensor.
- Untar and compile the code in the Polhemus 1.0. tarfile.
- run minicom (with modem in it strings set to null) and see if you can get any input.
- align the Fastrak. I use the A0 command, as found in the manual, to do the allignment. ("Enhanced Allignment Procedure, pg 48a of my manual-Sept 1998)
eg:
(in minicom)
A0
P
(now, move the sensor 24" in positive X axis)
P
(now, move the sensor 24" in positive Y axis)
P
Exit minicom
- run the program Polhemus/termite to get the polhemus interface code working. Note - headset should be pointed at where you want "front" to be.
5.6.2) Virtual Research goggles
An option has been added to FreeWRL to run in full screen mode just for these goggles. Start FreeWRL with the "-fullscreen" option; eg:
freewrl tests/1.wrl -best -fullscreen -geometry 640x480