GSQDSP(3g,L)                AIX Technical Reference                GSQDSP(3g,L)



-------------------------------------------------------------------------------
gsqdsp



PURPOSE

Returns characteristics of the display monitor and adapter.

C SYNTAX

void gsqdsp_ (display)

int *display;

FORTRAN SYNTAX

subroutine gsqdsp (display)

INTEGER display (32)

PASCAL SYNTAX

PROCEDURE gsqdsp_ (

VAR display: ARRAY [1..32] of INTEGER) [PUBLIC];

DESCRIPTION

The gsqdsp subroutine returns an array containing the display adapter and
monitor characteristics.

Parameter

display           Contains, on return, the relevant display/monitor
                  characteristics.  The following table describes the
                  information in the array.  Each entry is a word.

Entry    Description (measure)

1        Display/monitor ID.  For a printer or plotter, this value is "  HC",
         right-justified in the word.
2        Displayed width of the frame buffer in pixels.
3        Displayed height of the frame buffer in pixels.
4        Physical width of display in millimeters.
5        Physical height of display in millimeters.
6        Number of bit planes or number of bits/pixel.








Processed July 12, 1991          GSQDSP(3g,L)                                 1






GSQDSP(3g,L)                AIX Technical Reference                GSQDSP(3g,L)



Entry    Description (measure)

7        Adapter characteristic flags.  (Bit 0 is the most significant bit.)
         Bits set these characteristics:

         0     Color or monochrome; 0 = color, 1 = monochrome
         1     By plane or by pixel; 0 = by plane, 1= by pixel (always 1 for
               printers and plotters).
         2     Software or hardware cursor; 0 = software, 1 = hardware (always
               0 for printers and plotters).
         3-31  Reserved bits.

8        Number of bits for Red digital-to-analog converter (always 2 for
         printers and plotters).
9        Number of bits for Green digital-to-analog converter (always 2 for
         printers and plotters).
10       Number of bits for Blue digital-to-analog converter (always 2 for
         printers and plotters).
11       Minimum cursor width (pixels) (always 0 for printers and plotters).
12       Minimum cursor height (pixels) (always 0 for printers and plotters).
13       Maximum cursor width (pixels) (always 0 for printers and plotters).
14       Maximum cursor height (pixels) (always 0 for printers and plotters).
15       Color table size.  For printers and plotters, this specifies the
         number of colors.
16       Font class:

         1  Compressed (always 1 for printers and plotters).
         2  Uncompressed.

17       Logical operation capability.

         If the value is 0, the adapter supports all 16 two-operand logical
         operations and all 256 three-operand logical operations.  If nonzero,
         the most significant bits represent the two-operand logical operations
         supported; bit 0 corresponds to logical operation 0, bit 1 to logical
         operation 1, and so on (see "gslop").
18-32    Reserved.

Information from this query can be used to scale application coordinates to
those of the frame buffer.

Even if the adapter supports no logical operations, the results of the query
indicate that the adapter supports REPLACE and Exclusive-or (logical operations
3 and 6, respectively).  The GSL emulates the latter, if necessary.

RELATED INFORMATION

In this book:  "hft" and "gslop."







Processed July 12, 1991          GSQDSP(3g,L)                                 2