!short: v_spage
         ^bv_spage -- set active display page^b

        ^UUSAGE^U

          v_spage(page)
          int page;

                page - video page to switch the display to

          v_spage is a general purpose routine that can be used outside 
          of the window environment.  

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          Color card only.
!short: v_cls
         ^bv_cls -- clear entire video screen ^b

        ^UUSAGE^U

          v_cls(atrib)
          int atrib;

                atrib - attribute to be used 

          v_cls clears the entire video screen to the specified attribute 
          and places the cursor in the upper left hand corner of the 
          screen.

          v_cls is a general purpose routine that can be used outside of 
          the window environment. 

          Attributes are defined in windows.h.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_smode
         ^bv_smode -- set video mode^b

        ^UUSAGE^U

          v_smode(mode)
          int mode;

                mode - mode to set the display to

          v_smode is a general purpose routine which can be used outside 
          of the window environment.

          Modes are defined in windows.h.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_wca
         ^bv_wca -- write character and attribute^b

        ^UUSAGE^U

          v_wca(page, char, atrib, count);
          int page, char, atrib, count;

                page -  video page #
                char -  character to write
                atrib - attribute to use
                count - number of times two repeat

          v_wca writes the character defined by char count times starting 
          at the current cursor location.     

          v_wca is a general purpose routine that can be used outside of 
          the window environment. 

          Attributes are defined in windows.h.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_wtty
         ^bv_wtty -- write character TTY mode^b

        ^UUSAGE^U

          v_wtty(char);
          int  char;

                char -  character to write

        v_wtty writes the character defined by char at the current cursor 
        location.  

          v_wtty is a general purpose routine that can be used outside of 
          the window environment. 

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_locate
         ^bv_locate -- locate (position) cursor^b

        ^UUSAGE^U

          v_locate(page, row, col);
          int page, row, col;

                page - video page #
                row  - row to position to
                col  - column to position to
          
          v_locate positions the cursor to the absolute coordinates 
          specified by row and col on the specified page.  The upper left 
          hand corner of the screen is (0,0).

          v_locate is a general purpose routine that can be used outside 
          of the window environment.

          Row and Col are range checked.  You CAN position the cursor 
          slightly (25,80) off the screen.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_hidec
         ^bv_hidec -- hide cursor^b

        ^UUSAGE^U

          v_hidec();

          The physical cursor is located off the screen.

          This function does not affect any virtual cursor coordinates, 
          it simply hides the physical cursor from view.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_sctype
         ^bv_sctype -- set cursor type (style)^b

        ^UUSAGE^U

          v_sctype(type, start, end);
          int type, start, end;

                type -  cursor style code (0=hidden, 1=normal, 2=slow, 3=fast)
                start - start scan line
                end -   end scan line

          As an example, to set a slow flashing block style cursor invoke 
          this function with type=1, start=6, and end=12 (color card).

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          Color and Monochrome adapters only. 
          Not for use on the 3270 PC or Enhanced Graphics Adapters.
!short: v_sapu
         ^bv_sapu -- scroll active display page up^b

        ^UUSAGE^U

          v_sapu(nl, rul, cul, rlr, clr, atrib);
          int nl, rul, cul, rlr, clr, atrib;

                nl  - number of lines to scroll
                rul - row of upper left hand corner of scroll area
                cul - column of upper left hand corner of scroll area
                rlr - row of lower right corner of scroll area
                clr - column of lower right corner of scroll area
                atrib - attribute to be used for blanking

          A value of 0 for nl scrolls (blanks) the entire area.  To clear 
          the entire video screen use v_sapu(0, 0, 0, 24, 79, NORMAL).

          v_sapu is a general purpose routine that can be used outside of 
          the window environment.  

          Attributes are defined in windows.h.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v+sapd
         ^bv_sapd -- scroll active display page down^b

        ^UUSAGE^U

          v_sapd(nl, rul, cul, rlr, clr, atrib);
          int nl, rul, cul, rlr, clr, atrib;

                nl  - number of lines to scroll
                rul - row of upper left hand corner of scroll area
                cul - column of upper left hand corner of scroll area
                rlr - row of lower right corner of scroll area
                clr - column of lower right corner of scroll area
                atrib - attribute to be used for blanking

          v_sapd is a general purpose routine that can be used outside of 
          the window environment.  

          A value of 0 for nl scrolls (blanks) the entire area.  To clear 
          the entire video screen use v_sapd(0, 0, 0, 24, 79, NORMAL).

          Attributes are defined in windows.h.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_rcpos
         ^bv_rcpos -- return current cursor position^b

        ^UUSAGE^U

          v_rcpos(page, row, col);
          int page;
          int *row, *col;       /* POINTERS */

                int page - video page #     
                int *row - pointer to int to receive row value
                int *col - pointer to int to receive column value

          v_rcpos is a general purpose routine that can be used outside 
          of the window environment.  

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_rvcs
         ^bv_rcvs -- return current video state^b

        ^UUSAGE^U

          v_rcvs(page, vm, cols);
          int *page, *vm, *cols;        /* POINTERS */

                int *page - pointer to int to receive current video page #
                int *vm   - pointer to int to receive current video mode
                int *cols - pointer to int to receive current screen width
          
          v_rcvs is a general purpose routine that can be used outside of 
          the window environment.

          Modes are defined in windows.h.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_getch
         ^bv_getch -- get keyboard character and scan code^b

        ^UUSAGE^U

          v_getch();

          v_getch is a general purpose routine that can be used outside 
          of the window environment.

        ^URETURNS^U

          The character and scan code.  The character is in the low order 
          byte, the scan code in the high order byte.

        ^UCAUTIONS^U

          v_getch waits for a key to be struck.
!short: v_kstat
         ^bv_kstat -- get keyboard status^b

        ^UUSAGE^U

          v_kstat();

          v_kstat is a general purpose routine that can be used outside 
          of the window environment.

        ^URETURNS^U

          TRUE if a character is available, FALSE if not.

        ^UCAUTIONS^U

          None.
!short: v_kflush
         ^bv_kflush -- flush keyboard buffer^b

        ^UUSAGE^U

          v_kflush();

          v_kflush clears the keyboard buffer of any pending input.

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
!short: v_border
         ^bv_border -- set border color^b

        ^UUSAGE^U

          v_border(color)
          int color;

             Set overscan border to specified color. 

        ^URETURNS^U

          Nothing.

        ^UCAUTIONS^U

          None.
