Click above to get retro games delivered to your door ever month!

  Name:     setpage() - set screen page to use to display output
  Usage:    setpage(<page>)
  Params:   integer <page> - the page to display
  Returns:  nothing

 ---------------------------------- Example ---------------------------------

                 setpage(2)
                 * Clipper now displaying page 2

                 setscreen(47104,0)
                 * set all video buffers to page 0 on Color

                 csroff()
                 * shut cursor off while writing to another page

                 box(10,10,20,70,"",23)
                 * display a box into virtual page 0 that
                 * was declared through setscreen()

                 print(11,29,"Menu choices",23)
                 * print a header to the box

                 setscreen()
                 * reset all buffers to page being displayed
                 * (does not reset the display)

                 setpage(0)
                 * display page 0 again, it now contains a box
                 * and the header that was written while viewing
                 * page 2

            The number of pages available varies depending on
            your adaptor and the amount of available video
            memory the adaptor has. No additional pages are
            available on monochrome systems. Under normal
            circumstances, the following number of pages are
            available for the specified mode:

            CGA/EGA/VGA 40x25 column mode has 8 pages numbered
            0 through 7

            CGA 80x25 column mode has 4 pages numbered 0 - 3

            EGA/VGA 80x25 column mode has 8 pages numbered
            0 through 7

            EGA/VGA 80x43 column mode has 4 pages numbered 0 - 3

            Other modes will have between 1 and 4 pages depending
            on the amount of video memory installed on the
            adaptor card. See your adaptor's reference manual
            for information on additional pages in extended modes

  Note:     Setting a page to a nonexistent page will not harm
            your monitor, however the resulting display will be
            unusable. When writing to a virtual page (one defined
            by setscreen), any movement of the cursor will appear
            on the page currently being displayed by setpage().
            If your are writing to a virtual page in the background,
            shut the cursor off while writing, otherwise you will
            see cursor movement on the page currently being
            displayed.