                     TIM FOR WINDOWS DEMO PROGRAM
                       Installation directives

TIM for Windows is a program for scientific image processing. It operates
on images from the real-world, in order to get data out of them. Images
can be aquired using a video camera and a frame grabber, or imported
as a TIFF file.

TIMWIN has a large set of operations and functions, including:

* image processing: pixel operations, linear and non-linear filters,
  bitplane- and morphologic operations, 2D-FFT, graphics
* operations for measurement and control
* a full language for writing scripts and analyzing results
  (including compiler,  editor & debugger)
* an extended on line help

You can issue commands using menus, but for experienced users a
command line interface is available with history, command line
editing, etc.

TIMWIN runs on a PC-AT with:
* Microsoft Windows 3.1 in standard or enhanced mode
* At least 2, but preferably 4 MB of memory
* A VGA display (super VGA, 256 colours recommended for image
  display)
* 2.5 MB of free disk space
* A frame grabber is optional. With no frame grabber, the necessary 
  image storage is created in standard memory, which will increase 
  the memory requirements.
  Supported frame grabbers:
  Imaging Technology Inc.: PCVision, PCVisionPlus, VFG
  Imagenation Corp.:       Cortex-I 

The TIMWIN-Demo program is a limited version of the full program:

* only 256x256 image processing is supported
* the compiler is disabled, so you cannot execute self-made command
  file programs
* writing images to disk is disabled

The TIMWIN-Demo program is distributed on floppy disk and by anonymous
ftp from several sites.

Conditions
~~~~~~~~~~
This software is intended to give the image processing community an
impression of the possibilities of TIM for Windows.
You may use, copy and distribute this software freely.
You may not:
- modify the software,
- remove the above described limitations,
- sell the software.

TIM and TIMWIN are registered trade marks.
DIFA and TEA cannot be held responsible or liable for any damages that
might result of the use of TIMWIN Demo.
Using TIMWIN Demo implies acceptance of these conditions.

Installation from zipped files
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The TIMWIN-Demo files are packed in a compressed file: timwin.zip
To install TIMWIN demo from this file, follow the instructions below.

* Unpack the file TIMWIN.ZIP (use an unzipper that is compatible
  with version 2.04, e.g. the newest version of PKUNZIP).
  You can do this in a temporary directory, but you can also do it
  in the intended TIMWIN directory, e.g. c:\timwin.  

  **** The feature described below may be not present in some versions ****
  If, during installation, a file is copied to another directory,
  the original is removed, to avoid occupying unnecessary
  disk space. The free disk space calculator in the install program
  doesn't take this into account, which may result in an warning
  about insufficient disk space. In this case, it is safe to ignore this warning.

  If you need to repeat the installation, some files may have been removed.
  In this case, repeat the unzip procedure.
  **** end 

Further see the instructions for 'Installation from floppy disk',
except that you specify the install program without argument,
but with a path ('c:\timwin\install')

Installation from floppy disk
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To install TIMWIN-Demo from floppy disks, insert disk 1 and run
install a: or  install b: from the Windows program manager (not from
the MS-DOS prompt):

* In the program manager window, select File and then Run.
* Enter 'install a:'  or  'install b:'
* Answer the questions and installation takes place automatically.

If, after installation, TIMWIN complains about memory, replace the file
IMAGES.TIM by IMGMIN.XXX, where XXX symbolises the frame grabber you are
using (e.g. 'copy imgmin.nof images.tim' if you have no frame grabber)

INTROD.WRI       An introduction document.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
After successful installation, you are advised to open and study the text 
in INTROD.WRI. This will give you a compact introduction in TIMWIN's
concepts and usage. 

Running TIMWIN
~~~~~~~~~~~~~~
Each time you invoke TIMWIN, a small command file (*inidemo) runs
which initialises the system. It also brings up a help page, which
will give some startup information and allows you to browse through
the on-line manual to inform yourself about TIMWIN. This may take
some time.
After you clicked OK in the message box, the help page disappears
and TIMWIN is ready to use. First follow the instructions in
'Setting up the system'

If you don't have a frame grabber, images must be displayed in a window.
There are two options for displaying images on the computer screen; each
of them is selected by choosing a specific image definition file ('images.xxx').
If you have a high resolution monitor (at least 800x600 @ 256 colours), use
the setup defined in 'images.pqr' (this is the default setup). If you have 
a standard VGA adapter or less than 256 colours (16), use the setup
defined in 'images.nof'. 
To change the setup, copy the appropriate file into
the TIMWIN directory under the name: 'images.tim'.

