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

 WINDOWS

 The Window functions provide a way to manipulate areas on the
 screen.  The functions are powerful and easy to use.  A window can
 be opened on to the screen with an exploding effect and removed
 with an imploding effect.  A window, once defined, can be scrolled,
 panned, filled with colors and characters, cleared, written to with
 text, saved and restored from the disk, released, and used to
 perform GET/READS.

 The ClipOn Window functions work by using a variable, which
 contains a memory address, to define the window and the area the
 window occupies.  The variable containing the memory address is
 referred to as the window's reference variable.  The reference
 variable is then used by all functions to access the window.  In
 contrast, Clipper's screen saving functions return the actual
 screen area specified by the coordinates and need the coordinates
 to restore the screen.  By using a reference variable instead, the
 coordinates for a screen area only need to be coded in one place
 making the program easier to maintain and update.

 The five functions that can define a window are C_WINDOW(),
 C_XWINDOW(), C_WSAVE(), C_WMOVE(), and C_WREAD().  These functions
 return the reference variable containing the memory address of the
 specified window area.  The reference variable is then used by the
 other window functions to access and manipulate the window.  The
 number of windows that can be opened at one time is limited only by
 the amount of memory available.

 When a window is defined it serves two purposes.  First, it saves
 the screen area specified by the given coordinates to be later
 restored.  Second, it defines the same area on the screen as a
 window which can have certain characteristics such as a color,
 border type, shadow, and title.  The other window functions are
 capable of identifying the window size and characteristics, thus
 eliminating the need to keep defining these items to each window
 function.  For example, if a window needs to be scrolled down one
 line the C_WSCROLL() function only needs to know the reference
 variable and how many lines to scroll.  The size of the window, the
 color, and other items are always known to the window functions.

 Note that since the window's reference variable is an address in
 memory of the window, the variable must never be changed or
 released (while the window is being used), otherwise the window and
 the memory that it occupies will be unaccessible.

 C_WINDOW()             C_WRELEASE()
 C_XWINDOW()            C_WSAY()
 C_WSAVE()              C_WGETINFO()
 C_WRESTORE()           C_WSCROLL()
 C_WIMPLODE()           C_WPAN()
 C_WGET()               C_WWRITE()
 C_WROW()               C_WREAD()
 C_WCOL()               C_WMOVE()
 C_WCLEAR()             C_WVIEW()
 C_WFILL()