Curses Library Functions                    curs_overlay(3CURSES)

NAME
     curs_overlay, overlay,  overwrite,  copywin  -  overlap  and
     manipulate overlapped curses windows

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include <curses.h>

     int overlay(WINDOW *srcwin, WINDOW *dstwin);

     int overwrite(WINDOW *srcwin, WINDOW *dstwin);

     int copywin(WINDOW *srcwin, WINDOW *dstwin, int sminrow, int
     smincol, int dminrow, int dmincol, int dmaxrow, int dmaxcol,
     int overlay);

DESCRIPTION
     The overlay() and overwrite() routines overlay srcwin on top
     of dstwin. scrwin and dstwin are not required to be the same
     size; only text where the two windows overlap is copied. The
     difference  is that overlay() is non-destructive (blanks are
     not copied) whereas overwrite() is destructive.

     The copywin() routine provides a finer granularity  of  con-
     trol  over  the  overlay() and overwrite() routines. Like in
     the prefresh() routine, a rectangle is specified in the des-
     tination  window, (dminrow, dmincol) and (dmaxrow, dmaxcol),
     and the upper-left-corner coordinates of the source  window,
     (sminrow,  smincol).  If  the argument overlay is true, then
     copying is non-destructive, as in overlay().

RETURN VALUES
     Routines that return an integer return ERR upon failure  and
     an integer value other than ERR upon successful completion.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|

SEE ALSO
     curs_pad(3CURSES),  curs_refresh(3CURSES),  curses(3CURSES),
     attributes(5)

NOTES

SunOS 5.8           Last change: 31 Dec 1996                    1

Curses Library Functions                    curs_overlay(3CURSES)

     The header <curses.h>  automatically  includes  the  headers
     <stdio.h> and <unctrl.h>.

     Note that overlay() and overwrite may be macros.

SunOS 5.8           Last change: 31 Dec 1996                    2