Series 300 and 500 Only

NAME

fasetinfo − set information about the fast alpha environment

SYNOPSIS

#include <fa.h>
int fasetinfo(gfd,fainfoptr);
int gfd;
struct fainfo *fainfoptr;

DESCRIPTION

gfd is an integer file descriptor for an opened graphics window type device interface. 

fainfoptr
is a pointer to the structure defined as follows:

struct fainfo {
struct fa_rectangle size;
int capabilities;
int enhancements;
int defaultenhancements;
int cursor;
int fontcellheight;
int fontcellwidth;
int foregroundplanes;
int backgroundplanes;
int clearbeforewrite;
int colormode;
int makecurrent;
};

Descriptions of each field in this structure are:

size A structure with one corner set to [0, 0] and the other set to [number of colums, number of lines]. (See general description.) 

Note that this parameter cannot be set by fasetinfo. It is used to obtain information via fagetinfo.

capabilities An integer assigned a value from a list in the headerfile.  The contents of capabilities may be used by a program to detect what additional capabilities are available on a particular device. Currently defined capabilities are:

FAWINDOW - Device is a window or bit-mapped graphics device. More information may be obtained by calls to other window system routines. 

Note that this parameter cannot be set by fasetinfo. It is used to obtain information via fagetinfo.

enhancements is assigned to the bitwise or-ing of the various enhancement bits (see farectwrite) which are supported by the particular device. 

defaultenhancements Is initially set to a value which optimizes the performance of the window system.  It is used by fawrite and faroll.  It is a read/write field in that it can be changed by calling fasetinfo. 

cursor Cursor is TRUE if the cursor may be physically removed from the window device and is FALSE otherwise. 

Note that this parameter cannot be set by fasetinfo. It is used to obtain information via fagetinfo.

fontcellheight, fontcellwidth Indicates the size (in pixels) of the 1-byte character fontcell.  The 2-byte characters are twice as wide. 

Note that this parameter cannot be set by fasetinfo. It is used to obtain information via fagetinfo.

clearbeforewrite Is TRUE if the fast alpha library routine is to clear the background of the area to be written to before the characters are written.   clearbeforewrite set to FALSE indicates that the user is responsible for clearing and desires no background clearing by the library routine. clearbeforewrite defaults to TRUE.  clearbeforewrite currently pertains only to FACOLOR mode; see colormode, below. 

foregroundplanes, backgroundplanes Specifies the number of memory planes available for controlling the foreground and background colors respectively.  A value of 1 in foregroundplanes and 1 in backgroundplanes indicates a monochrome system.  Values > 1 indicate a color system. 

Note that this parameter cannot be set by fasetinfo. It is used to obtain information via fagetinfo.

colormode When set to FAWONB (white on black - which is the default) indicates that the user is not using the color options.  This allows the fast alpha routines to run somewhat faster than when color is incorporated.  When colormode is set to FACOLOR, the additional system operations needed to incorporate color are performed. A third option is to set colormode to FABONW (black on white) which inverses the previous monochromatic option, FAWONB; see facolors. 

makecurrent Setting this field to bit-wise or-ing of values specified in the headerfile (/usr/include/fa.h) controls the appearance of fast alpha operations on the screen. For performance reasons, the user may choose to suppress the updating of the screen until several operations are queued up. When updating is desired, the user signals the fast alpha environment to update the screen by setting the makecurrent value to MCALWAYS (make current always). Queued up operations will show up on the screen at this time. The default value is MCALWAYS, that is, update the screen upon every fast alpha operation. 

DISCUSSION

This routine is used to set information regarding the window device, or to set new values in the fast alpha environment.  Parameters which are user−settable include: defaultenhancements, clearbeforewrite, makecurrent, and colormode. 

fasetinfo is the counterpart of fagetinfo.  It is used for changing certain parameters of a fast alpha environment. 

HARDWARE DEPENDENCIES

Series 500:
Fast alpha routines do not support HP-15 (2-byte) fonts on Series 500.

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  —  May 11, 2021