curs_overlay(3X)        LIBRARY FUNCTIONS        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).
















                                                                1