Specifying images processing commands can be done using dialog
boxes (from the menu bar in the top of the main window) or using the
command line (in the bottom of the main window). It is advised to
first familiarise yourself with TIMWIN's concepts by browsing through
the on line help (select Help on the main menu or press any other help
button to start help).

To see some image processing programs running, enter the command

   *demo1

in the command line. This will start a set of pre-compiled programs,
which will give you a good impression of TIMWIN's capabilities.
Realise, that the demo's are the most informative on systems having a
frame grabber, because then the process can be followed from image to
image. If there is no frame grabber, the setup as specified in 'images.pqr' 
will give you a 'next best' view. On standard VGA systems, the setup as 
specified in 'images.nof' will give a satisfying view of what takes place,
although some intermediate steps will be skipped.

If desired, you can run the demo program in single step mode
by starting it as follows:

   *demo1 debug

To change execution mode of a running program to debug mode, press the
ESC key. Then choose the desired running mode.

Setting up the system
~~~~~~~~~~~~~~~~~~~~~
First go to the Contr. menu and select Installation. Press the
File Paths button and fill in absolute paths for the command file
and image directories (e.g. 'c:\timwin\cmc').
If there is a frame grabber in your system, after the installation you
must go to Installation in the Contr menu, to adapt TIMWIN to the
settings of your frame grabber.
Also, if you use a memory mapped device like a frame grabber under
Windows, be sure to have a line like 'EMMExclude=D000-DFFF' in your Windows'
System.ini file (in the [386Enh] section. The values must conform the
frame grabber's memory base adress). The install program does this for you,
but if you have another memory mapped card in your system (e.g. a network 
adapter), it is advised to check (and modify) the setting manually.
The same holds for the Emm386 driver that may be in your Config.sys
file. See your DOS manual for details.

Feedback
~~~~~~~~
We would like to have feedback from people who have been experimenting with
TIMWIN. Please tell us your experiences, either positive or negative.
If you have any questions or suggestions about TIMWIN, please contact:

For commercial information:        For technical information
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~    ~~~~~~~~~~~~~~~~~~~~~~~~~
DIFA bv., Image Processing Dpt.    Robert J.Ekkers
POBox 3132                         Fax no. (31)15 - 626740
4800 DC  Breda                     EMail: ekkers@ph.tn.tudelft.nl
the Netherlands
Fax no. (31)76 - 711953


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Appendix:
After installation, the following files should be in the respective
directories:

In the TIMWIN directory:
 TIMWIN.EXE       The TIMWIN main program
 EDITCF.EXE       TIMWIN's editor (can also be used for other purposes)

 TIMDLL.DLL       The image processing DLL. It is copied from one of the
                  following files, depending on your frame grabber:
                   TIMPCVIS.DLL
                   TIMFGPLU.DLL
                   TIMPCVIS.DLL
                   TIMVFG.DLL
                   TIMCORTE.DLL

 COMPDLL.DLL      The compiler DLL. Although compiling is disabled in the
                  DEMO version, this DLL is needed to solve references for
                  the other modules,

 TIMEXQ.DLL       The executer DLL. It executes command files

 IMAGES.TIM       The image definition file. It is copied from one of the
                  following files, depending on your frame grabber:
                   IMAGES.CX1    Cortex-I
                   IMAGES.FGD    PCVisionPlus (dual frame mode)
                   IMAGES.FGS    PCVisionPlus (single frame mode)
                   IMAGES.PCV    PCVision
                   IMAGES.VFG    VFG and other series 100 frame grabbers
                   IMAGES.NOF    No frame grabber, 2 windows images: 'h' and 'i'.
                   IMAGES.PQR    No frame grabber, 4 windows images: p, q, r and s
                                 Since, in the demo program, pocessing takes place in
                                 these images, this setup allows you to follow each 
                                 step in detail.         

The following files can be used if memory usage of 
the above files is too high:
                   IMGMIN.CX1
                   IMGMIN.FGD
                   IMGMIN.FGS
                   IMGMIN.PCV
                   IMGMIN.VFG
                   IMGMIN.NOF

 STANDARD.FNT     Various text fonts for writing text in images
 CHIC09.FNT       (See the 'text' and 'lcset' commands)
 COUR11.FNT       The number indicates the point size.
 MONA09.FNT
 TIME15.FNT
 TIME15P.FNT
 UPPER.FNT

 ALIAS.TIM        Alias definitions
 ERMSGS.TIM       Error message texts


In the CMC directory:
 *.CMD            Sources of the DEMO command files
 *.CMC            Compiled DEMO command files

In the IM directory:
 *.IM and *.TIF   Image files
