


curs_overlay(3X)                                 curs_overlay(3X)


NNAAMMEE
       ccuurrss__oovveerrllaayy:  oovveerrllaayy,  oovveerrwwrriittee,  ccooppyywwiinn - overlay and
       manipulate overlapped ccuurrsseess windows

SSYYNNOOPPSSIISS
       ##iinncclluuddee <<ccuurrsseess..hh>>

       iinntt oovveerrllaayy((WWIINNDDOOWW **ccoonnsstt ssrrccwwiinn,, WWIINNDDOOWW **ddssttwwiinn));;
       iinntt oovveerrwwrriittee((WWIINNDDOOWW **ccoonnsstt ssrrccwwiinn,, WWIINNDDOOWW **ddssttwwiinn));;
       iinntt ccooppyywwiinn((WWIINNDDOOWW **ssrrccwwiinn,, WWIINNDDOOWW **ddssttwwiinn,, iinntt ssmmiinnrrooww,,
             iinntt ssmmiinnccooll,, iinntt ddmmiinnrrooww,, iinntt ddmmiinnccooll,, iinntt ddmmaaxxrrooww,,
             iinntt ddmmaaxxccooll,, iinntt oovveerrllaayy));;

DDEESSCCRRIIPPTTIIOONN
       The oovveerrllaayy and oovveerrwwrriittee routines overlay _s_r_c_w_i_n  on  top
       of  _d_s_t_w_i_n.   _s_c_r_w_i_n and _d_s_t_w_i_n are not required to be the
       same size; only text where  the  two  windows  overlap  is
       copied.  The difference is that oovveerrllaayy is non-destructive
       (blanks are not copied) whereas oovveerrwwrriittee is  destructive.

       The  ccooppyywwiinn  routine provides a finer granularity of con-
       trol over the oovveerrllaayy and oovveerrwwrriittee routines.  Like in the
       pprreeffrreesshh routine, a rectangle is specified in the destina-
       tion window, (_d_m_i_n_r_o_w, _d_m_i_n_c_o_l)  and  (_d_m_a_x_r_o_w,  _d_m_a_x_c_o_l),
       and  the  upper-left-corner coordinates of the source win-
       dow, (_s_m_i_n_r_o_w, _s_m_i_n_c_o_l).  If the argument _o_v_e_r_l_a_y is ttrruuee,
       then copying is non-destructive, as in oovveerrllaayy.

RREETTUURRNN VVAALLUUEE
       Routines  that  return an integer return EERRRR upon failure,
       and OOKK (SVr4 only specifies "an integer value  other  than
       EERRRR") upon successful completion.

NNOOTTEESS
       Note that oovveerrllaayy and oovveerrwwrriittee may be macros.

PPOORRTTAABBIILLIITTYY
       The XSI Curses standard, Issue 4 describes these functions
       (adding the const qualifiers).  It further specifies their
       behavior  in  the  presence  of characters with multi-byte
       renditions (not yet supported in this implementation).

SSEEEE AALLSSOO
       ccuurrsseess(3X), ccuurrss__ppaadd(3X), ccuurrss__rreeffrreesshh(3X)













                                                                1


