********************************************************************
**                                                                **
**               IBM-PC Installation of DISLIN                    **
**                                                                **
**  Contents:  1.)  Introduction                                  **
**             2.)  Installation of DISLIN                        **
**             3.)  Getting a DISLIN License                      **
**             4.)  Programming with DISLIN                       **
**                                                                **
**  Date   :   15.10.2006                                         **
**  Version:   9.1 /  Windows,  Visual C++ 4.x, 5.x, 6.x          **
**  Author :   Helmut Michels                                     **
**             MPI fuer Sonnensystemforschung,                    **
**             Max-Planck-Str. 2, 37191 Katlenburg-Lindau,        **
**             Germany                                            **
**             E-mail: michels@mps.mpg.de                         **
********************************************************************

1.)  Introduction

     This file describes the  installation  of the  data  plotting
     software DISLIN on IBM-PCs  for  the operating system Windows
     9x/NT/2000/XP and the Microsoft C compiler Visual C++.

2.)  Installation of DISLIN

     The  DISLIN version for the Microsoft Compiler Visual C++  is
     distributed in the zipped file  dl_91_vc.zip.  An utility for
     unpacking the DISLIN files is available from the same locati-
     on where you have downloaded dl_91_vc.zip, or from the DISLIN
     CD-ROM. 

     To install DISLIN, make the following steps:

  a) Create a temporary directory and copy the files dl_91_vc.zip
     and unzip.exe to it:

     for example:   md  c:\temp
                    cd  c:\temp
                    copy e:\dislin\windows\unzip.exe    *.*
                    copy e:\dislin\windows\dl_91_vc.zip *.*

  b) Extract the DISLIN files with the command:

                 unzip  -o dl_91_vc.zip

  c) Run the setup program with the command

                  setup

     -  Choose OK

     -  Give the Installation Directory where  DISLIN  should be in-
        stalled. The default directory is C:\DISLIN.

  d) Reconfigure the System

     Set the DISLIN environment variable to c:\dislin and include
     c:\dislin\win in your path. If you have installed DISLIN in a
     different directory, you have to use that directory for the 
     environment variables above.

     The setting of environment depends on your Windows version:

     Windows 98/ME

        Add the following commands to the autoexec.bat file

        PATH=c:\dislin\win;%PATH%
        SET DISLIN=c:\dislin   
   
     Windows NT/2000/XP

        In Windows NT/2000/XP environment variables can be set or
        modified with the Control Panel 
        (see Control Panel -> System -> Advanced -> Environment
        Variables).
   
  e) Now you can compile,  link and run the example programs in the
     DISLIN subdirectory examples with the commands

                    clink  -a  exa_c
                    clink  -a  map_c

     Notes: 

         - clink links by default with the static library disvc.lib 
           of DISLIN, but this distribution contains also a library
           for dynamic linking (dislnc.lib) and double precision 
           libraries of DISLIN (disvc_d.lib, dislnc_d.lib).

         - If you are using MS Visual Studio 2005 with your Visual
           C compiler, you have to link the Dislin library disvcm.lib
           instead of disvc.lib to your programs. disvcm.lib is
           compiled with the option /MT for using libcmt as runtime
           library instead of libc, which is not included in MS Studio
           2005.  

3.)  Getting a DISLIN License

     DISLIN is free for non-commercial use. Licenses for selling programs
     linked with DISLIN or for using DISLIN in an environment related to
     business are available from the site http://www.dislin.de. 


4.)  Programming with DISLIN

     The software  DISLIN allows users to write graphic programs for
     the Microsoft Windows system  without knowledge of Windows pro-
     gramming.  The programs must be written in the programming lan-
     guage C and compiled and  linked  with  the  Microsoft compiler
     Visual C++.    
     
     Structure of DISLIN programs

     The following example shows the structure of DISLIN programs:

     a) Windows Console Programs

     #include <stdio.h>
     #include "dislin.h"           /* DISLIN  include file  */

     main()
     { metafl ("xwin");     /* Screen output            */
       disini ();           /* Initialization of DISLIN */
       pagera ();           /* plots a page border      */
       complx ();           /* Selects the COMPLX font  */

       messag ("This is a test!", 100, 100);   /* plots a message */
       disfin ();           /* Terminates DISLIN        */
       return 0;            /* End of the program        */
     }


     This example is compiled and linked by Visual C++ to a Windows
     console application. A console is created automatically by
     the program which can be used for input/output with standard
     C functions such as printf and scanf.  

     b) Windows Applications

     #include <windows.h>          /* Windows include file  */
     #include "dislin.h"           /* DISLIN  include file  */

     /* The following routine WinMain replaces the main routine of 
        normal C programs.
     */

     int WINAPI WinMain (HINSTANCE hInst, HINSTANCE hPrevInst,
                         PSTR lpsz, int nShow)
     {

       winapp ("windows");  /* DISLIN function: Warnings are written */
                            /* to a file and the protocol in disfin  */
                            /* is displayed in a widget.             */

       metafl ("xwin");     /* Screen output            */
       disini ();           /* Initialization of DISLIN */
       pagera ();           /* plots a page border      */
       complx ();           /* Selects the COMPLX font  */

       messag ("This is a test!", 100, 100);   /* plots a message */
       disfin ();           /* Terminates DISLIN        */
       return 0;            /* End of the program        */
     }

     This example is compiled and linked by Visual C++ to a Windows
     application. Standard C functions for input/output cannot be
     used. Instead of printf/scanf, DISLIN widget routines can be used. 

