curs_clear(3X)							curs_clear(3X)

NAME    [Toc]    [Back]

     curs_clear:  erase, werase, clear,	wclear,	clrtobot, wclrtobot, clrtoeol,
     wclrtoeol - clear all or part of a	curses window

SYNOPSIS    [Toc]    [Back]

     # include <curses.h>

     int erase(void);

     int werase(WINDOW *win);
     int clear(void);

     int wclear(WINDOW *win);
     int clrtobot(void);

     int wclrtobot(WINDOW *win);
     int clrtoeol(void);

     int wclrtoeol(WINDOW *win);

DESCRIPTION    [Toc]    [Back]

     The erase and werase routines copy	blanks to every	position in the
     window.

     The clear and wclear routines are like erase and werase, but they also
     call clearok, so that the screen is cleared completely on the next	call
     to	wrefresh for that window and repainted from scratch.

     The clrtobot and wclrtobot	routines erase all lines below the cursor in
     the window.  Also,	the current line to the	right of the cursor,
     inclusive,	is erased.

     The clrtoeol and wclrtoeol	routines erase the current line	to the right
     of	the cursor, inclusive.

RETURN VALUE    [Toc]    [Back]

     All routines return the integer OK, or a non-negative integer if immedok
     is	set.

NOTES    [Toc]    [Back]

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

     Note that erase, werase, clear, wclear, clrtobot, and clrtoeol may	be
     macros.

SEE ALSO    [Toc]    [Back]

     curses(3X), curs_outopts(3X), curs_refresh(3X)
clear(3G)							     clear(3G)

NAME    [Toc]    [Back]

     clear - clears the	viewport

C SPECIFICATION    [Toc]    [Back]

     void clear()

PARAMETERS    [Toc]    [Back]

     none

DESCRIPTION    [Toc]    [Back]

     clear sets	the bitplane area of the viewport to the current color.
     Multiple bitplane buffers can be cleared simultaneously using the
     backbuffer, frontbuffer, and zdraw	commands.  Current polygon fill
     pattern and writemask affect the operation	of clear.  The screen mask,
     when it is	set to a subregion of the viewport, bounds the cleared region.
     Alpha function, blend function, logical operation,	stenciling, texture
     mapping, and z buffering, however,	are ignored by clear.  Stencil and z
     buffer contents are not affected by clear (except in the special case of
     zdraw).

     Like other	drawing	commands, clear	operates on the	currently active
     framebuffer, one of normal, popup,	overlay, or underlay, based on the
     current draw mode (see drawmode).

     After clear executes, the graphics	position is undefined.

SEE ALSO    [Toc]    [Back]

     afunction,	backbuffer, blendfunction, czclear, defpattern,	drawmode,
     frontbuffer, logicop, scrmask, setpattern,	stencil, texbind, zbuffer,
     zdraw

NOTE    [Toc]    [Back]

     On	the IRIS-4D B, G, GT, GTX, and VGX models, clear runs faster when the
     window is completely unobscured.

     On	the Personal Iris, XS, XS24, XZ, Elan and Extreme systems, clear runs
     faster when the visible window area consists of four or fewer rectangular
     regions.


									PPPPaaaaggggeeee 1111