FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) NAME NAME NAME NAME fagetinfo - find out information about the display device SYNOPSIS SYNOPSIS SYNOPSIS SYNOPSIS #include #include #include #include int int int int fagetinfo( fd, fainfoptr ) fagetinfo( fd, fainfoptr ) fagetinfo( fd, fainfoptr ) fagetinfo( fd, fainfoptr ) int fd; int fd; int fd; int fd; struct fainfo *fainfoptr; struct fainfo *fainfoptr; struct fainfo *fainfoptr; struct fainfo *fainfoptr; int int int int fasetinfo( fd, fainfoptr ) fasetinfo( fd, fainfoptr ) fasetinfo( fd, fainfoptr ) fasetinfo( fd, fainfoptr ) int fd; int fd; int fd; int fd; struct fainfo *fainfoptr; struct fainfo *fainfoptr; struct fainfo *fainfoptr; struct fainfo *fainfoptr; DESCRIPTION DESCRIPTION DESCRIPTION DESCRIPTION _________ is used to find out the size of the display device fagetinfo or window and which video attributes it supports. A pointer to the fainfo structure is passed. fainfo fainfo fainfo struct fainfo { struct fa_rectangle size; int capabilities; int enhancements; int defaultenhancements; int cursor; int fontcellheight; int fontcellwidth; int foregroundplanes; int backgroundplanes; /* * Use up this variable when adding new fields in order to * maintain a constant structure size of 32 * int-equivalents. Until this expansion space is gone, * old object code will not need to be re-compiled. When * the structure actually requires more storage space, * source code must be re-compiled. */ int ___expansion[20]; }; This structure (defined in ) is filled with data as follows. Fa_rectangle is a structure defined in and Fa_rectangle Fa_rectangle Fa_rectangle is set to [0,0], [maxcolumns,maxlines]. Capabilities is Capabilities Capabilities Capabilities assigned the bitwise OR-ing of some flags defined in the header file. Please see the device-dependent manual entry Hewlett-Packard - 1 - (printed 12/14/84) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) FAGETINFO(3D) HP Integral PC (Proposed) FAGETINFO(3D) for each driver to determine the capabilities represented in the capabilities field. capabilities capabilities capabilities Enhancements is assigned the bitwise OR-ing of the various Enhancements Enhancements Enhancements enhancement bits defined in the header file (see also farectwrite.3d) which are supported by the particular device. Care is needed when testing this value because of the values chosen for the enhancements. Defaultenhancements Defaultenhancements Defaultenhancements Defaultenhancements is initially assigned a device-dependent value (by the FastAlpha driver) appropriate for monochrome displays. Defaultenhancements is a read/write field - that is, it can Defaultenhancements Defaultenhancements Defaultenhancements be changed by calling _________. This value is used by fasetinfo _______ and ______. fawrite faroll Cursor is TRUE if the cursor may be physically removed from Cursor Cursor Cursor the display and is FALSE otherwise. Fontcellheight and fontcellwidth determine the size (in Fontcellheight fontcellwidth Fontcellheight fontcellwidth Fontcellheight fontcellwidth pixels) of the font cell on a bitmapped display. These fields are set to zero(0) where inappropriate (ie... on alpha-plane terminals). foregroundplanes and backgroundplanes specify the number of foregroundplanes backgroundplanes foregroundplanes backgroundplanes foregroundplanes backgroundplanes memory planes available for controlling the foreground and background colors, respectively. A value of 1 in foregroundplanes and zero(0) in backgroundplanes indicates a foregroundplanes backgroundplanes foregroundplanes backgroundplanes foregroundplanes backgroundplanes monochrome system. The 9836CU is specified by: foregroundplanes = 3 and backgroundplanes = 0. foregroundplanes = 3 backgroundplanes = 0 foregroundplanes = 3 backgroundplanes = 0 foregroundplanes = 3 backgroundplanes = 0 Where three or more color planes are available, the first eight colors are constructed by OR-ing FARED(1), FAGREEN(2), and FABLUE(4) to obtain the "normal" colors. These values are defined in . Colors outside this range are device dependent (see the device-dependent driver manual entries). The fainfo structure is meant to be extensible to account fainfo fainfo fainfo for future devices. The method for extending the structure is explained in the contained comment. _________ is the counterpart of _________ for changing the Fasetinfo fagetinfo parameters of a display. Currently, all parameters except defaultenhancements are read-only. defaultenhancements defaultenhancements defaultenhancements FILES FILES FILES FILES /usr/include/fa.h /usr/lib/libfa.a SEE ALSO SEE ALSO SEE ALSO SEE ALSO facursor(3D), fagetinfo(3D), fainit(3D), faintro(3D), farectwrite(3D), faroll(3D), fawrite(3D) Hewlett-Packard - 2 - (printed 12/14/84)