X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_overlay.3x.html;h=573cb9c22901abfb5719833cb198ee703cbcb35f;hp=69ed0fcaafa1c88945fef844a2d1974875ff1abb;hb=048a1c1a65c6d98d92fca97f8d175d10d21091d0;hpb=3a935d9991cdf43ebfa952073c9b555f73a3e011 diff --git a/doc/html/man/curs_overlay.3x.html b/doc/html/man/curs_overlay.3x.html index 69ed0fca..573cb9c2 100644 --- a/doc/html/man/curs_overlay.3x.html +++ b/doc/html/man/curs_overlay.3x.html @@ -1,7 +1,6 @@ - +
+ +- curs_overlay(3x) curs_overlay(3x) --
+
overlay, overwrite, copywin - overlay and manipulate overlapped curses windows --
+
#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); + 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); --
+
+ +
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 con- - trol over the overlay and overwrite routines. Like in the + trol over the overlay and overwrite routines. As in the prefresh routine, a rectangle is specified in the destina- tion window, (dminrow, dmincol) and (dmaxrow, dmaxcol), and the upper-left-corner coordinates of the source win- @@ -80,8 +81,7 @@ then copying is non-destructive, as in overlay. --
+
Routines that return an integer return ERR upon failure, and OK (SVr4 only specifies "an integer value other than ERR") upon successful completion. @@ -92,31 +92,39 @@ the window would be placed off-screen. --
+
Note that overlay and overwrite may be macros. --
+
The XSI Curses standard, Issue 4 describes these functions (adding the const qualifiers). It further specifies their behavior in the presence of characters with multibyte ren- ditions (not yet supported in this implementation). --
+
curses(3x), curs_pad(3x), curs_refresh(3x) curs_overlay(3x)-