JEyes.doc                   JDGJr                   920712
    JEyes Version 3.0

    JEyes (pronounced 'jies') opens a sizable window on the Workbench
    screen containing eyes which follow the cursor about the screen.

              That's it - nothing very productive here!

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

    Operation:

    JEyes' operation is fairly configurable, with both Workbench tooltypes
    and CLI modifiers supported. Current modifiers are:

    LeftEdge        Initial window left position
    TopEdge         Initial window top position
    Width           Initial window width (subject to minimum limitiation)
    Height          Initial window height (subject to minimum limitiation)
    WindowTitle     Override of window title
    NoCloseGadget   Window cannot be closed (nasty, nasty)
    DontScalePupil  Always uses small pupil
    EyeCount        Not all beings have *2* eyes!
    Priority        Execution priority (Default: -1)
    Mascara         Eye outline drawn thicker
    PubScreen       Name of screen to open on (Default: Workbench)
    Brows           Specification of eyebrow orientation (see below)


    Workbench tooltypes:
    --------------------

    Any of the above modifiers may be specified in the tool's information
    requester. 'NoCloseGadget', 'Mascara', and 'DontScalePupil' modifiers
    need no setting; the other modifiers may be specified in either of the
    following formats:

            "modifier=<setting>"    or  "modifier <setting>"

    If the WindowTitle setting contains more than one word, it must be
    enclosed in single quotes. All other modifiers expect integer settings.


    CLI parameters:
    ---------------

    All modifiers may be specified on the command line with the format

            "modifier=<setting>"

    'WindowTitle' and 'PubScreen' cannot include spaces when specified
    from the CLI.

    'Brows' specification: The brow for each eye may have a unique
    orientation. This is controlled by setting this modifier to a string
    of digits, 2 for each eye, which control how the end-points of the
    eyebrow are positioned. The valid positional values are: 0 (none),
    1 (raised), 2 (middle), or 3 (lowered). See examples below:

                         \ /         - -         / -        
        example:         O O         O O         O O

        specification:  '1331'      '2222'      '3122'

    The string specified for the 'Brows' modifier is applied from the
    leftmost eye towards the right, and will allow for non-browed eyes
    if the string is exhausted before the each eye has been given a
    setting. If both end-points for an eye are 0, its brow will not be
    drawn.

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

    Future direction:

    I'm open to suggestions concerning additions to JEyes. It's currently
    simple enough that I can treat it as an interesting diversion from my
    primary obligations, so give me something to add.

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

    Revision History:

    3.0:
      New Feature(s):
        1. Operates under AmigaDOS 1.3.
        2. 'PubScreen' parameter added (V37+ libraries only).
        3. 'Brows' specification added.

    2.1: (920318)
      Bug fix(es):
        1. Added WaitBlit() to avoid MungWall complaints.
      New Feature(s):
        1. 'Priority' parameter added.
        2. 'Mascara' parameter added.
        3. Added string for use with AmigaDOS' Version command.

    2.0: (920310)
        First general distibution version.

    -----------------------------------------------------------------------
    
    Thanks to:

        Pat Brouillette for the NoCloseGadget idea.
        Chris Nicotra for the XEyes source, and the trig discussions.
        Mike Weiblen for insisting on 'Mascara'.

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

    Other necessities:

        Conceived, produced, written and funded by:
    
            John D. Gerlach, Jr             BIX: jgerlachjr
            11826 Federalist Way
            Apt #23
            Fairfax, VA 22030

        This program may not be commercially distributed without my
        consent, except when included in the Fred Fish collection of
        Amiga software.

        I may be contacted at the above addresses if any other use of
        this program is desired.