Required tools for installation
unzip utility which may be down loaded from
http://www.cdrom.com/pub/infozip

List of zipped files of XBIT package

Evaluation versions of XBIT
xbit76e.zip     		Windows DLL for Tcl76p2/Tk4.2   
xbit80e.zip     		Windows DLL for Tcl8.0/Tk8.0    
xbit81e.zip     		Windows DLL for Tcl8.1/Tk8.1    
xbit82e.zip     		Windows DLL for Tcl8.2/Tk8.2
linux2.2.5-15-xbit76e.zip	Linux 2.2.5-15 DLL for Tcl76p2/Tk4.2
linux2.2.5-15-xbit80e.zip	Linux 2.2.5-15 DLL for Tcl8.0/Tk8.0
linux2.2.5-15-xbit81e.zip	Linux 2.2.5-15 DLL for Tcl8.1/Tk8.1
linux2.2.5-15-xbit82e.zip	Linux 2.2.5-15 DLL for Tcl8.2/Tk8.2

Professional versions of XBIT
xbit76p.zip     		Windows DLL for Tcl76p2/Tk4.2 
xbit80p.zip     		Windows DLL for Tcl8.0/Tk8.0  
xbit81p.zip     		Windows DLL for Tcl8.1/Tk8.1  
xbit82p.zip     		Windows DLL for Tcl8.2/Tk8.2  
linux2.2.5-15-xbit76p.zip	Linux 2.2.5-15 DLL for Tcl76p2/Tk4.2
linux2.2.5-15-xbit80p.zip	Linux 2.2.5-15 DLL for Tcl8.0/Tk8.0
linux2.2.5-15-xbit81p.zip	Linux 2.2.5-15 DLL for Tcl8.1/Tk8.1
linux2.2.5-15-xbit82p.zip	Linux 2.2.5-15 DLL for Tcl8.2/Tk8.2

Script libs and documentations of XBIT
xbitlib.zip     script libraries
xbitdoc.zip     documentation and bitmaps used in XBIT

Image data for Xbit Demo
imagery0.zip    image data for XBit demo program
imagery1.zip    image data for XBit demo program

Installation and run

1) create an xbit-home-directory
2) unzip the zipped files in the xbit-home-directory
3) run XBIT:
   wish xbitinit.tcl
4) run Xbit Demo
   invoke a menu entry "Xbit Demo" under a "Program" menu of
   an XBit Console or type in "xbit.demo" at a Wish console
   after loading XBIT.

The XBit demo program requires imagery0.zip and imagery1.zip be
down loaded and unzipped at the home directory of XBIT.
  
Usage of XBIT

Tcl global variable: XBIT needs a Tcl global variable gimgHome
to be set to the home directory of the XBIT.

XBIT Entries: A DLL of XBIT has two entries: Console_Init and
Xbit_Init. 

If XBIT is loaded from Console_Init, e.g., 

        load xbit80e.dll Console

the built-in XBIT Console will replace the standard wish shell,
An XBit Console support Tcl standard I/O channels by providing
stdin, stdout, and stderr. The script

        set input [gets stdin]

will accept an XBit Console's input line typed in from the
keyboard.

When running XBIT from the command line, i.e.,

        wish83 xbitInit.tcl     or
        wish82 xbitInit.tcl     or
        wish81 xbitInit.tcl     or
        wish80 xbitInit.tcl     or
        wish42 xbitInit.tcl

the Tcl scripts of xbitinit.tcl will automatically set the gimgHome
to the path of the xbit-home-directory, and invoke the load command
to link the right DLL file of XBIT from the entry of Console_Init.
Under the menu Program of a XBIT console, there is an entry of
"Install Xbit Package" for XBIT package installation. It installs
XBIT using the script file "xbitpkg.tcl", which loads the XBIT DLL 
from the home directory of XBIT, and calls the function Xbit_Init.

If XBIT is loaded from Xbit_Init,e.g.,

        load xbit80e.dll Xbit

a built-in XBIT console will not be invoked. However, a Windows
Wish shell will be enhanced via stdio channels supported by XBIT.

To support stdin, stdout and stderr in C programming, an XBIT DLL
exports the following stdio C-rumtime library functions:
        printf          (stdout)
        fprintf         (stdout, stderr)
        scanf           (stdin)
        fscanf          (stdin)
        fgetc           (stdin)
        gets            (stdin)
The stdout and stderr will print text to the console, and stdin will
accept console input from the keyboard.
