1curs_overlay(3CURSES)      Curses Library Functions      curs_overlay(3CURSES)
2
3
4

NAME

6       curs_overlay,  overlay,  overwrite,  copywin  -  overlap and manipulate
7       overlapped curses windows
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       int overlay(WINDOW *srcwin, WINDOW *dstwin);
14
15
16       int overwrite(WINDOW *srcwin, WINDOW *dstwin);
17
18
19       int copywin(WINDOW *srcwin, WINDOW *dstwin, int sminrow,
20            int smincol, int dminrow, int dmincol,
21            int dmaxrow, int dmaxcol, int overlay);
22
23

DESCRIPTION

25       The overlay() and overwrite() routines overlay srcwin on top of dstwin.
26       scrwin and dstwin are not required to be the same size; only text where
27       the two windows overlap is copied. The difference is that overlay()  is
28       non-destructive (blanks are not copied) whereas overwrite() is destruc‐
29       tive.
30
31
32       The copywin() routine provides a finer granularity of control over  the
33       overlay()  and  overwrite() routines. Like in the prefresh() routine, a
34       rectangle is specified in the destination  window,  (dminrow,  dmincol)
35       and  (dmaxrow,  dmaxcol),  and the upper-left-corner coordinates of the
36       source window, (sminrow, smincol). If the  argument  overlay  is  true,
37       then copying is non-destructive, as in overlay().
38

RETURN VALUES

40       Routines  that return an integer return ERR upon failure and an integer
41       value other than ERR upon successful completion.
42

ATTRIBUTES

44       See attributes(5) for descriptions of the following attributes:
45
46
47
48
49       ┌─────────────────────────────┬─────────────────────────────┐
50       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
51       ├─────────────────────────────┼─────────────────────────────┤
52       │MT-Level                     │Unsafe                       │
53       └─────────────────────────────┴─────────────────────────────┘
54

SEE ALSO

56       curs_pad(3CURSES),       curs_refresh(3CURSES),        curses(3CURSES),
57       attributes(5)
58

NOTES

60       The header <curses.h> automatically includes the headers  <stdio.h> and
61       <unctrl.h>.
62
63
64       Note that overlay() and overwrite may be macros.
65
66
67
68SunOS 5.11                        31 Dec 1996            curs_overlay(3CURSES)
Impressum