curs_overlay(3) [osf1 man page]

curs_overlay(3) 					     Library Functions Manual						   curs_overlay(3)

NAME

       curs_overlay, copywin, overlay, overwrite - Overlap and manipulate overlapped Curses windows

SYNOPSIS

       #include <curses.h>

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

LIBRARY

       Curses Library (libcurses)

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       copywin, overlay, overwrite:  XCURSES4.2

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

DESCRIPTION

       The  overlay  and  overwrite  routines  overlay srcwin on top of dstwin.  The scrwin and dstwin parameters do not have to be the same size;
       Curses copies only the text in the region where the two windows overlap. The difference between the routines is that overlay is nondestruc-
       tive (blanks are not copied), whereas overwrite is destructive.

       The  copywin  routine provides a finer granularity of control over the same operation performed by overlay and overwrite. Like the prefresh
       routine, copywin specifies a rectangle 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 nondestructive, as is the case for
       the overlay function.

NOTES

       The header file <curses.h> automatically includes the header file <stdio.h>.

RETURN VALUES

       These routines return ERR upon failure and OK upon successful completion.

SEE ALSO

       Functions: curses(3), curs_pad(3), curs_refresh(3)

       Others: standards(5)

																   curs_overlay(3)

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)