home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ansi / ansims10.arj / ANSIMS.DOC next >
Encoding:
Text File  |  1991-04-23  |  11.6 KB  |  220 lines
  1.                                ANSI Mouse 1.0
  2.                                 by Alan Deala
  3.                                Sacramento, CA   
  4.  
  5. PROGRAM REQUIREMENTS
  6.  
  7.     This program requires:  An IBM compatible computer
  8.                             A Microsoft compatible mouse
  9.                             At least 128K of free memory
  10.  
  11.   I have tested this program on CGA & Super-VGA monitors with no problems.
  12. It may also work on a monochrome monitor, but I have no way of knowing that
  13. for sure.
  14.  
  15. PROGRAM FUNCTIONS
  16.  
  17.   Once you pass the opening credits screen, you will see the drawing
  18. workspace with a menu-bar on the top line.
  19.  
  20.   The Drawing Workspace:
  21.   ---------------------
  22.     The drawing workspace occupies rows 2 through 25 and columns 1 through
  23. 79 on your screen. By moving the mouse, you move the drawing cursor around
  24. the screen. Pressing the left mouse button will draw the current character
  25. (displayed on the right side of the menu-bar) in the current color (also
  26. displayed on the far right of the menu-bar) at the spot under the drawing
  27. cursor. Pressing the right mouse button will erase (draw a blank space)
  28. the spot under the drawing cursor in the default color (also show at the
  29. top of the screen on the menu-bar).
  30.   By pressing a mouse button on the top line, you can activate the menu-
  31. bar.
  32.  
  33.   The Menu-Bar:
  34.   ------------
  35.    By 'clicking' on the top line, you activate the menu-bar. You can
  36. also activate the menu-bar by typing the first letter of the desired
  37. option (ie. hitting the 'F' key on the keyboard will bring up the 'File'
  38. menu). Once the menu-bar is activated, you can perform these menu functions.
  39.  
  40.    The File Menu=
  41.  
  42.                  Load:  Clicking on this choice will bring up a window
  43.                         displaying the current directory. You can use
  44.                         the keyboard arrows or mouse to manuever around
  45.                         the list of files. By clicking on a file (or by
  46.                         hitting the return key) you can load that file
  47.                         into the drawing workspace. You can also display
  48.                         a different sub-directory by clicking on its
  49.                         name.
  50.  
  51.                   Save: You can save the current contents of the drawing
  52.                         workspace by choosing this option. You will need
  53.                         to supply a file name to save it under (including
  54.                         the file extension). You will be given the option
  55.                         of saving the screen as an ANSI screen a 77 column
  56.                         ANSI screen or a Normal screen. Saving it as an
  57.                         ANSI screen will include all the necessary ANSI
  58.                         codes for color & positioning. Saving it as a 77
  59.                         column ANSI screen will keep all the characters &
  60.                         ANSI codes within the first 77 columns (useful for
  61.                         offline mail readers, for example). Saving it as
  62.                         normal will exclude all the special ANSI codes from
  63.                         the drawing. The drawing will be DISPLAYED (via
  64.                         the TYPE command) as a 79 column x 24 row text
  65.                         file/ANSI picture in any case.
  66.  
  67.                   New:  This command will clear the drawing workspace in
  68.                         the default color.
  69.  
  70.                   Quit: This option will exit you from the program (if
  71.                         changes have been made to the drawing since you
  72.                         last saved it, ANSI mouse will verify that you
  73.                         wish to exit without saving the changes).
  74.  
  75.    The Color Menu=
  76.  
  77.                  Set Current: By choosing this, you can specify the
  78.                               'Current' color. This is the color you
  79.                               draw in when you press the Left mouse button.
  80.                               Use the mouse or keyboard arrow keys to move
  81.                               around the color selection menu and click
  82.                               on the left mouse button (or hit Enter) to
  83.                               choose the color you want. Or hit the right
  84.                               mouse button (or hit the space bar) to
  85.                               cancel your selection.
  86.  
  87.                  Set Default: This function works the same as the Set
  88.                               Current function. The only difference is that
  89.                               you are choosing the 'default' color instead.
  90.                               The default color determines which color will
  91.                               be used for for clearing the screen (the New
  92.                               function under the File menu) and for erasing
  93.                               a space using the right mouse button in the
  94.                               drawing workspace. It also determines the
  95.                               Wash color (see below).
  96.  
  97.                  Wash:        By choosing the wash function, you can change
  98.                               the color of a space on the drawing workspace
  99.                               without changing the actual character in that
  100.                               space. By choosing the Wash function and then
  101.                               re-entering the drawing workspace, you will
  102.                               notice that your drawing cursor is now diamond
  103.                               shaped (this is to remind you that you are in
  104.                               Wash mode and not normal drawing mode). While
  105.                               you are in Wash mode, you press the left mouse
  106.                               button to change the color of the space under
  107.                               the drawing cursor from the Default color to
  108.                               the Current color (if the space under the
  109.                               cursor is not in the Default color, nothing
  110.                               will happen). The right mouse button will
  111.                               change the spot under the Wash cursor from
  112.                               the Current color to the Default color.
  113.  
  114.    The Symbol Menu=
  115.  
  116.                   By choosing this option, you can change the current
  117.                   symbol. You can use the keyboard or mouse to move
  118.                   around the symbol selection menu. Click on the left
  119.                   mouse button (or hit the Return key) to select a new
  120.                   symbol or click on the right mouse button (or hit the
  121.                   space bar) to cancel your selection.
  122.  
  123.    The Block Menu=
  124.  
  125.                  This is the menu area where you can make changes on
  126.                  large areas of the screen. You will be asked to define
  127.                  the Block area by clicking on the upper left corner
  128.                  and lower right corner of the area. This area can be
  129.                  as small as a single square or as big as the entire
  130.                  drawing workspace. The block area boundary will then
  131.                  be drawn as a box (even though the symbols on the outside
  132.                  edge of the block are covered by the box, they are still
  133.                  there. They are just temporarily covered by the lines of
  134.                  the box).
  135.  
  136.                  Copy: You will be asked to define the block area and then
  137.                        you will have to point to the upper left corner
  138.                        of the area you want the block copied to. A new box
  139.                        will be drawn showing you exactly where the block
  140.                        copy will end up. Hit the left mouse button (or the
  141.                        Enter key) to accept this location. Hit the right
  142.                        mouse button (or the Esc key) to choose a different
  143.                        location for the block. The copy function leaves the
  144.                        old block where it was and writes a copy of the block
  145.                        into the new location. The new copy will overwrite
  146.                        anything that happens to be underneath it (including
  147.                        the original block, if it happens to be in the way!)
  148.  
  149.                  Move: The move functions similar to the copy. The
  150.                        difference is that a copy of the block will NOT be
  151.                        left at the original location. It also overwrites
  152.                        anything that it is moved on top of. (The spot that
  153.                        the block is moved from will be 'erased' in the
  154.                        default color).
  155.  
  156.                  Delete: This will erase the area under the block in the
  157.                          Default color.
  158.  
  159.                  Wash: The block Wash will replace all occurences of the
  160.                        Default color in the block area with the Current
  161.                        color. The symbols will remain unchanged. Only
  162.                        the color will change. Colors within the block that
  163.                        do not match the Default color will be unaffected.
  164.  
  165.    The Text Menu=
  166.  
  167.                 This is the option that allows you to add lines of text
  168.                 anywhere in the drawing workspace. When you choose this
  169.                 option, the drawing cursor will change to a text location
  170.                 cursor (a small 'face' symbol). Move this cursor to the
  171.                 point where you want to start you text and click the left
  172.                 mouse button (hit the right mouse button to cancel the
  173.                 Text function). The cursor will change to a blinking text
  174.                 cursor to show that you are in the text editing mode.
  175.                 You may now type your text in and move around the screen
  176.                 using the arrow keys. Hitting return will move the cursor
  177.                 down a line and line you up with the spot where your text
  178.                 started. You can click on the left mouse button to get
  179.                 your text location cursor back (and move to another part
  180.                 of the drawing workspace to do more text entry) or
  181.                 click on the right mouse button to return to normal
  182.                 drawing mode (your cursor will change back to the normal
  183.                 non-blinking cursor).
  184.  
  185. ----------------------------------------------------------------------------
  186.  
  187.   This program was written using Turbo Pascal 5.5 and the Technojock Turbo
  188. Toolkit 5.0
  189.  
  190.   This software may be freely copied & distributed under the following
  191. conditions:
  192.  
  193.               1) No money (other than to cover the cost of copying and/or
  194.                  shipping, $5 max) may be charged for this program.
  195.               2) This program may not be altered without permission of
  196.                  the author.
  197.               3) This document (ANSIMS.DOC) and file ANSIMS.EXE must be
  198.                  distributed together.
  199.  
  200.   This product is provided "as is" without any warranty. By using this
  201. program you agree to assume full responsibilty for any damage or loss
  202. caused directly or indirectly through the use of this program.
  203.  
  204.   I do not require you to send me any money to register this program.
  205. If you would like to donate a sum to your favorite charity, that is
  206. acceptable.  Future versions may require registration.
  207.  
  208.   If you have any questions or suggestions for improvements, please
  209. contact me at:
  210.  
  211.    Hackney's Hideaway BBS, Sacramento, CA
  212.    (916) 961-1042  300/1200/2400/N/8/1
  213.  
  214. or through one of the echoed Pascal conferences (such as InterLink,
  215.                                                    Smartnet, etc.)
  216.  
  217. Or write me at:
  218.  
  219.       1795 Urbana Way
  220.       Sacramento, CA 95833