MirBSD manpage: copywin(3), curs_overlay(3), overlay(3), overwrite(3)

curs_overlay(3)     UNIX Programmer's Manual      curs_overlay(3)


     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  smin-
           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  control
     over  the  overlay  and  overwrite  routines.   Like  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  window,
     (sminrow,  smincol).   If the argument overlay is true, 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.

     X/Open defines no error conditions. In this  implementation,
     copywin,  overlay and overwrite return an error if either of
     the window pointers are null, or if some part of 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 rendi-
     tions (not yet supported in this implementation).


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

MirBSD #10-current     Printed 2022-12-23                       1

Generated on 2022-12-24 01:00:14 by $MirOS: src/scripts/roff2htm,v 1.113 2022/12/21 23:14:31 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2022 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.

Kontakt / Impressum & Datenschutzerklärung