NAME    [Toc]    [Back]

       curs_overlay,  copywin,  overlay,  overwrite - Overlap and
       manipulate overlapped Curses windows

SYNOPSIS    [Toc]    [Back]

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

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       copywin, overlay, overwrite:  XCURSES4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

DESCRIPTION    [Toc]    [Back]

       The overlay and overwrite routines overlay srcwin  on  top
       of  dstwin.   The scrwin and dstwin parameters do not have
       to be the same size; Curses copies only the  text  in  the
       region  where  the  two  windows  overlap.  The difference
       between the routines is  that  overlay  is  nondestructive
       (blanks are not copied), whereas overwrite is destructive.

       The copywin routine provides a finer granularity  of  control
  over  the  same  operation  performed by overlay and
       overwrite. Like the prefresh routine, copywin specifies  a
       rectangle  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  nondestructive,
       as is the case for the overlay function.

NOTES    [Toc]    [Back]

       The  header  file  <curses.h>  automatically  includes the
       header file <stdio.h>.

RETURN VALUES    [Toc]    [Back]

       These routines return ERR upon failure and  OK  upon  successful
 completion.

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_pad(3), curs_refresh(3)

       Others: standards(5)



                                                  curs_overlay(3)