inquire_display_mode(3G)

NAME

inquire_display_mode − return the current configuration for the display.

SYNOPSIS

C Syntax:

void inquire_display_mode(fildes,cmap_mode,dbuffer_mode,
planes,current_buffer);
int fildes,*cmap_mode,*dbuffer_mode,*planes,*current_buffer;

FORTRAN77 Syntax:

subroutine inquire_display_mode(fildes,cmap_mode,dbuffer_mode,
planes,current_buffer);
integer*4 fildes,cmap_mode,dbuffer_mode,planes,current_buffer;

Pascal Syntax:

procedure inquire_display_mode(fildes:integer;var cmap_mode,dbuffer_mode,
planes,current_buffer:integer);

DESCRIPTION

Input Parameters

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

Output Parameters

cmap_mode Specifies how the Starbase color map is setup. CMAP_NORMAL, CMAP_MONOTONIC, and CMAP_FULL are possible values.

dbuffer_mode Specifies whether double-buffering is on or off and whether the buffer drawn to is the same as the one that is displayed. See double_buffer(3G) under mode for more specific information.

planes Specifies the number of planes in each buffer for input. The value may be 1, 2, 3, 4, 6, 8 or 12 (or 0 if dbuffer_mode is off).

current_buffer
Least significant bit of this integer determines which buffer (odd(1) or even(0)) is enabled for drawing. See dbuffer_switch(3G) under buffer for more specific information.

Discussion

Inquire_display_mode can be used to determine how the information in the frame buffer will be displayed. It returns the current color map mode (as set by shade_mode), the current double-buffering mode (as set by double_buffer), and which buffer is being displayed. This information is most useful when using an X.11 window since some of these values may be different than the normal Starbase defaults.

Museum

Related Articles