README - Gled Run
=================

Gled is a framework for sharing object collections in a hierarchic
server-client model.

Gled is realeased under GNU GPL version 2. See LICENSE.

Instructions for installing binary packages and demos are in INSTALL.

This is a top-level Gled directory. It serves as a container for
binary distributions of libsets and external software and provides
run-time environment.

Libset names are typically capitalized as "This" or GledCore or Geom1.
The actual implementation of core Gled system is in the GledCore libset,
which contains two executables:
 * gled    standard executable with gui,
 * saturn  command interface only; useful for pure servers and proxies.


Preparing the environment
-------------------------

If you have a full binary packet, then the script binenv.(c)sh should
do the job: '. binenv.sh' or 'source binenv.csh'.

It expects ROOT to be in external/root/ and all other external software
to reside in external/ (in bin/, lib/, man/ etc).

Anyway, the scripts should give you a good idea of what needs to be
set.


Running
-------

For a trivial demo type:

gled hello_gled.C

You will get the main window (basically message output), GUI shell
(somewhat intuitive, see gui-docs for details) and a GL window.

To navigate in GL window (pupil) use left/middle mouse buttons. Control key
modifies behaviour and is *REALLY* usefull:
left-drag	   forward/backwards slide left/right
ctrl-left-drag	   slide up/down     slide left/right
mid-drag	   turn up/down	     turn left/right
ctrl-mid-drag	   turn down/up	     roll left/right (think pilot stick)
<Home> will return you to the origin.

To connect to an already running gled, use:

gled -r -m <host-to-connect-to> moon.C

For more information see http://www.gled.org/.
