curs_overlay(3X)curs_overlay(3X)NAME
curs_overlay: 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 ALSOcurses(3X), curs_pad(3X), curs_refresh(3X)
Page 1
