INQUIRE_FB_CONFIGURATION(3G)

NAME

inquire_fb_configuration − inquire the memory configuration of the frame buffer

SYNOPSIS

C Syntax:

void inquire_fb_configuration(fildes,image_banks,image_planes,
planes_per_bank,overlay_planes);
int fildes,*image_banks,*image_planes,*planes_per_bank,*overlay_planes;

FORTRAN77 Syntax:

subroutine inquire_fb_configuration(fildes,image_banks,
image_planes,planes_per_bank,overlay_planes)
integer*4 fildes,image_banks,image_planes,
planes_per_bank,overlay_planes

Pascal Syntax:

procedure inquire_fb_configuration (fildes:integer;
var image_banks,image_planes,planes_per_bank,overlay_planes:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

Output Parameters

image_banks Number of image banks supported by the device.

image_planes Total number of image planes supported by the device.

planes_per_bank Number of image planes in each bank

overlay_planes Total number of overlay planes supported by the device.

Discussion

The memory configuration of the frame buffer is returned in the output parameters. These values may be used in determining the range of viable parameter values for such procedures as bank_switch, double_buffer, and shade_mode.

Note that planes_per_bank times image_banks does not equal the number of image planes on devices that cannot display all banks simultaneously.

Devices with dedicated zbuffers may report zbuffer banks along with displayable banks in the image_banks parameter. This is to enable applications that wish to directly access the zbuffer a means to detect its presence. See the Starbase Device Drivers Library Manual for details.

Museum

Related Articles