home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / xbase / library / clipper / clock / readme.1st < prev    next >
Encoding:
Text File  |  1992-08-20  |  2.9 KB  |  63 lines
  1.  
  2.  
  3.  
  4.                                              Gallagher Computing Corp.
  5.                                                     Kevin S. Gallagher
  6.                                                         CIS 70034,2313
  7.                                                   clock by: Ben Echols
  8.  
  9.  
  10.  
  11.              Clock function for Clipper 5.1 (or higher)
  12.              ------------------------------------------
  13.  
  14.    This function is not PUBLIC DOMAIN, but may be used as long as it is
  15.    for your own personal use, anything other than personal use, then
  16.    you should send me five dollars (ten dollars for source code .asm)..
  17.    
  18.    PS. If you can not afford the $5.00's no sweat, just send comments!
  19.  
  20.    I really like to hear feedback (good or bad) about the clock if you
  21.    have the time to either leave a message on Compuserve or send a post
  22.    card with comments.
  23.  
  24.  
  25.  
  26.    This clock was written in assembly language, and adheres to Clipper's
  27.    extend system. Ticker.obj has two function calls, one (1) to install
  28.    the "event driven" clock, and (1) one to uninstall the clock. Both of
  29.    them will return "nErrorlevels" (see .prg files).  The clock can be
  30.    installed many times in a application, but MUST be uninstalled prior
  31.    to exiting the application, or the computer system will crash.......
  32.  
  33.    There are two (2) parameters that the install function takes, which
  34.    are <nRow>,<nCol> while the uninstall function takes none.
  35.  
  36.  
  37.    nVar := BK_TICKINS( <nRow>, <nCol> )  --> nErrorlevel
  38.  
  39.    nVar := BK_TICKREM()                  --> nErrorlevel
  40.  
  41.    If the positioning  coordinates are  invalid the  clock will  not be
  42.    installed.  If the clock is  already installed, and  you  attempt to
  43.    place the clock on the screen again it will know that it's already
  44.    installed, hence will not reinstall itself. The colors used are the
  45.    colors at <nRow> , <nCol> which is nice if you are  using a  screen
  46.    saver, such as one of the ones from  GRUMP.LIB  "Grumpfish library",
  47.    that will  change colors randomly.  If you were using one of clock 
  48.    functions from another third party library  (not naming any because
  49.    they do get the job done, and its not nice to compare um this way!)
  50.    they would not inherit the new colors while the screen saver was in
  51.    use. 
  52.   
  53.    I have tested the clock with EBASE50.LIB, FLEXFILE.LIB,  GRUMP.LIB,
  54.    NANFOR.LIB and also OVERCL.LIB and have had no problems with any of
  55.    these libraries (FUNCKY and NT250 libraries have clocks already)!!!
  56.  
  57.    =====================================================================
  58.    Gallagher Computing will be placing several other functions written
  59.    in assembly, for Clipper 5.x within the coming months. We are working
  60.    on several different functions at the present time, but want to keep
  61.    them a under-wraps for now...
  62.    =====================================================================
  63.