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.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004