curs_overlay(3CURSES)					     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 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 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

NOTES

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

       Note that overlay() and overwrite may be macros.

SunOS 5.11							    31 Dec 1996 					     curs_overlay(3CURSES)