home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / DATABASE / WIPE112.ZIP / WIPEOUT.DOC < prev   
Encoding:
Text File  |  1991-11-30  |  43.8 KB  |  1,464 lines
  1.  
  2.  
  3.  
  4.  
  5.        ┌─┬┬─┐ ┬┬  ┬ ┬┬──┐       ┬┬ ┬ ┬ ┬┬ ┬┬──┐ ┬┬──┐ ┌┬──┐ ┬┬  ┬ ┌─┬┬─┐
  6.      ││   ││  │ ││          ││ │ │ ││ ││  │ ││    ││  │ ││  │   ││
  7.      ││   │├──┤ │├─         ││ │ │ ││ │├──┘ │├─   ││  │ ││  │   ││
  8.      ││   ││  │ ││          ││ │ │ ││ ││    ││    ││  │ ││  │   ││
  9.      ┴┴   ┴┴  ┴ ┴┴──┘       └┴─┴─┘ ┴┴ ┴┴    ┴┴──┘ └┴──┘ └┴──┘   ┴┴
  10.              ┬┬─   ┬┬ ┬┬─┐  ┬┬──┐ ┌┬──┐ ┬┬──┐ ┬  ┬┬
  11.              ││    ││ ││ │  ││  │ ││  │ ││  │ │  ││
  12.              ││    ││ │├─┴┐ │├─┬┘ │├──┤ │├─┬┘ └──┤│
  13.              ││    ││ ││  │ ││ │  ││  │ ││ │     ││
  14.              ┴┴──┘ ┴┴ ┴┴──┘ ┴┴ ┴─ ┴┴  ┴ ┴┴ ┴─ └──┴┘
  15.  
  16.  
  17.               The Wipeout Library v1.12
  18.            with Clipper(tm) S'87 and 5.01 Gestations
  19.  
  20.               -----------------------------------
  21.                  Written by Mark Lussier
  22.                Copyright (c) 1991 by Mark Lussier
  23.                   All Rights Reserved
  24.                ----------------------------------
  25.  
  26.  
  27.                            European Distribution by:
  28.  
  29.                            INFO-WARE G. Kellinghuson
  30.                            Grasstraße 18
  31.                            D-2000, Hamburg 50
  32.                            Germany
  33.  
  34.                      +49 40 89094161 - Voice Sales Line
  35.                      +49 40 89094111 - Fascimile (FAX) Line
  36.              +49 40 8902985  - BBS (HST DS)
  37.  
  38.  
  39.   " It's a complex of functions to use as CLIPPING tool of screens and some
  40.     other screen manipulations. For somebody who wants to implement in own
  41.     program ingenious way of creating a screens, switching between them is
  42.     this library absolutely MUST."
  43.                       - Review in ClipBBS Issue #11
  44.                       (a European Newsletter)
  45.  
  46.  
  47.                This program is being distributed as Shareware
  48.                         This program is NOT free
  49.  
  50.  
  51.           NOTE: All warranty specifications apply to U.S. versions of
  52.                 The Wipeout Library.
  53.  
  54.  
  55.  
  56.          Clipper is a registered trademark of Nantucket Corporation
  57.  
  58.  
  59. DISCLAIMER OF WARRANTY
  60. ----------------------
  61.  
  62. This software program and documentation ("The Wipeout Library")
  63. is being offered for evaluation purposes "AS IS" and without
  64. warranties as to performance and merchant-ability. By using The
  65. Wipeout Library, you are expressly releasing Mark Lussier from any
  66. liability resulting from the use of this software and documentation.
  67. The user must assume the entire risk of using The Wipeout Library.
  68. Because of the diversity of conditions, hardware and operating
  69. environments under which The Wipeout Library may be used, no warranty
  70. of fitness for a particular purpose is offered. The user is advised to
  71. test and supervise The Wipeout Library thoroughly before relying on it.
  72.  
  73.  
  74. LICENSE AGREEMENT
  75. -----------------
  76.  
  77. 1) The Wipeout Library is being distributed as Shareware. This
  78.    program is not free. You are granted a limited license to
  79.    evaluate The Wipeout Library for a period not to exceed 30 days.
  80.    After 30 days, you must either pay for and register your copy of
  81.    The Wipeout Library, or immediately discontinue its use and
  82.    remove it from your computer.
  83.  
  84. 2) You may keep as many backup copies of The Wipeout Library as
  85.    you wish, but you may not run The Wipeout Library simultaneously
  86.    on more than one computer. Additionally, you are granted the
  87.    right to share The Wipeout Library with others, as long as you
  88.    distribute the The Wipeout Library archive exactly as you
  89.    received it, with all associated files included.
  90.  
  91. 3) Under no circumstances may you charge a fee or recieve any
  92.    other form of consideration for distributing the The Wipeout
  93.    Library files without the express written consent from the
  94.    copyright holder, Mark Lussier. However, a small ammount not
  95.    to exceed $5 (USD) may be charged by Organizations to cover
  96.    the costs of Diskette's, Packaging and Shipping.
  97.  
  98.  
  99. WHAT YOU RECEIEVE AFTER REGISTRATION
  100. ------------------------------------
  101.  
  102. Once your registration of The Wipeout Library has been completed,
  103. you will recieve on diskette the latest version of The Wipeout
  104. Library with the guilt screen removed as well as printed
  105. documentation. You shall recieve all future updates and revisions
  106. on disk at no charge for 90 days from the Date of Purchase (DOP).
  107. Online upgrades will also be made available FREE of charge to ALL
  108. registered users for the lifetime or the product. Norton Guide (NG)
  109. documentation will also be made available at no extra charge.
  110.  
  111. TECHNICAL SUPPORT
  112. -----------------
  113.  
  114. Registered owners of The Wipeout Library are granted FREE
  115. Technical Support for an unlimited time. However, all technical
  116. support questions and inquires must be made within the below
  117. listed guidelines. (Note: U.S.A. Versions Only)
  118.  
  119. o    Technical Support is available Monday thru Friday between
  120.      the hours of 8:00am and 5:00pm Pacific Standard Time (PST).
  121.      This is not my full time job and an answering machine will
  122.      in most cases take the message. ALL calls will be returned
  123.      with 24 hours.
  124.  
  125. o    Voice telephone Technical Support is only available on the
  126.      following phone number : (415) 949-4478. If no one is available
  127.      an answering machine will be active. PLEASE NOTE that this is my
  128.      private Telephone number and I do sleep sometimes!
  129.  
  130. o    Technical questions and inquires received through the Mail
  131.      will be responded to as quickly as it possibly can.
  132.  
  133. o    As of this time there are NO nationl network conferences
  134.      that have been designated to The Wipeout Library. Please
  135.      refrain from posting public messages on conferences of other
  136.      topics. There is however a conference dedicated to The
  137.      Wipeout Library on our support system, Database BBS. Please refer
  138.      to the section of this document regarding "Contacting Authors".
  139.  
  140. o    Electronic support is available through our own Bulletin
  141.      Board System (BBS) and on Compuserve mail and MCI Mail.
  142.      Please  refer to the 'Contacting The Author' section for mail
  143.      box address's and number.
  144.  
  145.  
  146. CONTACTING THE AUTHOR
  147. ---------------------
  148.  
  149. The Author, Mark Lussier, can be contacted by any of the following
  150. means:
  151.  
  152. By Telephone and Mail:         Electronically:
  153.  
  154. Mark Lussier                   The Database BBS ( Sysop: Michael Walter )
  155. 2700 Del Medio Court #307      (908) 735-2180 Node #1 - Hayes sm2400
  156. Mtn. View, CA 94040            (908) 735-2185 Node #2 - Hayes v9600
  157. (415) 949-4478                 (908) 735-2707 Node #3 - USR HST DS v.32
  158.                     *** An ASP Approved BBS ***
  159. In Europe:
  160.  
  161. Max Bressler
  162. INFO-WARE G. Kellinghuson      +49 40 89094161  (Voice Sales Line)
  163. Gasstraße 18                   +49 40 89094111  (Fascimile Line)
  164. D-2000, Hamburg 50             +49 40 8902985   (BBS)
  165. Germany
  166.  
  167. We can also be found lurking the Clipper and dBASE conferences on
  168. the RIME, FIDO, Smartnet, Interlink and the DevNET networks as well of
  169. course as NANFORUM on Compuserve.
  170.  
  171.                                        11/91
  172.  
  173.          The Wipeout Library Registration Form
  174.          -------------------------------------
  175.  
  176.  
  177.     Name   : ___________________________________________
  178.  
  179.     Address: ________________________________________
  180.  
  181.     City   : ________________________  State _______  ZipCode _____________
  182.  
  183.     Country: ________________________
  184.  
  185.     Phone #: Day _____________________ Evening _______________________
  186.  
  187.     Fascimile :  ________________________
  188.  
  189.     Prefered Diskette Type:  ( ) 5.25 DD   ( ) 3.5 DD
  190.  
  191.  
  192.      Version name                             Copies     Price    Extended
  193.  
  194.  
  195.     The Wipeout Library for Clipper 5.01/S87.  _____    $  19.95   _______
  196.  
  197.     The Wipeout Library COMPLETE Source Code.  _____    $  59.95   _______
  198.  
  199.     CA. residents add 8% sales tax ............................    _______
  200.  
  201.     TOTAL  .................................................... $  _______
  202.  
  203.     Please remit this form with payment in US dollars only to:
  204.  
  205.      Mark Lussier                              * CHECKS PAYABLE TO *
  206.      2700 Del Medio Court, Ste. 307               'Mark Lussier'
  207.      Mountain View, CA  94040
  208.  
  209.      -----------------------------------------------------------------
  210.      (  )  YES!  Please additionaly enclose Demo Disks of your other
  211.          Clipper Addon Products. ( FREE of Charge! )
  212.      (  )  NO!   Please DO NOT send me any Demo Disks.
  213.      -----------------------------------------------------------------
  214.  
  215.  
  216. SYSTEM REQUIREMENTS
  217. -------------------
  218.  
  219. Compatability
  220. -------------
  221.  
  222. The Wipeout Libraries have been tested under both Clipper S'87
  223. as well as Clipper 5.01. They have been found to perform without
  224. problem under either version of the compiler. The Clipper 5.01
  225. version is a fully Rewritten optimized product, and is not just
  226. recompiled Summer'87 code. Both version are provided with the
  227. upon registration of The Wipeout Library.
  228.  
  229. Compiler Specifics
  230. ------------------
  231.  
  232. The Wipeout Library requires that both CLIPPER.LIB and EXTEND.LIB
  233. be linked in also. If using WIPES87R.LIB (S'87), the library must
  234. be linked between the two Clipper libraries, for example.
  235.  
  236. In S'87:
  237.  
  238.   PLINK86 FI DEMO LIB \CLIPPER\CLIPPER, WIPE501R, \CLIPPER\EXTEND
  239.  
  240. Under Clipper 5.01, this link will suffice
  241.  
  242.   RTLINK FI DEMO5 LIB WIPE501R
  243.  
  244. The Wipeout Library has been tested and found to be fully overlayable
  245. with such linkers as Blinker or Warplink.
  246.  
  247.  
  248. DEMONSTRATION LIBRARY
  249. ---------------------
  250.  
  251. If you are using the demo version (WIPExxxD.LIB) of The Wipeout
  252. Library you have available all of the functions found in the
  253. registered version. This library is not crippled except with
  254. the simple exception that the WIPE_INIT() function must be called
  255. prior to ANY other call to a Wipeout Function. This function will also
  256. display a NON destructive message that will display for 10 seconds at
  257. the time of execution. Registration will remove the need for the
  258. WIPE_INIT() call.
  259.  
  260. FUNCTION LIST AND DESCRIPTIONS
  261. ------------------------------
  262.  
  263. To make the learning curve as small as possible, as well as to provide a
  264. concise, detailed and organized function documentation, we have aloted
  265. a printed page for EVERY function call. Once you see exactly what we
  266. document, we are sure you will realize and appreciate the necessity.
  267.  
  268. The function documentation uses certain definitions and syntax that
  269. require some explaining.
  270.  
  271. <...>  Specifies a Parameter. The listed parameter will be prefaced with
  272.        a Hungarian Notation type identifier. These are  C - Character
  273.                             N - Numeric
  274.                             L - Logical
  275.                             A - Array
  276.  
  277.        Example : Function( <nPOS>, <cTEXT>, <lTRUE> )
  278.  
  279. [...]  Specifies that this paramter is Optional. In almost all of the
  280.        functions in The Wipeout Library, ALL options are optional. We
  281.        use a nice default setting that allows for this. Please refer to
  282.        the individual function documentation for details.
  283.  
  284.  
  285. ** IMPORTANT : Not all function support the various video modes other than
  286.            80x25 in Clipper 5.01. Please refer to the 'Special Note' of
  287.            each function description as to it's support of video modes.
  288.  
  289.  
  290.  
  291. Function     :  ALLIN()
  292.  
  293. Syntax       :  ALLIN( [<cColor>], [<nDelay>] )
  294.  
  295. Description  :  ALLIN() performs an all four corner to center style
  296.         screen wipe. A 'Sucking In' effect.
  297.  
  298. Parameters   :  <cColor> is the color to use for the wipe.
  299.         <nDelay> is the delay to adjust the wipe speed. Example
  300.              1 to 1000 is nDelay of 10.
  301.  
  302. Defaults     :  <cColor> is "W+/N"
  303.         <nDelay> is 20
  304.  
  305. Requires     :  Nothing
  306.  
  307. Returns      :  Nothing
  308.  
  309. Special Note :  Supports ALL Clipper video modes.
  310.  
  311.  
  312.  
  313. Function     :  BLINDDN()
  314.  
  315. Syntax       :  BLINDDN( [<cColor>], [<nDelay>], [<lScreen>] )
  316.  
  317. Description  :  This wipe is a full horizontal top and bottom to center
  318.                 screen wipe.
  319.  
  320. Parameters   :  <cColor>  is the color to use for the wipe.
  321.         <nDelay>  is the delay to adjust the wipe speed. Example
  322.               1 to 1000 is nDelay of 10.
  323.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  324.               that there is a SAVESCREEN() in the stack to
  325.               use in a WipeOn effect.
  326.  
  327. Defaults     :  <cColor> is "W+/N"
  328.                 <nDelay> is 10
  329.                 <lScreen> is optional and set NIL or .F.
  330.  
  331. Requires     :  a call to HSAVE() if the <lScreen> parameter is going to
  332.         be used in the WipeOn effect.
  333.  
  334. Returns      :  Nothing
  335.  
  336. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  337.                 entry holding the data from the HSAVE() call. Use HREL()
  338.                 to clear the area and make way for another call to
  339.                 HSAVE()
  340.  
  341.         Supports ALL Clipper video modes.
  342.  
  343.  
  344. Function     :  BLINDL()
  345.  
  346. Syntax       :  BLINDL( [<cColor>], [<nDelay>], [<lScreen>] )
  347.  
  348. Description  :  Performs a 'Venetian Blind' screen wipe that goes
  349.                 in a Left to Right fashion.
  350.  
  351. Parameters   :  <cColor>  is the color to use for the wipe.
  352.         <nDelay>  is the delay to adjust the wipe speed. Example
  353.               1 to 1000 is nDelay of 10.
  354.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  355.               that there is a SAVESCREEN() in the stack to
  356.               use in a WipeOn effect.
  357.  
  358. Defaults     :  <cColor>  is "W+/N"
  359.         <nDelay>  is 2
  360.         <lScreen> is optional and set NIL or .F.
  361.  
  362. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  363.         be used in the WipeOn effect.
  364.  
  365. Returns      :  Nothing
  366.  
  367. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  368.         entry holding the data from the VSAVE() call. Use VREL()
  369.         to clear the area and make way for another call to
  370.         VSAVE()
  371.  
  372.         Supports ALL Clipper video modes.
  373.  
  374.  
  375. Function     :  BLINDR()
  376.  
  377. Syntax       :  BLINDR( [<cColor>], [<nDelay>], [<lScreen>] )
  378.  
  379. Description  :  Performs a 'Venetian Blind' screen wipe that goes
  380.                 is a Right to Left fashion.
  381.  
  382. Parameters   :  <cColor>  is the color to use for the wipe.
  383.         <nDelay>  is the delay to adjust the wipe speed. Example
  384.               1 to 1000 is nDelay of 10.
  385.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  386.               that there is a SAVESCREEN() in the stack to
  387.               use in a WipeOn effect.
  388.  
  389. Defaults     :  <cColor>  is "W+/N"
  390.         <nDelay>  is 2
  391.         <lScreen> is optional and set NIL or .F.
  392.  
  393. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  394.         be used in the WipeOn effect.
  395.  
  396. Returns      :  Nothing
  397.  
  398. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  399.                 entry holding the data from the VSAVE() call. Use VREL()
  400.                 to clear the area and make way for another call to
  401.                 VSAVE()
  402.  
  403.         Supports ALL Clipper video modes.
  404.  
  405.  
  406. Function     :  BLINDUP()
  407.  
  408. Syntax       :  BLINDUP( [<cColor>], [<nDelay>], [<lScreen>] )
  409.  
  410. Description  :  Performs a full horizontal Center to Top and to Bottom
  411.         screen wipe.
  412.  
  413. Parameters   :  <cColor>  is the color to use for the wipe.
  414.         <nDelay>  is the delay to adjust the wipe speed. Example
  415.               1 to 1000 is nDelay of 10.
  416.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  417.               that there is a SAVESCREEN() in the stack to
  418.               use in a WipeOn effect.
  419.  
  420. Defaults     :  <cColor>  is "W+/N"
  421.                 <nDelay>  is 10
  422.                 <lScreen> is optional and set NIL or .F.
  423.  
  424. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  425.         be used in the WipeOn effect.
  426.  
  427. Returns      :  Nothing
  428.  
  429. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  430.         entry holding the data from the VSAVE() call. Use VREL()
  431.         to clear the area and make way for another call to VSAVE().
  432.  
  433.         Supports ALL Clipper video modes.
  434.  
  435.  
  436. Function     :  BOXIN()
  437.  
  438. Syntax       :  BOXIN( [<cColor>], [<lScreen>] )
  439.  
  440. Description  :  Performs a 'Boxed' spiral screen clear from Left
  441.         most Upper edge into center.
  442.  
  443. Parameters   :  <cColor>  is the color to use for the wipe.
  444.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  445.               that there is a SAVESCREEN() in the stack to
  446.               use in a WipeOn effect.
  447.  
  448. Defaults     :  <cColor>  is "W+/N"
  449.         <lScreen> is optional and set NIL or .F.
  450.  
  451.  
  452. Requires     :  a call to BSAVE() if the <lScreen> parameter is going to
  453.         be used in the WipeOn effect.
  454.  
  455. Returns      :  Nothing
  456.  
  457. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  458.         entry holding the data from the BSAVE() call. Use BREL()
  459.         to clear the area and make way for another call to BSAVE()
  460.  
  461.         ** Does not support ALL Clipper video modes. **
  462.  
  463.  
  464. Function     :  BOXOUT()
  465.  
  466. Syntax       :  BOXOUT( [<cColor>], [<lScreen>] )
  467.  
  468. Description  :  Performs a 'Boxed' spiral screen clear from center
  469.         out to Left most Upper edge.
  470.  
  471. Parameters   :  <cColor>  is the color to use for the wipe.
  472.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  473.               that there is a SAVESCREEN() in the stack to
  474.                           use in a WipeOn effect.
  475.  
  476. Defaults     :  <cColor>  is "W+/N"
  477.         <lScreen> is optional and set NIL or .F.
  478.  
  479. Requires     :  a call to BSAVE() if the <lScreen> parameter is going to
  480.         be used in the WipeOn effect.
  481.  
  482. Returns      :  Nothing
  483.  
  484. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  485.         entry holding the data from the BSAVE() call. Use BREL()
  486.         to clear the area and make way for another call to BSAVE()
  487.  
  488.         ** Does not support ALL Clipper video modes. **
  489.  
  490.  
  491. Function     :  BREL()
  492.  
  493. Syntax       :  BREL()
  494.  
  495. Description  :  Release stack contents containing the data from the last
  496.         call to BSAVE(). This MUST be performed before another call
  497.         to BSAVE() is made.
  498.  
  499. Parameters   :  Nothing
  500.  
  501. Requires     :  Nothing
  502.  
  503. Returns      :  Nothing
  504.  
  505. Special Note :  This function is designed to work in conjunction with
  506.         the BOXIN() and BOXOUT() wipes.
  507.  
  508.  
  509.  
  510. Function     :  BSAVE()
  511.  
  512. Syntax       :  BSAVE()
  513.  
  514. Description  :  Capture a screen for use in a 'WipeOn' effect by
  515.         the wipes BOXIN() and BOXOUT().
  516.  
  517. Parameters   :  Nothing
  518.  
  519. Requires     :  Nothing
  520.  
  521. Returns      :  Nothing
  522.  
  523. Special Note :  This function is designed to work in conjunction with
  524.         the BOXIN() and BOXOUT() wipes
  525.  
  526.         ** Does not support ALL Clipper video modes. **
  527.  
  528.  
  529. Function     :  CENTER()
  530.  
  531. Syntax       :  CENTER( <nRow>, <cString>, [<cColor>] )
  532.  
  533. Description  :  Centers the passed text on specified line in the also
  534.         specified color.
  535.  
  536. Parameters   :  <nRow>     Physical screen row on which the text is to
  537.                be displayed.
  538.         <cString>  The actual text to be centered.
  539.         <cColor>   The color in which to display the text.
  540.  
  541. Requires     :  Nothing
  542.  
  543. Returns      :  Nothing
  544.  
  545. Special Note :  Supports ALL Clipper video modes.
  546.  
  547.  
  548.  
  549. Function     :  CLOSEIN()
  550.  
  551. Syntax       :  CLOSEIN( [<cColor>], [<nDelay>], [<lScreen>] )
  552.  
  553. Description  :  Performs a full vertical Left and Right to Center
  554.         screen clear.
  555.  
  556. Parameters   :  <cColor>  is the color to use for the wipe.
  557.         <nDelay>  is the delay to adjust the wipe speed. Example
  558.               1 to 1000 is nDelay of 10.
  559.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  560.               that there is a SAVESCREEN() in the stack to
  561.                           use in a WipeOn effect.
  562.  
  563. Defaults     :  <cColor>  is "W+/N"
  564.         <nDelay>  is 5
  565.         <lScreen> is optional and set NIL or .F.
  566.  
  567. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  568.         be used in the WipeOn effect.
  569.  
  570. Returns      :  Nothing
  571.  
  572. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  573.         entry holding the data from the VSAVE() call. Use VREL()
  574.         to clear the area and make way for another call to VSAVE()
  575.  
  576.         Supports ALL Clipper video modes.
  577.  
  578.  
  579. Function     :  COLUMN()
  580.  
  581. Syntax       :  COLUMN( [<cColor>], [<nDelay>], [<lScreen>] )
  582.  
  583. Description  :  Separates the screen into 8 separate vertical 'Columns'
  584.         and performs a Left to Right vertical alternating Up and
  585.         down screen wipe.
  586.  
  587. Parameters   :  <cColor>  is the color to use for the wipe.
  588.         <nDelay>  is the delay to adjust the wipe speed. Example
  589.               1 to 1000 is nDelay of 10.
  590.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  591.               that there is a SAVESCREEN() in the stack to
  592.                           use in a WipeOn effect.
  593.  
  594. Defaults     :  <cColor>  is "W+/N"
  595.         <nDelay>  is 5
  596.         <lScreen> is optional and set NIL or .F.
  597.  
  598. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  599.         be used in the WipeOn effect.
  600.  
  601. Returns      :  Nothing
  602.  
  603. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  604.         entry holding the data from the VSAVE() call. Use VREL()
  605.         to clear the area and make way for another call to VSAVE()
  606.  
  607.         Supports ALL Clipper video modes.
  608.  
  609.  
  610. Function     :  CORNEROUT()
  611.  
  612. Syntax       :  CORNEROUT( [<cColor>], [<nDelay>] )
  613.  
  614. Description  :  Performs a screen wipe from the center of the screen out
  615.         to all 4 corners.
  616.  
  617. Parameters   :  <cColor>  is the color to use for the wipe.
  618.         <nDelay>  is the delay to adjust the wipe speed. Example
  619.               1 to 1000 is nDelay of 10.
  620.  
  621. Defaults     :  <cColor>  is "W+/N"
  622.         <nDelay>  is 20
  623.  
  624. Requires     :  Nothing
  625.  
  626. Returns      :  Nothing
  627.  
  628. Special Note :  Supports ALL Clipper video modes.
  629.  
  630.  
  631.  
  632. Function     :  CRAZYB()
  633.  
  634. Syntax       :  CRAZYB( [<cColor>], [<lScreen>] )
  635.  
  636. Description  :  A random 'Squared' clear of a screen. Quite
  637.         Impressive. Also the authors favorite.
  638.  
  639. Parameters   :  <cColor>  is the color to use for the wipe.
  640.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  641.               that there is a SAVESCREEN() in the stack to
  642.                           use in a WipeOn effect.
  643.  
  644. Defaults     :  <cColor>  is "W+/N"
  645.         <lScreen> is optional and set NIL or .F.
  646.  
  647. Requires     :  a call to CSAVE() if the <lScreen> parameter is going to
  648.         be used in the WipeOn effect.
  649.  
  650. Returns      :  Nothing
  651.  
  652. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  653.         entry holding the data from the CSAVE() call. Use CREL()
  654.         to clear the area and make way for another call to CSAVE()
  655.  
  656.         ** Does not support ALL Clipper video modes. **
  657.  
  658.  
  659. Function     :  CREL()
  660.  
  661. Syntax       :  CREL()
  662.  
  663. Description  :  Release stack contents containing the data from the last
  664.         call to CSAVE(). This MUST be performed before another call
  665.         to CSAVE() is made.
  666.  
  667. Parameters   :  Nothing
  668.  
  669. Requires     :  Nothing
  670.  
  671. Returns      :  Nothing
  672.  
  673. Special Note :  This function is designed to work in conjunction with
  674.         the CRAZYB() wipe.
  675.  
  676.  
  677.  
  678.  
  679. Function     :  CSAVE()
  680.  
  681. Syntax       :  CSAVE()
  682.  
  683. Description  :  Capture a screen for use in a 'WipeOn' effect by
  684.         the CRAZYB() wipe.
  685.  
  686. Parameters   :  Nothing
  687.  
  688. Requires     :  Nothing
  689.  
  690. Returns      :  Nothing
  691.  
  692. Special Note :  This function is designed to work in conjunction with
  693.         the CRAZYB() wipe.
  694.  
  695.         ** Does not support ALL Clipper video modes. **
  696.  
  697.  
  698. Function     :  DSTRIPE()
  699.  
  700. Syntax       :  DSTRIPE( [<cColor>], [<nDelay>], [<lScreen>] )
  701.  
  702. Description  :  Performs a Left to Right / Right to Left alternating
  703.         clear of the screen.
  704.  
  705. Parameters   :  <cColor>  is the color to use for the wipe
  706.                 <nDelay>  is the delay to adjust the wipe speed. Example
  707.                           1 to 1000 is nDelay of 10.
  708.                 <lScreen> is a Logical value ( .T. or .F. ) specifying
  709.               that there is a SAVESCREEN() in the stack to
  710.                           use in a WipeOn effect.
  711.  
  712. Defaults     :  <cColor>  is "W+/N"
  713.         <nDelay>  is 11
  714.         <lScreen> is optional and set NIL or .F.
  715.  
  716. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  717.         be used in the WipeOn effect.
  718.  
  719. Returns      :  Nothing
  720.  
  721. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  722.         entry holding the data from the VSAVE() call. Use VREL()
  723.         to clear the area and make way for another call to VSAVE()
  724.  
  725.         Supports ALL Clipper video modes.
  726.  
  727.  
  728. Function     :  EXPLODE()
  729.  
  730. Syntax       :  EXPLODE( <nTop>, <nLeft>, <nBottom>, <nRight>, ;
  731.              <cOutine>, [<nRow>], [<nCol>] )    ->  <cScreen>
  732.  
  733. Description  :  Explode a box onto the screen from specified location.
  734.  
  735. Parameters   :  <nTop>     Top most screen coordinate to 'Explode' to.
  736.         <nLeft>    Left most screen coordinate to 'Explode' to.
  737.         <nBottom>  Bottom most screen coordinate to 'Explode' to.
  738.         <nRight>   Right most screen coordinate to 'Explode' to.
  739.         <nOutline> Box outline to use. ( Actual Char. String )
  740.         <nRow>     Physical screen row from which to 'Explode'.
  741.         <nCol>     Physical screen column from which to 'Explode'.
  742.  
  743. Requires     :  Nothing
  744.  
  745. Returns      :  A character string to be passsed to Implode()
  746.  
  747. Special Note :  Supports ALL Clipper video modes.
  748.  
  749.  
  750.  
  751. Function     :  HREL()
  752.  
  753. Syntax       :  HREL()
  754.  
  755. Description  :  Release stack contents containing the data from the last
  756.         call to HSAVE(). This MUST be performed before another call
  757.         to HSAVE() is made.
  758.  
  759. Parameters   :  Nothing
  760.  
  761. Requires     :  Nothing
  762.  
  763. Returns      :  Nothing
  764.  
  765. Special Note :  This function is designed to work in conjunction with
  766.         any function performing Horizontal wipes.
  767.  
  768.  
  769.  
  770. Function     :  HSAVE()
  771.  
  772. Syntax       :  HSAVE()
  773.  
  774. Description  :  Capture the screen for a 'wipe on' effect use by
  775.         another function. This save a a Row by Row Horizontal
  776.         save.
  777.  
  778. Parameters   :  Nothing
  779.  
  780. Requires     :  Nothing
  781.  
  782. Returns      :  Nothing
  783.  
  784. Special Note :  This function is designed to work in conjunction with
  785.         any function performing Horizontal wipes.
  786.  
  787.         Supports ALL Clipper video modes.
  788.  
  789.  
  790. Function     :  HSTRIPE()
  791.  
  792. Syntax       :  HSTRIPE( [<cColor>], [<lScreen>] )
  793.  
  794. Description  :  Performs a Horizontal bar screen clear.
  795.  
  796. Parameters   :  <cColor>  is the color to use for the wipe.
  797.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  798.               that there is a SAVESCREEN() in the stack to
  799.                           use in a WipeOn effect.
  800.  
  801. Defaults     :  <cColor>  is "W+/N"
  802.         <lScreen> is optional and set NIL or .F.
  803.  
  804. Requires     :  a call to HSAVE() if the <lScreen> parameter is going to
  805.         be used in the WipeOn effect.
  806.  
  807. Returns      :  Nothing
  808.  
  809. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  810.         entry holding the data from the HSAVE() call. Use HREL()
  811.         to clear the area and make way for another call to HSAVE()
  812.  
  813.         Supports ALL Clipper video modes.
  814.  
  815.  
  816. Function     :  IMPLODE()
  817.  
  818. Syntax       :  IMPLODE( <nTop>, <nLeft>, <nBottom>, <nRight>, ;
  819.              <cOutine>, [<nRow>], [<nCol>], [<cScreen>] )
  820. Description  :  Implode a box that was EXPLODED()'ed
  821.  
  822. Parameters   :  <nTop>     Top most screen coordinate to 'Implode' from.
  823.         <nLeft>    Left most screen coordinate to 'Implode' from.
  824.         <nBottom>  Bottom most screen coordinate to 'Implode' from.
  825.         <nRight>   Right most screen coordinate to 'Implode' from.
  826.         <nOutline> Box outline to use. ( Actual Char. String )
  827.         <nRow>     Physical screen row to which to 'Implode' to.
  828.         <nCol>     Physical screen column to which to 'Implode' to.
  829.         <cScreen>  This is the screen data returned by a call to the
  830.                EXPLODE() function.
  831.  
  832. Requires     :  A previous call to the EXPLODE() function.
  833.  
  834. Returns      :  Nothing
  835.  
  836. Special Note :  Requires that you pass as the 7th parameter the character
  837.         string returned by EXPLODE().
  838.  
  839.         Supports ALL Clipper video modes.
  840.  
  841.  
  842. Function     :  LNR()
  843.  
  844. Syntax       :  LNR(  [<cColor>], [<nDelay>], [<lScreen>] )
  845.  
  846. Description  :  Performs a Left to Right and Right to Left Split
  847.                 screen clear.
  848.  
  849. Parameters   :  <cColor>  is the color to use for the wipe.
  850.         <nDelay>  is the delay to adjust the wipe speed. Example
  851.               1 to 1000 is nDelay of 10.
  852.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  853.               that there is a SAVESCREEN() in the stack to
  854.                           use in a WipeOn effect.
  855.  
  856. Defaults     :  <cColor>  is "W+/N"
  857.         <nDelay>  is 3
  858.                 <lScreen> is optional and set NIL or .F.
  859.  
  860. Requires     :  a call to HSAVE() if the <lScreen> parameter is going to
  861.         be used in the WipeOn effect.
  862.  
  863. Returns      :  Nothing
  864.  
  865. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  866.         entry holding the data from the HSAVE() call. Use HREL()
  867.         to clear the area and make way for another call to HSAVE()
  868.  
  869.         Supports ALL Clipper video modes.
  870.  
  871.  
  872. Function     :  OPENUP()
  873.  
  874. Syntax       :  OPENUP( [<cColor>], [<nDelay>], [<lScreen>] )
  875.  
  876. Description  :  Performs a FULL screen Center to Left and Right
  877.                 vertical screen clear.
  878.  
  879. Parameters   :  <cColor>  is the color to use for the wipe.
  880.         <nDelay>  is the delay to adjust the wipe speed. Example
  881.               1 to 1000 is nDelay of 10.
  882.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  883.               that there is a SAVESCREEN() in the stack to
  884.                           use in a WipeOn effect.
  885.  
  886. Defaults     :  <cColor>  is "W+/N"
  887.         <nDelay>  is 5
  888.         <lScreen> is optional and set NIL or .F.
  889.  
  890. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  891.         be used in the WipeOn effect.
  892.  
  893. Returns      :  Nothing
  894.  
  895. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  896.         entry holding the data from the VSAVE() call. Use VREL()
  897.         to clear the area and make way for another call to VSAVE()
  898.  
  899.         Supports ALL Clipper video modes.
  900.  
  901.  
  902. Function     :  PUSH_SCR()
  903.  
  904. Syntax       :  PUSH_SCR( <nTop>, <nLeft>, <nBottom>, <nRight> )
  905.  
  906. Description  :  Push a SCREENSAVE() of the passed screen coordinated
  907.         onto a stack for later retrieval.
  908.  
  909. Parameters   :  <nTop>    Top most Row to use in the SCREENSAVE().
  910.         <nLeft>   Left most Column to use in the SCREENSAVE().
  911.         <nBottom> Bottom most Row to use in the SCREENSAVE().
  912.         <nRight>  Right most Column to use in the SCREENSAVE().
  913.  
  914. Requires     :  Nothing
  915.  
  916. Returns      :  Numeric Variable <nPointer> that contains a pointer to
  917.         the Screen Stack location.
  918.  
  919. Special Note :  Supports ALL Clipper video modes.
  920.  
  921.  
  922.  
  923. Function     :  POP_SCR()
  924.  
  925. Syntax       :  POP_SCR( <nPointer> )
  926.  
  927. Description  :  Retrieves the specified screen (<nPointer>) from the
  928.         screen stack.
  929.  
  930. Parameters   :  <nPointer> is the numeric pointer returned by a previous
  931.         call to PUSH_SCR()
  932.  
  933. Requires     :  a Previous call to PUSH_SCR()
  934.  
  935. Returns      :  Nothing
  936.  
  937. Special Note :  Supports ALL Clipper video modes.
  938.  
  939.  
  940.  
  941. Function     :  PREL()
  942.  
  943. Syntax       :  PREL()
  944.  
  945. Description  :  Release stack contents containing the data from the last
  946.         call to PSAVE(). This MUST be performed before another call
  947.         to PSAVE() is made.
  948.  
  949. Parameters   :  Nothing
  950.  
  951. Requires     :  Nothing
  952.  
  953. Returns      :  Nothing
  954.  
  955. Special Note :  This function is designed to work in conjunction with
  956.         the COLUMN() and THRESHER() wipes.
  957.  
  958.  
  959.  
  960. Function     :  PSAVE()
  961.  
  962. Syntax       :  PSAVE()
  963.  
  964. Description  :  Capture the screen for a 'wipe on' effect use by
  965.         the wipes COLUMN() and THRESHER().
  966.  
  967. Parameters   :  Nothing
  968.  
  969. Requires     :  Nothing
  970.  
  971. Returns      :  Nothing
  972.  
  973. Special Note :  This function is designed to work in conjunction with
  974.         the COLUMN() and THRESHER() wipes.
  975.  
  976.         Supports ALL Clipper video modes when used with COLUMN().
  977.  
  978.  
  979. Function     :  ROUNDER()
  980.  
  981. Syntax       :  ROUNDER( <nNumber>, <nPlaces> )
  982.  
  983. Description  :  Round <nNumber> Up/Down with no magic numbers as
  984.                 happens with Clipper's ROUND().
  985.  
  986. Parameters   :  <nNumber> is the numeric to Round
  987.         <nPlaces> is the number of decimal places
  988.  
  989. Defaults     :  <nPlaces> to 0 decimals
  990.  
  991. Requires     :  Nothing
  992.  
  993. Returns      :  a numeric value holding the Rounded number.
  994.  
  995. Special Note :  This was written to avoid those 'Magic' numbers that Clipper
  996.         ROUND() command can't handle. Is used in this Lib!
  997.  
  998.  
  999.  
  1000. Function     :  SHADOW()
  1001.  
  1002. Syntax       :  SHADOW( <nTop>, <nLeft>, <nBottom>, <nRight> )
  1003.  
  1004. Description  :  Place a non-destructive transparent shadow around
  1005.                 a box on the screen.
  1006.  
  1007. Parameters   :  <nTop>    Box's Top most Row Coordinate.
  1008.         <nLeft>   Box's Left most Column Coordinate.
  1009.         <nBottom> Box's Bottom most Row Coordinate.
  1010.         <nRight>  Box's Right most Column Coordinate.
  1011.  
  1012. Requires     :  Nothing
  1013.  
  1014. Returns      :  Nothing
  1015.  
  1016. Special Note :  The parameters are the EXACT same one as passed to a @..BOX
  1017.         or similar command/function. It will perform all calculations
  1018.         and place a Right->Down shadow on the box at the specified
  1019.         screen coordinates.
  1020.  
  1021.         Supports ALL Clipper video modes.
  1022.  
  1023.  
  1024. Function     :  SDREL()
  1025.  
  1026. Syntax       :  SDREL()
  1027.  
  1028. Description  :  Release stack contents containing the data from the last
  1029.         call to SDSAVE(). This MUST be performed before another call
  1030.         to SDSAVE() is made.
  1031.  
  1032. Parameters   :  Nothing
  1033.  
  1034. Requires     :  Nothing
  1035.  
  1036. Returns      :  Nothing
  1037.  
  1038. Special Note :  This function is designed to work in conjunction with
  1039.         the LNR() wipe.
  1040.  
  1041.  
  1042.  
  1043. Function     :  SDSAVE()
  1044.  
  1045. Syntax       :  SDSAVE()
  1046.  
  1047. Description  :  Capture the screen for a 'wipe on' effect use by
  1048.         the LNR() wipe.
  1049.  
  1050. Parameters   :  Nothing
  1051.  
  1052. Requires     :  Nothing
  1053.  
  1054. Returns      :  Nothing
  1055.  
  1056. Special Note :  This function is designed to work in conjunction with
  1057.         the LNR() wipe.
  1058.  
  1059.         Supports ALL Clipper video modes.
  1060.  
  1061.  
  1062. Function     :  STARTWATCH()
  1063.  
  1064. Syntax       :  STARTWATCH()
  1065.  
  1066. Description  :  Start a Stopwatch timer and add it to the timer stack
  1067.  
  1068. Parameters   :  Nothing
  1069.  
  1070. Requires     :  Nothing
  1071.  
  1072. Returns      :  a numeric variable containing a pointer to the Stopwatch
  1073.         Stack location.
  1074.  
  1075. Special Note :  Nothing
  1076.  
  1077.  
  1078.  
  1079. Function     :  STOPWATCH()
  1080.  
  1081. Syntax       :  StopWatch( <nPointer> ) -> cElapsed
  1082.  
  1083. Description  :  Retrieve and halt specified <nPointer> Stopwatch from
  1084.                 the Stopwatch Stack and compute Elapsed Time.
  1085.  
  1086. Parameters   :  <nPointer> the numeric pointer returned by a previous call
  1087.                to STARTWATCH().
  1088.  
  1089. Requires     :  Nothing
  1090.  
  1091. Returns      :  a character string containing the Elapsed Time in the format
  1092.         of '00:00:00'.
  1093.  
  1094. Special Note :  This function will not work correctly is no previous call to
  1095.         STARTWATCH() is made.
  1096.  
  1097.  
  1098.  
  1099. Function     :  SUREL()
  1100.  
  1101. Syntax       :  SUREL()
  1102.  
  1103. Description  :  Release stack contents containing the data from the last
  1104.         call to SUSAVE(). This MUST be performed before another call
  1105.         to SUSAVE() is made.
  1106.  
  1107. Parameters   :  Nothing
  1108.  
  1109. Requires     :  Nothing
  1110.  
  1111. Returns      :  Nothing
  1112.  
  1113. Special Note :  This function is designed to work in conjunction with
  1114.         the UPDN() wipe.
  1115.  
  1116.  
  1117. Function     :  SUSAVE()
  1118.  
  1119. Syntax       :  SUSAVE()
  1120.  
  1121. Description  :  Capture the screen for a 'wipe on' effect use by
  1122.         the UPDN() wipe.
  1123.  
  1124. Parameters   :  Nothing
  1125.  
  1126. Requires     :  Nothing
  1127.  
  1128. Returns      :  Nothing
  1129.  
  1130. Special Note :  This function is designed to work in conjunction with
  1131.         the UPDN() wipe.
  1132.  
  1133.         Supports ALL Clipper video modes.
  1134.  
  1135.  
  1136. Function     :  THRESHER()
  1137.  
  1138. Syntax       :  THRESHER(  [<cColor>], [<nDelay>], [<lScreen>] )
  1139.  
  1140. Description  :  Performs a Column Up and Down simultaneous screen
  1141.                 clear.
  1142.  
  1143. Parameters   :  <cColor>  is the color to use for the wipe.
  1144.         <nDelay>  is the delay to adjust the wipe speed. Example
  1145.               1 to 1000 is nDelay of 10.
  1146.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  1147.               that there is a SAVESCREEN() in the stack to
  1148.                           use in a WipeOn effect.
  1149.  
  1150. Defaults     :  <cColor>  is "W+/N"
  1151.         <nDelay>  is 20
  1152.         <lScreen> is optional and set NIL or .F.
  1153.  
  1154. Requires     :  a call to PSAVE() if the <lScreen> parameter is going to
  1155.         be used in the WipeOn effect.
  1156.  
  1157. Returns      :  Nothing
  1158.  
  1159. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  1160.         entry holding the data from the PSAVE() call. Use PREL()
  1161.         to clear the area and make way for another call to PSAVE()
  1162.  
  1163.         ** Does not support ALL Clipper video modes. **
  1164.  
  1165.  
  1166. Function     :  THRESHLR()
  1167.  
  1168. Syntax       :  THRESHLR(  [<cColor>], [<nDelay>] )
  1169.  
  1170. Description  :  Performs a Column Left to Right, Right to Left
  1171.                 horizontal screen clear.
  1172.  
  1173. Parameters   :  <cColor>  is the color to use for the wipe.
  1174.         <nDelay>  is the delay to adjust the wipe speed. Example
  1175.               1 to 1000 is nDelay of 10.
  1176.  
  1177. Defaults     :  <cColor>  is "W+/N"
  1178.         <nDelay>  is 3
  1179.  
  1180. Requires     :  Nothing
  1181.  
  1182. Returns      :  Nothing
  1183.  
  1184. Special Note :  ** Does not support ALL Clipper video modes. **
  1185.  
  1186.  
  1187.  
  1188. Function     :  THROWALL()
  1189.  
  1190. Syntax       :  THROWALL(  [<cColor>] )
  1191.  
  1192. Description  :  Performs a Left to Right, Right to Left, THROWUP()
  1193.                 and THROWDOWN() alternating screen clear.
  1194.  
  1195. Parameters   :  <cColor>  is the color to use for the wipe
  1196.  
  1197. Defaults     :  <cColor>  is "W+/N"
  1198.  
  1199. Requires     :  Nothing
  1200.  
  1201. Returns      :  Nothing
  1202.  
  1203. Special Note :  Supports ALL Clipper video modes.
  1204.  
  1205.  
  1206.  
  1207. Function     :  THROWDN()
  1208.  
  1209. Syntax       :  THROWDN(  [<cColor>] )
  1210.  
  1211. Description  :  Performs a Left to Right screen wipe spitting the
  1212.                 screen text downwards.
  1213.  
  1214. Parameters   :  <cColor>  is the color to use for the wipe
  1215.  
  1216. Defaults     :  <cColor>  is "W+/N"
  1217.  
  1218. Requires     :  Nothing
  1219.  
  1220. Returns      :  Nothing
  1221.  
  1222. Special Note :  Supports ALL Clipper video modes.
  1223.  
  1224.  
  1225.  
  1226. Function     :  THROWUP()
  1227.  
  1228. Syntax       :  THROWUP(  [<cColor>] )
  1229.  
  1230. Description  :  Performs a Left to Right screen wipe spitting the
  1231.         screen text upwards.
  1232.  
  1233. Parameters   :  <cColor>  is the color to use for the wipe.
  1234.  
  1235. Defaults     :  <cColor>  is "W+/N"
  1236.  
  1237. Requires     :  Nothing
  1238.  
  1239. Returns      :  Nothing
  1240.  
  1241. Special Note :  Supports ALL Clipper video modes.
  1242.  
  1243.  
  1244.  
  1245. Function     :  UPDN()
  1246.  
  1247. Syntax       :  UPDN(  [<cColor>], [<nDelay>], [<lScreen>] )
  1248.  
  1249. Description  :  Performs a Screen top to bottom (Col 0-39) and Bottom
  1250.                 to Top (Col 40-79) split screen wipe
  1251.  
  1252. Parameters   :  <cColor>  is the color to use for the wipe.
  1253.         <nDelay>  is the delay to adjust the wipe speed. Example
  1254.               1 to 1000 is nDelay of 10.
  1255.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  1256.               that there is a SAVESCREEN() in the stack to
  1257.                           use in a WipeOn effect.
  1258.  
  1259. Defaults     :  <cColor>  is "W+/N"
  1260.         <nDelay>  is 5
  1261.         <lScreen> is optional and set NIL or .F.
  1262.  
  1263. Requires     :  a call to SUSAVE() if the <lScreen> parameter is going to
  1264.         be used in the WipeOn effect.
  1265.  
  1266. Returns      :  Nothing
  1267.  
  1268. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  1269.         entry holding the data from the SUSAVE() call. Use SUREL()
  1270.         to clear the area and make way for another call to SUSAVE().
  1271.  
  1272.         Supports ALL Clipper video modes.
  1273.  
  1274.  
  1275. Function     :  VREL()
  1276.  
  1277. Syntax       :  VREL()
  1278.  
  1279. Description  :  Release stack contents containing the data from the last
  1280.         call to VSAVE(). This MUST be performed before another call
  1281.         to VSAVE() is made.
  1282.  
  1283. Parameters   :  Nothing
  1284.  
  1285. Requires     :  Nothing
  1286.  
  1287. Returns      :  Nothing
  1288.  
  1289. Special Note :  This function is designed to work in conjunction with
  1290.         any function performing a vertical wipe.
  1291.  
  1292.  
  1293.  
  1294. Function     :  VSAVE()
  1295.  
  1296. Syntax       :  VSAVE()
  1297.  
  1298. Description  :  Capture the screen for a 'wipe on' effect use by
  1299.         another function.
  1300.  
  1301. Parameters   :  Nothing
  1302.  
  1303. Requires     :  Nothing
  1304.  
  1305. Returns      :  Nothing
  1306.  
  1307. Special Note :  This function is designed to work in conjunction with
  1308.         any function performing a vertical wipe.
  1309.  
  1310.         Supports ALL Clipper video modes.
  1311.  
  1312.  
  1313. Function     :  VSTRIPE()
  1314.  
  1315. Syntax       :  VSTRIPE(  [<cColor>], [<nDelay>], [<lScreen>] )
  1316.  
  1317. Description  :  Performs a Vertical Left to Rigt screen clear.
  1318.  
  1319. Parameters   :  <cColor>  is the color to use for the wipe.
  1320.         <nDelay>  is the delay to adjust the wipe speed. Example
  1321.               1 to 1000 is nDelay of 10.
  1322.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  1323.               that there is a SAVESCREEN() in the stack to
  1324.                           use in a WipeOn effect.
  1325.  
  1326. Defaults     :  <cColor>  is "W+/N"
  1327.                 <nDelay>  is 10
  1328.         <lScreen> is optional and set NIL or .F.
  1329.  
  1330. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  1331.         be used in the WipeOn effect.
  1332.  
  1333. Returns      :  Nothing
  1334.  
  1335. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  1336.         entry holding the data from the VSAVE() call. Use VREL()
  1337.         to clear the area and make way for another call to VSAVE()
  1338.  
  1339.         Supports ALL Clipper video modes.
  1340.  
  1341.  
  1342. Function     :  WHISTLE()
  1343.  
  1344. Syntax       :  WHISTLE( <cWhistle> )
  1345.  
  1346. Description  :  Performs various Wipeout Tones
  1347.  
  1348. Parameters   :  <cWhistle>
  1349.  
  1350.  
  1351. Requires     :  Nothing
  1352.  
  1353. Returns      :  Nothing
  1354.  
  1355. Special Note :  Valid Tone Name : ATTN, DONE, ERROR, CHARGE
  1356.  
  1357.  
  1358.  
  1359. Function     :  WIPEL()
  1360.  
  1361. Syntax       :  WIPEL(  [<cColor>], [<nDelay>], [<lScreen>] )
  1362.  
  1363. Description  :  Standard full screen Left to Right screen clear.
  1364.  
  1365. Parameters   :  <cColor>  is the color to use for the wipe.
  1366.         <nDelay>  is the delay to adjust the wipe speed. Example
  1367.               1 to 1000 is nDelay of 10.
  1368.         <lScreen> is a Logical value ( .T. or .F. ) specifying
  1369.               that there is a SAVESCREEN() in the stack to
  1370.                           use in a WipeOn effect.
  1371.  
  1372. Defaults     :  <cColor>  is "W+/N"
  1373.         <nDelay>  is 4
  1374.         <lScreen> is optional and set NIL or .F.
  1375.  
  1376. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  1377.         be used in the WipeOn effect.
  1378.  
  1379. Returns      :  Nothing
  1380.  
  1381. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  1382.         entry holding the data from the VSAVE() call. Use VREL()
  1383.         to clear the area and make way for another call to VSAVE()
  1384.  
  1385.         Supports ALL Clipper video modes.
  1386.  
  1387.  
  1388. Function     :  WIPER()
  1389.  
  1390. Syntax       :  WIPER(  [<cColor>], [<nDelay>], [<lScreen>] )
  1391.  
  1392. Description  :  Performs full screen Right to Left screen clear.
  1393.  
  1394. Parameters   :  <cColor>  is the color to use for the wipe.
  1395.                 <nDelay>  is the delay to adjust the wipe speed. Example
  1396.                           1 to 1000 is nDelay of 10.
  1397.                 <lScreen> is a Logical value ( .T. or .F. ) specifying
  1398.               that there is a SAVESCREEN() in the stack to
  1399.                           use in a WipeOn effect.
  1400.  
  1401. Defaults     :  <cColor>  is "W+/N"
  1402.         <nDelay>  is 4
  1403.         <lScreen> is optional and set NIL or .F.
  1404.  
  1405. Requires     :  a call to VSAVE() if the <lScreen> parameter is going to
  1406.         be used in the WipeOn effect.
  1407.  
  1408. Returns      :  Nothing
  1409.  
  1410. Special Note :  Using the <lScreen> parameter WILL NOT release the stack
  1411.         entry holding the data from the VSAVE() call. Use VREL()
  1412.         to clear the area and make way for another call to VSAVE()
  1413.  
  1414.         Supports ALL Clipper video modes.
  1415.  
  1416.            Credit Where Credit Is Do
  1417.            -------------------------
  1418.  
  1419. The Wipeout Library would not have been possible nor conceived without the
  1420. indespensable help and input of some very special people. They are very much
  1421. a part of this product and I feel they need the recognition they deserve.
  1422.  
  1423.  
  1424. Greg Lief    - If I was never curious about your venetian blinds, this
  1425.            would have never been conceived. Also thanks go to you,
  1426.            Joe and Craig for a DAMM good book.
  1427.  
  1428. Tim Cook     - The man who helped me move to 5.01. Without his insight, ideas
  1429.            drive and determination you would never be reading this.
  1430.            Allowing me to share your goals as well as bounce ideas off of
  1431.            you at ALL hours of the night has been something I will never
  1432.            forget. Weve been through the tough now it's on to the gold.
  1433.  
  1434. Max Bressler - For actually giving me the idea to share this project. I
  1435.            thank you for the support and understanding you have given
  1436.            over the past 6 months. Without you Europe would be an
  1437.            untouched market by my products. I look forward to an long
  1438.            and prosperous relationship.
  1439.  
  1440. Mike Walter  - Mike where would we be without Database. I owe you alot for
  1441.            providing us a place to centralize, organize, distribute
  1442.            and occasionally hide out. Your support was totally above
  1443.            and beyond that of what was necessary and I am eternaly
  1444.            in your debt. One day I'll send that check.
  1445.  
  1446. John Ginnane - Your banter and discussion has helped ease the days. Also
  1447.            for the wonderful support and Norton Guide Databases you
  1448.            are graciously compiling for this project.
  1449.  
  1450.              ** Special Note **
  1451.  
  1452. Indirectly I would be lost without my most prized library, Nanforum Toolkit.
  1453. To the contributors of this incredable project I thank you from the depth of
  1454. my heart. Your unique code, implementations and ideas have spawned many
  1455. sleepless nights and turned on the "lightbulb" to many times to count.
  1456.  
  1457.              ** And of Course **
  1458.  
  1459. To Nantucket  - For brigning me and the world Clipper 5.01. I look forward
  1460.         to what the future has in store.
  1461.  
  1462.       *** To the believers in Septmber 15th. It'll happen one day! ***
  1463.  
  1464.