NAME

faclear − clear the window area specified by the given rectangle

SYNOPSIS

#include <fa.h>
int faclear(gfd,reserved,rp);
int gfd;
int reserved;
struct fa_rectangle *rp;

DESCRIPTION

gfd is an integer file descriptor for an gopened device interface. 

reserved this field is reserved for future expansion

rp is the pointer to the data structure which describes the rectangle to be cleared. 

DISCUSSION

This routine clears the area bounded by the rectangle pointed to by rp. 

By default, this routine clears the screen immediately.  It is possible to get better performance by buffering clear operations and updating the screen after several operations are buffered.  See fasetinfo(3w) and the fa.h header file for information on how to buffer-up writes, as opposed to having them occur when this routine is called. 

SEE ALSO

fagetinfo(3w). 

DIAGNOSTICS

A value of −1 is returned if gfd is invalid or a call to fainit was never executed on this gfd.  See errno(2) for further information. 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994