MirOS Manual: copywin(3), curs_overlay(3), overlay(3), overwrite(3)


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

NAME

     overlay, overwrite, copywin - overlay and manipulate
     overlapped curses windows

SYNOPSIS

     #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-
     row,
           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  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.

RETURN VALUE

     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.

NOTES

     Note that overlay and overwrite may be macros.

PORTABILITY

     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).

SEE ALSO

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

MirOS BSD #10-current  Printed 03.04.2017                       1

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

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