MCEDIT.DOC

Mouse Cursor Editor Version 1.0, Copyright 1991 Bob Hayes

PURPOSE:    Mouse Cursor Editor is a programming tool that will enable
            developers to graphical create mouse cursors.

REQUIREMENTS: Microsoft compatible mouse and EGA graphics.

USE:  mcedit (there are no command line options)


      Mouse Cursor Editor is designed to make it easier for developers to
create custom mouse cursors for programs that make use of a Microsoft
compatible mouse.  This program will save you the time of manually coding the
screen and cursor masks.  This program will not change the shape of cursor in
compiled programs.  This program does not do Windows 3.0, Windows uses a
different method of incorporating a mouse cursor into a program.


EXAMPLE OF AN EDITING SESSION

      1.    At the DOS prompt type 'MCEDIT' and press 'Enter'.  MCEDIT.EXE will
            need to be in a directory on your path.  If your system has a
            Microsoft compatible mouse driver loaded and is capable of
            displaying 640x350x16 EGA graphics, the program will begin.

      2.    Read the copyright/registration notice on the screen.  Click the
            left mouse button to continue (In this documentation 'click' will
            refer to the left button).  

      3.    Click on the 'Help...' menu item.  The first help screen will
            appear.  Click to view the second help screen.  Click to clear the
            help screen.

      4.    The default mouse cursor is shown in the edit grid at startup. 
            Click on the 'Clear' menu item.  This clears the cursor out of the
            edit grid.  You are not prompted to save it.

      5.    Click on the word 'Black' in the color selection box.  A check mark
            should be next to the colored box.

      6.    Move the mouse cursor to the edit grid.  Press the left button. 
            The square under the pointer should turn black.  Move the mouse
            around coloring more squares.

      7.    Repeat steps 5 and 6 with the other three colors: White, Unchanged,
            and Inverted.

      8.    Click on the 'Masks' menu item.  The screen and cursor masks for
            the cursor in the edit grid will appear on the left side of the
            screen.

      9.    Click on the 'Test' menu item.  The sixteen basic screen colors
            will appear on the right side of the screen.

      10.   Click the right mouse button.  The mouse cursor becomes the one in
            the edit grid.  Use the test color bars to see how the cursor looks
            over various colors.  Click the right button again to return to the
            default cursor.

      11.   Click on the 'Output...' menu item.  Type a name for the cursor in
            the dialog box.  Press the enter key.  Select the form you want the
            cursor output in.  All of the files are plain text files.  Click
            the 'OK' button.  NOTE: You do not need to display the masks in
            order to output the cursor.  The file will over write a file with
            the same name.

      12.   Click the 'About...' menu item.  Write down my name and address and
            send me $5.

      13.   Click the 'Exit' menu item to exit the program.


FILELIST

The following files should be in MCEDIT10.ZIP:

BLACK    PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
BOBMOUSE PAS      TP 5 source for BOBMOUSE unit.
BOBMOUSE TPU      TP 5 mouse unit. (needed to compile MCEDEMO)
BOBSIGN  OBJ      Object file of signature (needed to compile MCEDEMO)
DEFAULT  PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
EGAVGA   OBJ      Object file of EGAVGA.BGI. (needed to compile MCEDEMO)
HAND     PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
HANDSCAN PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
HORSIZE  PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
HOURGLAS PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
INVERSE  PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
MAGGLASS PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
MCEDEMO  EXE      A demo program showing the use of some functions.
MCEDEMO  PAS      Pascal source for MCEDEMO.EXE. (needed to compile MCEDEMO)
MCEDIT   DOC      This file.
MCEDIT   EXE      The Mouse Cursor Editor.
SEETHRGH PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
TEXTT    PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)
VERTSIZE PAS      Pascal source for a mouse cursor. (needed to compile MCEDEMO)


SHAREWARE
      This copyrighted program is being distributed as shareware.  You may try
this program, and if you like it, or find it useful, and wish to continue using
it, you are expected to register with the author.  You are free (and
encouraged) to copy this program and distribute it to anyone, as long as no fee
is charged for the program, and as long as this documentation file and all of
the files listed in the file list section of this document are included.  The
registration fee is $5.  To register, send your name, address, the program name
and version, where you got the program, and $5 to:

            Bob Hayes
            10104 Blue Tee Terr.
            Gaithersburg, MD  20879

All registered users will receive the next version when it is available.


DISCLAIMER

      This program is being distributed as is.  There are no warranties
expressed or implied.  The author is not responsible for any damage, injury or
death caused directly or indirectly by this program.


If you have any questions or comments about the program, please send them to
the above address or contact me at 71224,3202 on CompuServe.

                                    Thanks,
                                    
                                    Bob Hayes



Product names are trademarks or registered trademarks of their respective
holders.