home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / DATABASE / PROCLIP.ZIP / PROCLIP.DOC next >
Encoding:
Text File  |  1987-08-23  |  29.3 KB  |  859 lines

  1.  
  2.  
  3.  
  4.                                    PROCLIP.LIB
  5.                          - Professional Clipper Library -
  6.                                          
  7.                                    Version 1.00
  8.      ========================================================================
  9.                             Copyright Acknowledgments
  10.      
  11.                     CLIPPER is a Trademark of Nantucket, Inc.
  12.               IBM is a Trademark of International Business Machines.
  13.              Tom Rettig Library is a Trademark of Tom Rettig & Assoc.
  14.             Microsoft Overlay Linker is a Trademark of Microsoft Corp.
  15.              PLINK86plus is a Trademark of Phoenix Technologies, Ltd.
  16.      
  17.      ========================================================================
  18.      
  19.      The Professional Clipper Library (PROCLIP.LIB) is not designed to
  20.      replace the standard Nantucket Clipper Library (Winter '86), simply to
  21.      enhance its capabilities.  Some of the routines contained in PROCLIP are
  22.      undoubtedly contained in the next release from Nantucket but I needed
  23.      them now so I wrote them.  Also, as I am an avid fan (and registered
  24.      owner) of the Tom Rettig Library, I have taken precautions not to
  25.      duplicate his work.  I have coded some routines similar to his which
  26.      have enhancements, but I will not attempt to "reinvent the wheel."  The
  27.      purpose of this library is to provide the programmer with additional
  28.      tools that Nantucket and Tom haven't gotten around to releasing yet.
  29.      
  30.      I am releasing this software under the concept that most of us pay for
  31.      what we use and appreciate.  Those in the crowd who must steal from
  32.      others can have at it, but your ears will become infested with the fleas
  33.      of a thousand camels.  If these functions are useful to you and you
  34.      would like to encourage the creation of more a registration fee of
  35.      $25.00 is suggested and appreciated.  I also encourage more input into
  36.      the creation of other functions.  Every one of these functions were
  37.      created from input from other CLIPPER users such as yourself.  I'm not
  38.      too good at dreaming these things up but I can follow directions pretty
  39.      good.  Now I'm not egotistic enough to say I can write anything, but
  40.      give me an idea of what you'd like and I'll see what I can do.  I will
  41.      do my best to correct any programming problems (bugs) which are located
  42.      and brought to my attention.  I will not, however, be held responsible
  43.      for any damages either real or imagined from the use of PROCLIP.
  44.      
  45.      Also, if any of you would like to obtain the source code for this
  46.      library please send your request, along with an additional $25.00 to the
  47.      address listed below.  Currently all source code is 8088 assembler and
  48.      heavily documented.
  49.      
  50.      For registration .or. source code:
  51.      
  52.                          Genesis Development
  53.                          3504 Jasmine Lane
  54.                          Rowlett, Texas  75088
  55.                          
  56.                          Source ID: NAN779
  57.                          CompuServe: 71410,2051
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                        Page #1
  64.                                           
  65.                    Copyright (c) 1986, 1987 by Genesis Development
  66.  
  67.  
  68.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  69.      ===========================================================================
  70.  
  71.      PROCLIP Usage:
  72.      
  73.      As I am particularly fond of the UDF (user defined function) command
  74.      type, most of my examples will be using them.  Only in a few cases must
  75.      we mandate the use of the procedure call format.  The UDF type simply
  76.      makes for cleaner looking code.
  77.      
  78.      In almost all cases the functions are checking the parameter count,
  79.      types and values to prevent runtime problems.  The library is using the
  80.      published CLIPPER vector names for parameter retrieval and return
  81.      (EXTENDA).  Hopefully this will prevent this library from becoming
  82.      obsolete with new versions of CLIPPER.
  83.      
  84.      Use of this library is identical to that of any other library designed
  85.      for use with CLIPPER:
  86.      
  87.      With MicroSoft Linker -
  88.      
  89.      C>LINK
  90.      Microsoft (R) Overlay Linker  Version 3.51
  91.      Copyright (C) Microsoft Corp 1983, 1984, 1985, 1986.  All rights
  92.      reserved.
  93.      
  94.      Object Modules [.OBJ]: YOURPROG
  95.      Run File [YOURPROG.EXE]:
  96.      List File [NUL.MAP]:
  97.      Libraries [.LIB]: CLIPPER + PROCLIP
  98.      
  99.      
  100.      With PLink86 -
  101.      
  102.      C>PLINK86
  103.      PLINK86plus ( Nantucket ) Version 2.21
  104.      Copyright (C) 1984, 1985, 1986 by Phoenix Technologies Ltd.,
  105.      All Rights Reserved.
  106.      
  107.      =>FI YOURPROG
  108.      =>LIB CLIPPER
  109.      =>LIB PROCLIP
  110.      
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                        Page #2
  131.                                           
  132.                    Copyright (c) 1986, 1987 by Genesis Development
  133.  
  134.  
  135.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  136.      ===========================================================================
  137.  
  138.                          * * *  NOTICES & WARNINGS * * *
  139.      
  140.  
  141.      If you are using PROCLIP with any other library which contains the same
  142.  
  143.      function names (eg. SCROLL) you will see some warning errors generated
  144.  
  145.      by whichever linker you are using.  If you like the PROCLIP function
  146.  
  147.      better than the others just make certain that PROCLIP is the first
  148.  
  149.      library in the list after the CLIPPER library is specified.  Neither
  150.  
  151.      linker appreciates a bunch of functions with the same names but they
  152.  
  153.      both will use the first function of that name that they encounter.
  154.  
  155.      
  156.  
  157.      If you specify a function in CLIPPER you cannot specify it as a
  158.  
  159.      procedure in a different module of the same program and vice versa.
  160.  
  161.      What this means is...be consistent.  If you use one of the routines as a
  162.  
  163.      function (eg. newattr(10,20,12,60,'n/w') ) you cannot use it in a
  164.  
  165.      different module of the same program as a procedure (eg. call newattr
  166.  
  167.      with 10,20,12,60,'n/w').  CLIPPER will scream it's head off at you so
  168.  
  169.      you don;t have to worry about it compiling incorrectly.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                        Page #3
  198.                                           
  199.                    Copyright (c) 1986, 1987 by Genesis Development
  200.  
  201.  
  202.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  203.      ===========================================================================
  204.  
  205.      Function Name: SCROLL
  206.      
  207.           I know, I know, who doesn't already have a SCROLL routine.  The
  208.           Nantucket (DBU.LIB) and Rettig (TR86.LIB) libraries have nice
  209.           scroll routines but neither one of them let you control the
  210.           attribute of the blank line left behind.  In some of my
  211.           applications this got to be a real pain so I decided to fix it.
  212.           After studying both Nantucket and Rettig's SCROLL routines I
  213.           decided that Tom had the most sensible call format so I borrowed
  214.           it.  We won't mention the fact that I was also used to using it.
  215.      
  216.           Format:
  217.      
  218.                As a function -
  219.      
  220.                     scroll(top,left,bottom,right,lines,dir[,attr])
  221.      
  222.                As a procedure -
  223.                
  224.                     call scroll with top,left,bottom,right,lines,dir[,attr]
  225.      
  226.           Parameters:
  227.      
  228.                top.......topmost row of the area to be scrolled.  Value
  229.                          checked to be between 0 and 24 inclusive.
  230.                
  231.                left......leftmost column of the area to be scrolled.  Value
  232.                          checked to be between 0 and 79 inclusive.
  233.                
  234.                bottom....ending (bottommost?) row of the area to be scrolled.
  235.                          Value checked to be greater than TOP but less than
  236.                          or equal to 24.
  237.                
  238.                right.....rightmost column of the area to be scrolled.  Value
  239.                          checked to be greater than LEFT but less than or
  240.                          equal to 79.
  241.                
  242.                Lines.....number of lines to be scrolled, or zero (0) to
  243.                          scroll entire window (effectively erasing it).
  244.                          Value checked to be equal to or less than BOTTOM -
  245.                          TOP.
  246.                
  247.                Dir.......non case sensitive character variable or constant
  248.                          containing a flag indicating the direction of the
  249.                          scroll (u = Up & d = Down).
  250.                
  251.                Attr......non case sensitive character variable or constant
  252.                          containing a valid color command and combination for
  253.                          character and background.  Must be the alpha
  254.                          representation of the color, the numeric will be
  255.                          rejected.  This is NOT a mandatory parameter.  If
  256.                          you do not furnish it in the command line the
  257.                          function will use the attribute currently on the
  258.                          screen for the character in the TOP, LEFT position.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.                                        Page #4
  265.                                           
  266.                    Copyright (c) 1986, 1987 by Genesis Development
  267.  
  268.  
  269.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  270.      ===========================================================================
  271.  
  272.      SCROLL (cont'd)
  273.                                   (valid colors)
  274.                          black                         N
  275.                          blue                          B
  276.                          green                         G
  277.                          cyan                          BG
  278.                          red                           R
  279.                          magenta                       RB
  280.                          brown                         GR
  281.                          white                         W
  282.                          intense                       +
  283.                          blink                         *
  284.      
  285.           Examples:
  286.      
  287.                1.   This will scroll one line down in the area from row #10,
  288.                     column #20 through row #12, column #60 using an attribute
  289.                     of black character (n) and white background (w).
  290.      
  291.                .
  292.                .
  293.                .
  294.                scroll(10,20,12,60,1,'d','n/w')
  295.                (or call scroll with 10,20,12,20,1,'d','n/w')
  296.                .
  297.                .
  298.                .
  299.      
  300.                2.   This will scroll one line down in the area from row
  301.                     #05,column #00 through row #20, column #79 using whatever
  302.                     the attribute of the character at 10,20 currently is.
  303.      
  304.                .
  305.                .
  306.                .
  307.                scroll(05,00,20,79,1,'d')
  308.                .
  309.                .
  310.                .
  311.      
  312.           Returns:
  313.      
  314.                Not a thing.  This function will either perform the function
  315.                or ignore the request because of some parameter problem.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                        Page #5
  332.                                           
  333.                    Copyright (c) 1986, 1987 by Genesis Development
  334.  
  335.  
  336.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  337.      ===========================================================================
  338.  
  339.      Function Name: NEWATTR
  340.      
  341.           This function was created for those of us who wish to highlight a
  342.           particular area of the screen without having to bother setting
  343.           colors and rewriting the text.  This is real useful if you'd like
  344.           to highlight a menu item or prompt area without having to rewrite
  345.           it.  When called with the proper parameters the function will
  346.           change the attribute of the specified area (box).
  347.      
  348.           NEWATTR in its current form uses the IBM standard BIOS interrupt
  349.           for writing to the screen.  Given this it will not "pop" onto the
  350.           screen on computers with slower clock cycles (4.77MHz - 6.0MHz).
  351.           If the need arises I will write a different version to do direct
  352.           screen writing.
  353.      
  354.           Format:
  355.      
  356.                As a function -
  357.      
  358.                     newattr(top,left,bottom,right,attr)
  359.      
  360.                As a procedure -
  361.      
  362.                     call newattr with top,left,bottom,right,attr
  363.      
  364.           Parameters:
  365.      
  366.                top.......topmost row of the area to be changed.  Value
  367.                          checked to be between 0 and 24 inclusive.
  368.                
  369.                left......leftmost column of the area to be changed.  Value
  370.                          checked to be between 0 and 79 inclusive.
  371.                
  372.                bottom....ending (bottommost?) row of the area to be changed.
  373.                          Value checked to be greater than TOP but less than
  374.                          or equal to 24.
  375.                
  376.                right.....rightmost column of the area to be changed.  Value
  377.                          checked to be greater than LEFT but less than or
  378.                          equal to 79.
  379.                
  380.                Attr......non case sensitive character variable or constant
  381.                          containing a valid color command and combination for
  382.                          character and background.  Must be the alpha
  383.                          representation of the color, the numeric will be
  384.                          rejected.
  385.      
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                                        Page #6
  399.                                           
  400.                    Copyright (c) 1986, 1987 by Genesis Development
  401.  
  402.  
  403.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  404.      ===========================================================================
  405.  
  406.      NEWATTR (cont'd)
  407.      
  408.                                   (valid colors)
  409.                          black                         N
  410.                          blue                          B
  411.                          green                         G
  412.                          cyan                          BG
  413.                          red                           R
  414.                          magenta                       RB
  415.                          brown                         GR
  416.                          white                         W
  417.                          intense                       +
  418.                          blink                         *
  419.      
  420.           Examples:
  421.      
  422.                1.   This will change the character attributes from row #10,
  423.                     column #20 through row #12, column #60 to intense
  424.                     blinking red on a black background (somebody must have
  425.                     hit the wrong key).
  426.      
  427.                .
  428.                .
  429.                .
  430.                newattr(10,20,12,60,'*+r/n)
  431.                .
  432.                .
  433.                .
  434.      
  435.                2.   This will change the character attributes from row #05,
  436.                     column #10 through row #05, column #15 to inverse with
  437.                     black characters.
  438.      
  439.                .
  440.                .
  441.                .
  442.                t = 05
  443.                l = 10
  444.                b = 05
  445.                r = 15
  446.                newattr(t,l,b,r,'n/w')
  447.                .
  448.                .
  449.                .
  450.      
  451.           Returns:
  452.      
  453.                Not a thing.  This function will either operate with the given
  454.                parameters of reject them due to validity checking.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                        Page #7
  466.                                           
  467.                    Copyright (c) 1986, 1987 by Genesis Development
  468.  
  469.  
  470.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  471.      ===========================================================================
  472.  
  473.      Function Name: SAVEBOX
  474.      
  475.           In Clipper if you want to use the neat BOX command to prompt for a
  476.           parameter or issue a warning and restore the screen to its original
  477.           beauty and luster, you have to save the entire screen to a memory
  478.           variable and then restore it.  This is fine but if you get too many
  479.           saved screens you'll run smack out of memory.  Each screen as saved
  480.           by CLIPPER requires a minimum of 4096 bytes.  Tom Rettig was nice
  481.           enough to allow us to slam that puppy on the disk but even this
  482.           causes more trouble than necessary.  The concept behind the SAVEBOX
  483.           function was to allow the programmer to save only a specific
  484.           section of the screen into a pre-defined memory variable.  Using
  485.           this you can save all the screen (4096 bytes) or only one character
  486.           (2 bytes) or anywhere in between.
  487.      
  488.           As this procedure requires a pre-defined character memory variable
  489.           to contain the screen data please ensure you define the variable as
  490.           this document suggests (sizewise).
  491.           
  492.           This procedure is just that, a procedure.  Do not call it as a
  493.           function because CLIPPER will not allow me to return the character
  494.           memory variable intact with all the goodies.
  495.      
  496.           Format:
  497.      
  498.                As a function -
  499.      
  500.                     none
  501.      
  502.                As a procedure -
  503.      
  504.                     call savebox with top,left,bottom,right,scrnarea
  505.      
  506.           Parameters:
  507.      
  508.                top.......topmost row of the area to be changed.  Value
  509.                          checked to be between 0 and 24 inclusive.
  510.                
  511.                left......leftmost column of the area to be changed.  Value
  512.                          checked to be between 0 and 79 inclusive.
  513.                
  514.                bottom....ending (bottommost?) row of the area to be changed.
  515.                          Value checked to be greater than TOP but less than
  516.                          or equal to 24.
  517.                
  518.                right.....rightmost column of the area to be changed.  Value
  519.                          checked to be greater than LEFT but less than or
  520.                          equal to 79.
  521.                
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                        Page #8
  533.                                           
  534.                    Copyright (c) 1986, 1987 by Genesis Development
  535.  
  536.  
  537.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  538.      ===========================================================================
  539.  
  540.      SAVEBOX (cont'd)
  541.      
  542.                scrnarea..a pre-defined character memory variable which will
  543.                          contain the screen data (and some control
  544.                          information) upon return.  If the memory variable is
  545.                          not large enough to contain the total screen data
  546.                          requested it will be filled with whatever I can
  547.                          stuff into it.  Use this algorithm (Texan for
  548.                          cipher) to allocate the memory variable properly:
  549.      
  550.                          (((right - left + 1) * 2) * (bottom - top + 1)) + 6
  551.      
  552.                          The extra six (6) bytes on the end are for my
  553.                          control information.  See RESTBOX for usage of
  554.                          these.  It does not matter what the name of the
  555.                          memory variable is as long as it is a character
  556.                          type.  Use the SPACE command to allocate the
  557.                          variable.
  558.      
  559.           Examples:
  560.      
  561.                1.   To save the screen data, and current attributes, into a
  562.                     memory variable from row #10, column #20 through row #12,
  563.                     column #60.
  564.      
  565.                .
  566.                .
  567.                .
  568.                scrn1 = space((((60 - 20 + 1) * 2) * (12 - 10 + 1)) + 6)
  569.                call savebox with 10,20,12,60,scrn1
  570.                .
  571.                .
  572.                .
  573.      
  574.           Returns:
  575.      
  576.                The character memory variable will contain the data as it was
  577.                read from the screen preceded by six (6) bytes of control
  578.                information.  If this variable is released or otherwise
  579.                changed the RESTBOX function may not operate as you intended.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                        Page #9
  600.                                           
  601.                    Copyright (c) 1986, 1987 by Genesis Development
  602.  
  603.  
  604.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  605.      ===========================================================================
  606.  
  607.      Function Name: RESTBOX
  608.      
  609.           This function doesn't work too well if you don't use SAVEBOX first.
  610.           RESTBOX will restore a saved SAVEBOX memory variable to the screen
  611.           using either the original coordinates or different coordinates
  612.           provided by the programmer.  Creative use of SAVEBOX, BOX and
  613.           RESTBOX can move stuff all over the screen making the user think
  614.           you're a real wizard!
  615.           
  616.           RESTBOX in its current form uses the IBM standard BIOS interrupt
  617.           for writing to the screen.  Given this it will not "pop" onto the
  618.           screen on computers with slower clock cycles (4.77MHz - 6.0MHz).
  619.           If the need arises I will write a different version to do direct
  620.           screen writing.
  621.      
  622.           Format:
  623.      
  624.                As a function -
  625.      
  626.                     restbox([top,left,]scrnarea)
  627.      
  628.                As a procedure -
  629.      
  630.                     call restbox with [top,left,]scrnarea
  631.      
  632.           Parameters:
  633.      
  634.                top.......topmost row of the area to be changed.  Value
  635.                          checked to be between 0 and 24 inclusive.  This is
  636.                          NOT a mandatory parameter, however if TOP is
  637.                          specified then LEFT must also be specified.  If
  638.                          TOP,LEFT is not specified RESTBOX will obtain the
  639.                          original position from within the SAVEBOX'd
  640.                          variable.
  641.                
  642.                left......leftmost column of the area to be changed.  Value
  643.                          checked to be between 0 and 79 inclusive.  This is
  644.                          NOT a mandatory parameter, however if LEFT is
  645.                          specified then TOP must also be specified.
  646.                
  647.                scrnarea..a character memory variable containing a saved
  648.                          portion of the screen.  This area must have been
  649.                          saved by SAVEBOX.  No changes to this memory
  650.                          variable should have occurred between the SAVEBOX
  651.                          command and RESTBOX.
  652.      
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.                                       Page #10
  667.                                           
  668.                    Copyright (c) 1986, 1987 by Genesis Development
  669.  
  670.  
  671.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  672.      ===========================================================================
  673.  
  674.      RESTBOX (cont'd)
  675.      
  676.           Examples:
  677.      
  678.                1.   This will restore a previously saved screen area to the
  679.                     original location.
  680.      
  681.                .
  682.                .
  683.                .
  684.                restbox(scrn1)
  685.                .
  686.                .
  687.                .
  688.      
  689.                2.   This will restore a previously saved screen area row #10,
  690.                     column #20 even if this is a different location than it
  691.                     was originally obtained from.
  692.      
  693.                .
  694.                .
  695.                .
  696.                restbox(10,20,scrn1)
  697.                .
  698.                .
  699.                .
  700.      
  701.                3.   A typical SAVEBOX and RESTBOX combination.
  702.      
  703.                .
  704.                .
  705.                .
  706.                scrn1 = space((((60 - 20 + 1) * 2) * (12 - 10 + 1)) + 6)
  707.                call savebox with 10,20,12,60,scrn1
  708.                .
  709.                .
  710.                .
  711.                restbox(scrn1)
  712.                .
  713.                .
  714.                .
  715.      
  716.           Returns:
  717.      
  718.                Not a thing.  The screen area is restored per instructions.
  719.                If the new TOP,LEFT of the screen area forces the BOTTOM,RIGHT
  720.                of the area off the screen the program will restore what it
  721.                can to the screen stopping at the 79th column and 24th line.
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                       Page #11
  734.                                           
  735.                    Copyright (c) 1986, 1987 by Genesis Development
  736.  
  737.  
  738.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  739.      ===========================================================================
  740.  
  741.      Function Name: CURSOR
  742.      
  743.           Rumor control has it that future versions of CLIPPER will have a
  744.           cursor handling function built in, but that it still won't give the
  745.           control this function gives.  Many is the time I wished I could set
  746.           the cursor to a different size, or make it disappear.  Well I
  747.           wished one time too many and wrote this function to solve the
  748.           problem.
  749.      
  750.           Since I do not have access to one of the new nifty keen hi
  751.           resolution monitor types recently released by Big Blue I haven't a
  752.           clue how this will function.  I am assuming two monitor types,
  753.           color (or B&W) and monochrome in this function.  If you have a
  754.           different type of monitor I would be interested in hearing how this
  755.           works.
  756.      
  757.           Format:
  758.      
  759.                As a function -
  760.      
  761.                     cursor('[std,off,half,full]')
  762.      
  763.                As a procedure -
  764.      
  765.                     call cursor with '[std,off,half,full]'
  766.      
  767.           Parameters:
  768.      
  769.                std.......sets the cursor to the default for the current
  770.                          monitor type.  Parameter may be either a literal (as
  771.                          in the examples) or a memory variable.  Case is
  772.                          insignificant as the function will perform case
  773.                          conversion prior to validation. If this is a color
  774.                          monitor then the cursor will be activated for video
  775.                          scan lines 6 thru 7.  For a monochrome monitor the
  776.                          standard activated scan lines are 12 thru 13.
  777.      
  778.                off.......sets the cursor off.  The cursor will not show on
  779.                          the current monitor.  Parameter may be either a
  780.                          literal (as in the examples) or a memory variable.
  781.                          Case is insignificant as the function will perform
  782.                          case conversion prior to validation.
  783.      
  784.                half......sets the cursor to one half of the total character
  785.                          size for the current monitor type.  Parameter may be
  786.                          either a literal (as in the examples) or a memory
  787.                          variable.  Case is insignificant as the function
  788.                          will perform case conversion prior to validation.On
  789.                          a color monitor this is scan lines 4 thru 7 and on a
  790.                          monochrome monitor is scan lines 7 thru 13.
  791.      
  792.                full......sets the cursor to cover the total character
  793.                          position for the current monitor type.  Parameter
  794.                          may be either a literal (as in the examples) or a
  795.  
  796.  
  797.  
  798.  
  799.  
  800.                                       Page #12
  801.                                           
  802.                    Copyright (c) 1986, 1987 by Genesis Development
  803.  
  804.  
  805.      PROCLIP.LIB v1.00 Documentation                             August 23, 1987
  806.      ===========================================================================
  807.  
  808.      CURSOR (cont'd)
  809.      
  810.                          memory variable.  Case is insignificant as the
  811.                          function will perform case conversion prior to
  812.                          validation.
  813.      
  814.           Examples:
  815.      
  816.                1.   Set the cursor to one half of the current size and then
  817.                     turn it off for some other activity.
  818.      
  819.                .
  820.                .
  821.                .
  822.                cursor('half')
  823.                .
  824.                .
  825.                .
  826.                cursor('off')
  827.                .
  828.                .
  829.                .
  830.      
  831.           Returns:
  832.      
  833.                Nothing.  Cursor is modified per the request or if the request
  834.                is invalid the command is ignored.
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.                                       Page #13
  868.                                           
  869.                    Copyright (c) 1986, 1987 by Genesis Development
  870.  
  871.