
****************************************************************************
*                                                                          *
* G-WEB World Builder - Version 4.0 BETA                                   *
*                                                                          *
* RELEASE NOTES:-                                                          *
*                                                                          *
****************************************************************************


  CONTENTS.

  1)   INSTALLING G-WEB - GENERAL.
   1.1)   FOR GWEBWINNT AND GWEBWINLITE.
   1.2)   FOR GWEBSGI.

  2)   RUNNING G-WEB - GENERAL.
   2.1)   START-UP CONFIGURATION.
   2.2)   ENVIRONMENT VARIABLES.
   2.3)   FOR GWEBSGI, THE 'RUN' FILE.
   2.4)   FOR GWEBSGI, - ONYX
   2.5)   FOR GWEBWINLITE - THE 'WTKWIN.INI' FILE.
   2.6)   FOR GWEBWINNT - THE 'PROGRAM MANAGER'.

  3) KNOWN PROBLEMS.



	<gweb_directory> = the name of the directory where gweb is installed on
										 your platform.

****************************************************************************

1)   INSTALLING G-Web - GENERAL.

	If you have downloaded gweb you will need to unpack the archive before
	installing the software.

	To unzip on PC:
	pkunzip -s password gwebwin.zip

	To unzip on SGI:
	crypt password < gwebsgi.gz > gwebsgi.gz
	gunzip gwebsgi
	tar xvf gwebsgi


	alternativley insert the distribution media.


1.1)   for gwebwinnt and gwebwinlite.

  From the Windows Program Manager open the 'Run' dialogue and run the
  install program on the distribution diskette.

  Or double click on it with the file-manager.

  The install program will install G-Web and build the project
  directories. A program group will be created with G-Web, this readme and
  the manuals in Microsoft help format.

  NOTE: If you do not install G-Web in the default directory you will need
  to set the environment variables - see section 2.2


1.2)   FOR GWEBSGI.

	G-Web needs no more installing.


****************************************************************************

2)   RUNNING G-WEB - GENERAL.


  G-Web can be run in the usual way for your system. Upon start-up G-Web
  will open one view onto the graphical universe and a main interface window.

  Example project files can be found in the 'examples' directory.


2.1)   START-UP CONFIGURATION.

  To change G-Web's start-up configuration use standard command line
  arguments for your platform.

  The list below details all of the available arguments for running G-Web.

  display parameters:

  -c            use CrystalEyes Stereoview
  -n            use Cyberhood Stereoview (windows only)

  sensor parameters:

  -m            for mouse (default).
  -a(1,2)[1..4] for Ascension Bird. For a flock, specify which unit.
  -b(1,2)       for Fake Space Boom on port 1,2.
  -e(1,2)       for global dEvice's thingamajig.
  -f(1,2)[1..4] for a Polhemus Fastrak. Specify unit number after port.
  -g(1,2)       for Geoball on port 1,2.
  -l(1,2)       for Logitech tracker on port 1,2.
  -p(1,2)       for Polhemus tracker on port 1,2.
  -r(1,2)       for Logitech Red Baron on port 1,2.
  -s(1,2)       for Spaceball on port 1,2.
  -v(1,2)       for CrystalEyes VR sensor on port 1,2.
  -x(1,2)       for SpaceControl on port 1,2 (windows only).
  -j(1,2)       for joystick 1,2 (uses gameports, not serial ports) (windows only)
  -i            for Gravis Mousestick (uses bus mouse, not serial port) (windows only).

  default environment file parameters:

  filename.gen  a default project file to load on start-up.

  Two optional parameters can be specified
  v            Allows the sensor to manipulate the viewpoint.
  m            Allows the sensor to manipulate the selected resource.

  e.g.
  -mvm       Opens a mouse for manipulating everything.
  -s1v       Opens a spaceball on serial port 1 for manipulating the viewpoint.
  -f23m      Opens a fastrak on port 2 sensor unit 3 for manipulating selected resources.



2.2)   ENVIRONMENT VARIABLES.

  G-Web uses the two environment variables WTMODELS and WTIMAGES to locate
  models and images on the disc. These variables should be set to point
  to your current project directory.(especially if you decide to use a
  different project directory)

  e.g.
  WTMODELS=<gweb_directory>\project
  WTIMAGES=<gweb_directory>\project

  We recommend that you fully qualify your environment path names.

  If you experience problems loading and saving resources and projects the
  cause may well be semi qualified environment variables.


2.3)   FOR SGI, THE 'RUN' FILE.

  G-Web can be run from the command line by typing 'gengui -mvm' or using
  any of the arguments above.

  An example start-up file is provided called 'run' in the <g_web_directory>.
  running G-Web by typing 'source run' will initialise the
  WTMODELS and WTIMAGES variables to the example project
  directories. (you are advised to start G-Web this way unless you are
  familiar with setting environment variables).

  The background colour of the g_web gui windows can be configured
  in the '/usr/lib/X11/app-defaults/gengui' file.
  If you do not have this file you can copy the file gengui.app-defaults
  as '/usr/lib/X11/app-defaults/gengui'.


2.4)   FOR SGI, - ONYX

  The onyx platform requires a slightly different version of G-Web
  to use this type

  mv other_versions/gengui_onyx gengui

  from the <g-web_directory>.


2.5)   FOR GWEBWINLITE - THE 'WTKWIN.INI' FILE.

  Gwebwinlite uses the 'wtkwin.ini' file in the <gweb_directory> to configure
  how it starts up.

	the args variable can be used to set the startup options

  e.g.
  [startup]
  args= -mvm

	the wtmodels and wtimages variables can also be set using the wtkwin.ini
	file.


2.6)   FOR GWEBWINNT - THE 'PROGRAM MANAGER'.

	Gwebwin uses the program manager to configure how it starts up pressing
	Alt+enter on the gweb icon alows you st set the command line arguments

	eg c:\gwebwin\gengui.exe -mvm

	the WTMODELS and WTIMAGES variables need to be set using the system icon
	in the controll panel.

  WTMODELS=c:\<gweb_directory>\project
  WTIMAGES=c:\<gweb_directory>\project

	you may need to reboot your system after setting these before they
	take effect.


****************************************************************************

3.0) KNOWN PROBLEMS.

When applying a texture to an object the object should be white this is so that when the VRML
file is imported into a VRML viewer it can be seen properly. This because the VRML viewers
combine the texture colour with the objects colour and GWEB does not.


