curs_overlay(3X)                  SDK R4.11                 curs_overlay(3X)


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

SYNOPSIS
       #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 control over the
       overlay and overwrite routines.  Like in the prefresh routine, a
       rectangle is specified in the destination 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 VALUE
       Routines that return an integer return ERR upon failure and an
       integer value other than ERR upon successful completion.

NOTES
       The header file <curses.h> automatically includes the header files
       <stdio.h> and <unctrl.h>.

       Note that overlay and overwrite may be macros.

SEE ALSO
       curses(3X), curspad(3X), cursrefresh(3X).


Licensed material--property of copyright holder(s)