curs_overlay(3x) — Linux manual page


curs_overlay(3X)                                        curs_overlay(3X)

NAME         top

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

SYNOPSIS         top

       #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);

DESCRIPTION         top

   overlay, overwrite
       The  overlay and overwrite routines overlay srcwin on top of dst‐
       win.  scrwin and dstwin are not required to be the same size; on‐
       ly text where the two windows overlap is copied.  The  difference
       is that overlay is non-destructive (blanks are not copied) where‐
       as overwrite is destructive.

       The  copywin routine provides a finer granularity of control over
       the overlay and overwrite routines.  As in the prefresh  routine,
       a  rectangle  is  specified  in the destination window, (dminrow,
       dmincol) and (dmaxrow, dmaxcol), and the upper-left-corner  coor‐
       dinates  of  the source window, (sminrow, smincol).  If the argu‐
       ment overlay is true, then  copying  is  non-destructive,  as  in

RETURN VALUE         top

       Routines  that  return an integer return ERR upon failure, and OK
       (SVr4 only specifies "an integer value other than ERR") upon suc‐
       cessful 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         top

       Note that overlay and overwrite may be macros.

PORTABILITY         top

       The  XSI  Curses  standard,  Issue  4  describes  these functions
       (adding the const qualifiers).  It further specifies their behav‐
       ior in the presence of characters with multibyte renditions  (not
       yet supported in this implementation).

SEE ALSO         top

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

COLOPHON         top

       This  page is part of the ncurses (new curses) project.  Informa‐
       tion    about    the    project    can    be    found    at    
       ⟨⟩.   If you have
       a   bug   report   for   this   manual   page,   send    it    to   This  page  was  obtained from the
       project's   upstream   Git   mirror   of   the   CVS   repository
       ⟨⟩  on 2024-06-14.  (At that
       time, the date of the most recent commit that was  found  in  the
       repository  was  2023-03-12.)   If  you  discover  any  rendering
       problems in this HTML version of the page, or you  believe  there
       is  a  better or more up-to-date source for the page, or you have
       corrections or improvements to the information in  this  COLOPHON
       (which  is  not part of the original manual page), send a mail to