curs_overlay(3X)					      curs_overlay(3X)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

     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    [Toc]    [Back]

     curses(3X), curs_pad(3X), curs_refresh(3X)


									PPPPaaaaggggeeee 1111