curs_bkgd(3X)           LIBRARY FUNCTIONS           curs_bkgd(3X)



NAME
     cursbkgd:  bkgdset, wbkgdset, bkgd, wbkgd -  curses  window
     background manipulation routines

SYNOPSIS
     #include <curses.h>

     void bkgdset(chtype ch);
     void wbkgdset(WINDOW *win, chtype ch);
     int bkgd(chtype ch);
     int wbkgd(WINDOW *win, chtype ch);

DESCRIPTION
     The bkgdset and wbkgdset routines manipulate the  background
     of  the  named window.  Background is a chtype consisting of
     any combination of attributes and a character.   The  attri-
     bute  part  of  the  background  is combined (ORed) with all
     non-blank characters that are written into the window   with
     waddch.  Both the character and attribute parts of the back-
     ground are combined with the blank  characters.   The  back-
     ground  becomes  a  property of the character and moves with
     the  character  through  any  scrolling  and   insert/delete
     line/character operations.  To the extent possible on a par-
     ticular terminal, the attribute part of  the  background  is
     displayed  as  the graphic rendition of the character put on
     the screen.  The bkgd and wbkgd  routines  combine  the  new
     background with every position in the window.  Background is
     any combination of attributes and  a  character.   Only  the
     attribute  part  is  used to set the background of non-blank
     characters, while both character and attributes are used for
     blank  positions.   To  the  extent possible on a particular
     terminal, the attribute part of the background is  displayed
     as the graphic rendition of the character put on the screen.

RETURN VALUE
     bkgd and wbkgd return the  integer  OK,  or  a  non-negative
     integer, if immedok is set.

NOTES
     The header file <curses.h> automatically includes the header
     files <stdio.h> and <unctrl.h>.

     Note that bkgdset and bkgd may be macros.

SEE ALSO
     curses(3X), cursaddch(3X), cursoutopts(3X).









                                                                1