*** UNIX MANUAL PAGE BROWSER ***

curs_overlay(3) Library Functions Manual curs_overlay(3) NAME curs_overlay, copywin, overlay, overwrite - Overlap and manipulate overlapped Curses windows LIBRARY Curses Library (libcurses.a, libcurses.so) SYNOPSIS #include <curses.h> int overlay(const WINDOW *srcwin, WINDOW *dstwin); int overwrite(const WINDOW *srcwin, WINDOW *dstwin); int copywin(const WINDOW *srcwin, WIN- DOW *dstwin, int sminrow, int smincol, int dminrow, int dmincol, int dmaxrow, int dmaxcol, int overlay); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: overlay, overwrite: XPG4, XPG4-UNIX copywin: XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry 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 nondestructive (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 comple- tion. RELATED INFORMATION Functions: curses(3), curs_pad(3), curs_refresh(3) Others: standards(5) delim off curs_overlay(3)