        __       __
        )\\     /((  Version 37.1                            __
       /  \\   /  \\         39.1  __         ________      / \\     ________
      /    \\ /    \\              )\\        )      \\    (   ))    )      \\
     / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
    / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
   / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
 / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
/ //    @ 1995 by    \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
\_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
         sMail:                     eMail:                 _______  ___ _____
     Christian Krapp                                      / __//\ \/ /// __//
     Hagenmähderstr.9   krabbe@informatik.fh-augsburg.de / _//   \  /// _//
   D-86391 Stadtbergen                                  / //__   / /// //__
     (GERMANY)                                          \___//  /_// \___//

--------------------------------------------------------------------------------

Copyright:
  This program and all accompanying files (program-icon) are copyrighted 1995 by
Christian 'cr8y' Krapp! You can  copy these files to your friends as long as the
files are unchanged. It is not allowed to demand a fee higher as media costs and
a (little)  copy-fee. In addition,  no one is allowed to put these  files onto a
PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!

For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!

  This  program isn't  Public Domain or  Shareware. It's is developt as Freeware
Everyone, who use this program, should  send me an postcard or an eMail. (I want
to know, how many (or much? ;^) ) Amiga-Fans use this program).

--------------------------------------------------------------------------------

What is it?
  No: This is not again a program to render 3D pictures! Do you know the
MagicWB-Stuff? (what a question ;^> ) And: I think you know these funny Eye-
programs, which fellow the mouse-pointer! Ok. Than you know MagicEYE. It's an
Eye-program for an MagicWB Workbench. 

--------------------------------------------------------------------------------

4 reasons, why to use this program:

1.) colorized eyes ;^)
2.) automatic window close, when prefs are changed
3.) you can configurate a lot
4.) patch to have an screen-drag MagicEYE-window

--------------------------------------------------------------------------------

What do you need?
  You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
need  at least AmigaOS 2.04  or  higher. Sorry, but  I can't guarantee, that the
version for  AmigaOS 2.04 work, because I  have only an  Amiga with AmigaOS 3.0.
In  addition to the OS you  should run your Workbench with at least 8 colors and
a quadratic resolution (e.g.  640×512).  As  color-palette you  should  use  the
MagicWB-color-palette for  best  results.  Last  but not least you should use an
13 point  high font  for screen title.  This is necassery,  because MagicEYE has
an fixed high of 13 points.

--------------------------------------------------------------------------------

Different program versions:
  It's very simple:  The 'new' AmigaOS 3.0  has some  better functions which are
supported by MagicEYE. And so, I have produced two versions: One for AmigaOS 2.0
(MagicEYE_37) and one for AmigaOS 3.0 (MagicEYE_39) and higher.

--------------------------------------------------------------------------------

How to install?
  Nothing simpler than that: you copy only the right program-version of MagicEYE
to your WBStartup-directory on you startvolume (disk, hd...). That's it :-]

--------------------------------------------------------------------------------

How to use?
  You can run this program only from the Workbench (or the WBStartup directory).
If you run it from a Shell, nothing happens! Also, all configuration is done in
the icon ToolType:

  DONOTWAIT       : This has nothing  to do with  MagicEYE. It's only a flag for
                    Workbench.
  WIN_X           : Where  do you want to place  the MagicEYE-window?  Here  you
  WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
                    WIN_Y=1
  DELAY           : With this  value  you define how  long the  window disapear,
                    when the preferences of the system are changed. The  default
                    value is 5 seconds.
  PRIORITY        : Defines the task-priority.  This value should  be lower than
                    0, so, other programs (which need the system-time) gets more
                    system-time. The default value is 0 (program) or -5 (Icon).
  DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
                    drag the  screen  with the  MagicEYE-window.  So there is no
                    different on  the screen-title,  when  you want to drag down
                    the screen (funny). Default is off!
  SLEEPY          : This value  is needed, to define  how  often  the  Eyes  are
                    closed.  Default is 40.  If you take a lower value, the Eyes
                    are often  closed, an higher value means: close Eyes seldom.
                    (Try different values!)
  SLEEP_PERIOD    : This flag define the  time that  the program  wait,  till it
                    close  the Eyes,  when the  mouse  isn't moved! Default: 50.
                    (Try different values!)
  FRESHUP_PER_SEC : This value  define,  how  often the  Eyes  are rendern  in a
                    second. So, you have here the posibility to define, how much
                    system-time is used from MagicEYE  (and of course  with  the
                    PRIORITY).  An example: If you give as FRESHUP_PER_SEC an 1,
                    the Eyes is renderd  once in a second. Default  is 50 (=> so
                    MagicEYE renders the Eyes 50 times a second). The max. value
                    for this flag  is 100 (Or have  you an screen-mode with more
                    then 100Hz?). 

  So, that's it.  You know now all the features  of MagicEYE. Or...? You want to
know, how to exit this mega mighty program? Is it true? Do you want to quit this
program?  Ok. I see... You want  know  this (very stupied :-|) feature: activate
the MagicEYE-window (place the mouse-pointer over one eye and hit the left mouse
button) and press the right mouse button. Now, the MagicEYE's should disappear.

--------------------------------------------------------------------------------

What can be made better?
  * More funny things with the Eyes (roll the Eyes and so on).
  * In the MagicEYE-verion for AmigaOS 3.0 and higher there is a function missed
    which recolorize  the Eyes on  screens with  an  other  color-palette.  This
    feature isn't implemented and I  only program it, when there are enough user
    who want this feature.
  * It is possible, that there exists errors (undocumented features ;^) or bugs)
    which we doesn't want!

--------------------------------------------------------------------------------

For any reaseon (bug-report, ideas ...) try this:

                 sMail:           Christian Krapp
                                  Hagenmähderstr. 9
                                D-86391 Stadtbergen
                                  (GERMANY)
                 eMail:           krabbe@informatik.fh-augsburg.de

--------------------------------------------------------------------------------

History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))

Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation)
Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
