FARECTWRITE(3W)
Series 300 and 500 Only
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 include:
FAOFF
FAINVERSE
FABLINK
FAUNDERLINE
FAHALFBRIGHT
The set of enhancements supported by a particular device should first be determined by calling fagetinfo. Legal enhancement values are formed from the bitwise or-ing 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.
HARDWARE DEPENDENCIES
Series 500:
Fast alpha routines do not support HP-15 (2-byte) fonts on Series 500.
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 — May 11, 2021