iMAM/VRS - Interactive MAM/VRS
==============================

iMAM/VRS is an object-oriented 3D graphics scripting language
written as [incr Tcl] package. It is implemented on top of 
MAM/VRS, a C++ 3D graphics library.

See http:\\www.mamvrs.de for more information about 
this 3D graphics extension to Tcl/Tk.



Copyright
=========
Copyright (C)1995-99 Juergen Doellner, Klaus Hinrichs
 
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
 
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.
 
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Introduction
============

    iMAM/VRS has been realized using the 'cc2itcl' generator
    which generates for a set of C++ classes equivalent 
    [incr Tcl] classes. [incr Tcl] is an object-oriented extension
    to the famous scripting language Tcl. You can construct 
    3D graphics objects from within [incr Tcl], call their methods
    and fully integrate them into the scripting language Tcl. 


Requirements
============

    MAM/VRS 2.1 installed
    Tcl/Tk 8.x and [incr Tcl] 3.x installed
    
    Windows:
    It is sufficient to have the binary releases of Tcl/Tk and 
    [incr Tcl] installed.


Installation
============

    iMAM/VRS is situated in the add-on directory of MAM/VRS. 
    Unpack the whole imam directory here:
        mamvrs/add-on/imam

    For more information about the installation, see the INSTALL file.


Running imamwish
================
The imamwish application is a Tcl shell which automatically 
loads [incr Tcl], [incr Tk], and iMAM/VRS at startup. 
It is located in mamvrs/add-on/imam/apps/imamwish.
There is a small sample script in this directory, too.
You can load that script by the source command of Tcl.

    % source minimum.itk

iMAM/VRS Variables
==================

The following global variables are defined by iMAM/VRS:

::imam_version       : the major release, same as MAM/VRS release
::imam_patchLevel    : the current patch level
::imam_builddate     : time of compilation of that iMAM/VRS
::imam_library       : path to the library directory in the add-on

All MAM/VRS classes are accessible by their C++ class name. 


Authors
=======

    Juergen Doellner, Bjoern Lojewski, Joerg Reiberg, Klaus Hinrichs

    Dept. of Computer Science
    University of Muenster
    Einsteinstr. 62
    48149 Muenster
    Germany
 
    E-mail:

        Technical issues:
           reiberg@uni-muenster.de (Joerg Reiberg)

        Project and licensing issues:
           dollner@uni-muenster.de (Juergen Doellner)
           khh@uni-muenster.de     (Klaus Hinrichs)
 
    WWW: http://www.mamvrs.de

