curs_overlay(3ocurses)

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

Synopsis

cc [flag . . .] file -locurses [library . . .]

#include <ocurses.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.

References

curses(3ocurses), curs_pad(3ocurses), curs_refresh(3ocurses)

Notices

The header file ocurses.h automatically includes the header files stdio.h and unctrl.h.

Note that overlay and overwrite may be macros.