---------------------------------------------------------------------------- Dialog Machine, ModelWorks, and RAMSES Auxiliary Library for Windows 3.0.2a7 ---------------------------------------------------------------------------- This is an alpha release Version 3.0.2 of the software layers 'Dialog Machine' (DM), ModelWorks (MW), and the RAMSES Auxiliary Library (Aux) for Windows . It is provided for testing purposes, but note, that it is fairly stable. Major draw backs are that certain, rarely used functions of the Dialog Machine are not fully implemented or not implemented at all. All other software, notably ModelWorks and the RAMSES Auxiliary Library are source code identical to the Macintosh and Unix platform software. All these layers stacked on top of the 'Dialog Machine' consist of well tested software modules, which have proven their usefulness for many years on the Macintosh and the Unix platform. Learn more about these software layers at the following web sites: - DM: http://www.ito.umnw.ethz.ch/SysEcol/SimSoftware/RAMSES/DialogMachine.html - MW: http://www.ito.umnw.ethz.ch/SysEcol/SimSoftware/RAMSES/ModelWorks.html - RAMSES: http://www.ito.umnw.ethz.ch/SysEcol/SimSoftware/RAMSES/RAMSES_Welcome.html RAMSES stands for Research Aids for Modeling and Simulation of Environmental Systems. To make good use of this software package, you should be familiar with the Logitech Modula 2 V4.0 environment (distributet by terratech, http://www.terraterra.ch). RESTRICTIONS: Some functions are not implemented. You will get a "Sorry not implemented" message, while calling such a function (See SECTION 'RESSOURCES'). No special documentation for Windows is included yet. Please use the documentations provided within the directory 'Docu', notably the 300 page ModelWorks Manual. The ModelWorks Windows version will work with Windows 3.1, Windows 9x, Windows NT, but NOT with Windows 3.0. DOCUMENTATION: There are several documents included in this distribution, in plain text and in pdf format. INSTALLATION: - You need Logitech Modula 2 V4.0 Support Release 3 installed and properly initialized on your disk in order to use this package. - download rms302a7.zip and extract it wherever you like - open a dosshell, go to the installationdirectory and run the batchfile 'setvar.bat' providing this directory and the directory of your Modula installation Example: c:\rms302a7>setvar c:\pcdm302 h:\m2 c:\rms302a7> TO COMPILE THE SAMPLE MODELS: - Go to the directory where the sample models reside (...\SAMPLEMO) and run MAKE MODEL to make one of the simple models (where MODEL stands for a sample model file - e.g. to build Logistic-Model, type MAKE LOGISTIC). Like this, you can create an executable file for each sample model. TO COMPILE YOUR OWN MODELS: - The easiest way to compile your own models is to use the batch file 'MAKE.BAT' which resides in the directory ...\_Make and proceed like for the sample models. - 'make' has to be executed on the same directory level as the work directory Example: [releasedir]\work>make myproj [OK] [releasedir]\mydir1>make myproj [OK] [releasedir]\mydir1\subdir>make myproj [ERROR] WHAT FILES ARE USED? The things you need to get your own model up and running are: - A module-definition file for Logitech Linker There is a sample module-definition file included ('MW.WDF'), that should do for your models (and will of course for the sample models). Plese refer to the Logitech compiler manual for more information. - A Logitech-project-file (e.g. MW.PRJ), that helps the Logitech environment to compile and link the files needed. There is a sample project-file included in this distribution (MW.PRJ), that helps you compile all sample models and probably most of your own models. The batch-file 'MAKE.BAT' mentioned above, uses this sample project file to compile the sample models. Please refer to Logitech documentation, if you want to understand what's really in this project file. - An INI-file that helps ModelWorks to map the used fonts into the available windows fonts. There is a sample RC-file included. You can edit it to fit your needs. - A Ressource-File for the Resource-Compiler There is a Sample ressource file include (...\RES\MW.RC) that will do for simple models. (See SECTION 'RESSOURCES'). RESSOURCES The ressource file used for building ModelWorks-applications contains 3 different parts (please refer to Windows documentation, or look at the sample ressource file ...\res\MW.RC): The stringtable-entries are: - String 100: The title of your application - String 101: A Number which will enable or disable the 'SorryNotImplemented' messages. > 5: will disable all 'SorryNotImplemented'-messages <=5: will enable all 'SorryNotImplemented'-messages of the not implemented DialogMachine-functions - String 102: Will let you choose a different INI-File for Font-Mapping and ressource-saving (predefined menus and stored strings). The DMICON section lets you select an icon of your choice. The MACPIC section is needed to display buttons in ModelWorks-Models (please make shure the SIMMASTE.PIC-file is proparly included as in the sample ressource file \MW\MW.RC) To use predefined pictures in your ModelWorks application, you can add a numbered sections to your RC-file. [PICTURE-Nr.] BITMAP [BITMAP-File] e.g. "3133 BITMAP \MW\RES\3133.bmp" This will enable you to call the function 'DisplayPredefinedPicture' from DMWindIO-module in your model source file. E.g. "DisplayPredefinedPicture('', 3133, f);" The named file must exist and be a standard Windows-bitmap file! TABLE OF CONTENT \_make : Utilities to build projects \auxlib : sym files of the AuxLib \dmbase : sym files of the DialogMachine (base moduls) \dmlib : sym files of the DialogMachine \mw : sym files of ModelWorks \docu : Documentation including public definition modules \lib : Libraries \res : Resources for standard Projects \samplemo : Sample models \samplepr : Sample programms \work : Work directory BUG REPORTS and SUGGESTIONS: Please contact us at: modelworks.pc@ito.umnw.ethz.ch Fabrizio Giorgetta & Andreas Fischlin, 20. Feb. 2002