farectwrite(3w)
NAME
farectwrite − fill an area of the window with the specified character
SYNOPSIS
#include <fa.h>
int farectwrite(gfd,character,enhancement,rp);
int gfd;
int character;
int enhancement;
struct fa_rectangle *rp;
DESCRIPTION
gfd is an integer file descriptor for an gopened device interface
character is the character to be used to fill the given rectangle area. Only 1-byte character codes may be used; 2-byte characters cannot be used for the rectangle fill.
enhancement is the enhancement to be used in the rectangle fill operation.
rp is the pointer to the data structure which describes the rectangle to be filled.
DISCUSSION
This routine writes what is defined by character and enhancement to all positions in the area bounded by the rectangle pointed to by rp.
Legal enhancements are:
FAOFF
FAINVERSE
FAUNDERLINE
The set of enhancements supported by a particular device should first be determined by calling fagetinfo. Legal enhancement values are formed from the bitwise ORing of the desired enhancements which are supported by the particular device. If no enhancement is given, i.e., enhancement is 0 (zero), defaultenhancements, from fasetinfo, is used. The user may indicate that no enhancements are desired by using FAOFF for the enhancement.
By default, fast alpha “writes” update the screen immediately. It is possible to get better performance by buffering writes and updating the screen after the writes 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
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