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 on some devices, 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 Z-buffers may report Z-buffer banks along with displayable banks in the image_banks parameter. This provides a means to detect whether a Z-buffer is present, which in turn can be directly accessed by the application. See the Starbase Device Drivers Manual for details.

Museum

Related Articles