iMAM/VRS - The interactive MAM/VRS
==================================

Installation on Windows systems

You need the following sofware packages to run iMAM/VRS:
- MAM/VRS 2.1 (binary distribution for Win32 available!)
  http://www.mamvrs.de

- Tcl/Tk and its object-oriented extension Itcl 
  http://www.sensus.org/tcl (binaries available!)
  http://www.scriptics.com (sources)
  We have tested iMAM/VRS with Tcl/Tk 8.0.3 and Itcl 3.0;
  the corresponding files have been Tcl-nt-8.0.3.zip and
  Itcl-nt-8.0.3.zip.

Unpack the zip-file and install iMAM/VRS as add-on into 
the MAM/VRS directory, for example in 
  D:/mamvrs212/add-on/imam


Binary Distribution
-------------------
If you have the binary distribution of iMAM/VRS, 
you can just call the imamwish executable in
  D:/mamvrs212/add-on/imam/apps/imamwish

The imamvrs212.dll must be moved to a standard place
or you have to setup your PATH variable.
When you start the imamwish, it automatically should
detect the right place where the imam [incr Tcl] 
library. 

If not, you have to set the environment variable
'IMAM_LIBRARY' to point to the place where the add has 
been installed, for example, add to your autoexec:

   set IMAM_LIBRARY=C:/mamvrs212/add-on/imam



Source-Code Distribution
------------------------

imamvrs212.dll
--------------
You can compile the iMAM/VRS dll with Developer Studio 5.x. 
Let's assume, mam/vrs is installed in D:/mamvrs212,
and Tcl is installed in C:/ProgramFiles/Tcl.

Make a new Win32 dll project, call that project imam
and install that project in the add-on directory. 
You will have a work space here:
  D:/mamvrs212/add-on/imam/imam.dsw

Add all files in the src directory to the project.
  D:/mamvrs212/add-on/imam/src/*.*

Setup the project:
  C++/C:
    Add include paths for MAM/VRS, iMAM/VRS and Tcl:
	  D:/mamvrs212/include, D:/mamvrs212/add-on/imam/include,
	  C:/ProgramFiles/Tcl/include

  Linker:
    Add the following linked modules:
        mamvrs212.lib opengl32.lib glu32.lib 
        tcl80.lib tk80.lib itcl30.lib 
        kernel32.lib user32.lib gdi32.lib 
    Add the following input paths for the linker:
        C:\Programme\Tcl\lib, D:\mamvrs212\Debug

Compile imamvrs212.dll. This imamvrs212.dll can be loaded to any tcl wish
as package at run-time.


imamwish.exe
------------
The imamwish is a sample Tcl shell which loads at start up the 
imamvrs212.dll. It is provided as an example program in 
    D:/mamvrs212/add-on/imam/apps/imamwish

Make a new Win32 Application Project (no MFC).

Add all files in the imamwish directory to the project.
(it only one file at the moment)
  D:/mamvrs212/add-on/imam/apps/imamwish/*.*

Setup the project:
  C++/C:
    Add include paths for MAM/VRS, iMAM/VRS and Tcl:
	  D:/mamvrs212/include, D:/mamvrs212/add-on/imam/include,
	  C:/ProgramFiles/Tcl/include

  Linker:
    Add the following linked modules:
        imamvrs212.lib mamvrs212.lib opengl32.lib glu32.lib 
        tcl80.lib tk80.lib itcl30.lib 
        kernel32.lib user32.lib gdi32.lib
		 
    Add the following input paths for the linker:
        C:\Programme\Tcl\lib, D:\mamvrs212\Debug, 
        D:\mamvrs212\add-on\imam\Debug

You can start now the imamwish.exe which is similar to a Tcl wish
except that the itcl, itk, and imam packages have been loaded already.

