overlay(3X)                                                     overlay(3X)

NAME
     overlay, overwrite - copy overlapped windows

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int overlay(const WINDOW *srcwin, WINDOW *dstwin);

     int overwrite(const WINDOW *srcwin, WINDOW *dstwin);

DESCRIPTION
     The overlay() and overwrite() functions overlay srcwin on top of
     dstwin. The scrwin and dstwin arguments need not be the same size;
     only text where the two windows overlap is copied.

     The overwrite() function copies characters as though a sequence of
     winwch() and waddwch() were performed with the destination window's
     attributes and background attributes cleared.

     The overlay() function does the same thing, except that, whenever a
     character to be copied is the background character of the source win-
     dow, overlay() does not copy the character but merely moves the desti-
     nation cursor the width of the source background character.

     If any portion of the overlaying window border is not the first column
     of a multi-column character then all the column positions will be
     replaced with the background character and rendition before the over-
     lay is done. If the default background character is a multi-column
     character when this occurs, then these functions fail.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.

SEE ALSO
     copywin(3X), curses(3X), curses(5).














Page 1                       Reliant UNIX 5.44                Printed 11/98