getgde(3G)

getgde - gets graphics system description

As shipped in IRIX 6.5. First release of IRIX 6.5.

NAME
     getgde - gets graphics system description

FORTRAN 77 SPECIFICATION
     integer*4 function getgde(inquir)
     integer*4 inquir

PARAMETERS
     inquiry   is a symbolic constant taken from the list below.  It
               identifies the characteristic about which you want to inquire.

FUNCTION RETURN VALUE
     The function returns the value of the requested characteristic, or -1, if
     the request is invalid or its value cannot be determined.

DESCRIPTION
     getgde allows you to inquire about characteristics of the currently
     selected screen.  If the inquired characteristic is about bitplane
     configuration, getgde will return a value that indicates the absolute
     maximum resources available for the individual characteristic. It is not
     guaranteed that the bitplane configuration will reflect these values, as
     gconfi reconciles the various requests for resources. You must call
     getgco to find out the result of the compromises made by gconfi.  You can
     call getgde prior to graphics initialization, as its return values are
     unaltered by any commands issued after initialization.

     The symbolic names of the inquiries and their meanings are specified
     below:

   Screen Boundary Inquiries
     GDXMMA
     GDYMMA
          Vertical and horizontal size of the screen in millimeters.

     GDXPMA
     GDYPMA
          Vertical and horizontal size of the screen in pixels.

     GDZMAX
     GDZMIN
          Maximum and minimum depth values that can be stored in the z-buffer
          of the normal framebuffer.

   Framebuffer Depth Inquiries
     GDBIAC
          Maximum number of bitplanes per color component in the hardware
          accumulation buffer, if one exists.  Otherwise the number of
          bitplanes per color component in the software version of the
          accumulation buffer, if it is implemented.  Otherwise 0.

     GDBIAH
          Maximum number of bitplanes per color component in the hardware
          accumulation buffer, if one exists.  Otherwise 0.

     GDBCUR
          Number of bitplanes available in the cursor.

     GDBNDA
          Maximum number of bitplanes available in the normal framebuffer to
          store alpha in double buffered RGB mode.

     GDBNDC
          Maximum number of bitplanes available in the normal framebuffer to
          store the color index in double buffered color map mode.

     GDBNDM
          Maximum number of bitplanes available in the normal framebuffer to
          store the color index in double buffered multimap mode.

     GDBNDR
     GDBNDG
     GDBNDB
          Maximum number of bitplanes available in the normal framebuffer to
          store red, green, and blue in double buffered RGB mode.  If any of
          these are 0, then double buffered RGB mode is not available.

     GDBNSA
          Maximum number of bitplanes available in the normal framebuffer to
          store alpha in single buffered RGB mode.

     GDBNSC
          Maximum number of bitplanes available in the normal framebuffer to
          store the color index in single buffered color map mode.

     GDBNSM
          Maximum number of bitplanes available in the normal framebuffer to
          store the color index in single buffered multimap mode.

     GDBNSR
     GDBNSG
     GDBNSB
          Maximum number of bitplanes available in the normal framebuffer to
          store red, green, and blue in single buffered RGB mode.  If any of
          these are 0, then single buffered RGB mode is not available.

     GDBNZB
          Maximum number of useful bitplanes in the z-buffer of the normal
          framebuffer, If 0, then there is no z-buffer.

     GDBOSC
          Maximum number of bitplanes available in the overlay framebuffer to
          store the color index in single buffered color map mode.
     GDBPSC
          Maximum number of bitplanes available in the popup framebuffer to
          store the color index in single buffered color map mode.

     GDBIST
          Maximum number of bitplanes available in the normal framebuffer for
          use as stencil bitplanes.  0 if stenci is not functional.

     GDBUSC
          Maximum number of bitplanes available in the underlay framebuffer to
          store the color index in single buffered color map mode.

   Miscellaneous Inquiries
     GDAFUN
          1 if afunct is functional, 0 if it is not.

     GDAFMO
          1 if all afunct functions are supported, 0 if they are not.

     GDALPH
          1 if alpha bitplanes in the normal framebuffer can be allocated as
          color map bitplanes in the overlay or underlay framebuffers, 0 if
          they cannot.

     GDBLEN
          1 if blending is supported in all framebuffers that support RGB
          mode, 0 otherwise.  (See blendf.)

     GDBLCO
          1 if blendc is supported in all framebuffers that support RGB mode,
          0 otherwise.

     GDCIFR
          1 if fractional interpolation of color indices is supported in all
          framebuffers, 0 otherwise.  (See colorf.)

     GDCLIP
          Number of user-defined clipping planes supported.  0 if none are
          supported.  (See clippl.)

     GDXHCI
          Color index whose color map entry controls the color of the cross-
          hair cursor.

     GDMXPS
          Number of other graphics pipes available to be video multiplexed
          with the graphics pipe associated with the current screen.

     GDDBBO
          1 if the dial and button box routines are functional, 0 if they are
          not.  Unlike most of the others, this inquiry is independent of the
          currently selected screen.  (See dbtext and setdbl.)
     GDDITH
          1 if dithering is supported.  0 otherwise.

     GDFOGV
          1 if fogver supports the per vertex fog modes, namely FGVE, FGVE2,
          and FGVL.  0 if it does not.

     GDFOGP
          1 if fogver supports the per pixel fog modes, namely FGPE, FGVP2,
          and FGPL.  0 if it does not.

     GDNATV
          0 if the IrisGL implementation is layered on OpenGL.

     GDFRAM
          1 if readso(SRCFRA) is functional, 0 if it is not.

     GDLIA2
          1 if the ATTEN2 lighting model attribute is functional, 0 if it is
          not.  (See lmdef.)

     GDLISP
          1 if spotlights are functional, 0 if they are not.  (See lmdef.)

     GDLITW
          1 if the TWOSID lighting model attribute is functional, 0 if it is
          not.  (See lmdef.)

     GDLSCM
          1 if antialiased lines are supported in the normal framebuffer in
          color map mode, 0 otherwise.  (See linesm.)

     GDLSRG
          1 if antialiased lines are supported in RGB mode in all framebuffers
          that support RGB mode, 0 otherwise.  (See linesm.)

     GDLOGI
          1 if logical operations are supported in all framebuffers, 2 if only
          in the normal framebuffer, and 0 otherwise.  (See logico.)

     GDMULT
          1 if the multisample routines are functional, 0 if they are not.

     GDNBLI
          Maximum number of blinking color map entries on the selected screen.
          If the value is non-zero, it will be at least 20.  (See blink.)

     GDNMMA
          Number of smaller color maps available to the user in multimap mode.
          On some models, the highest-numbered color map is reserved for use
          by the system.  (See setmap.)

     GDNSCR
          Number of screens available on the system.  Unlike most of the
          others, this inquiry is independent of the currently selected
          screen.

     GDNURB
          Maximum order of any NURBS surface, NURBS curve, and NURBS trimming
          curve.

     GDNVPO
          Maximum number of vertices in a single polygon.  If there is no
          limit, then GDNOLI is returned.

     GDOVER
          1 if overlay and underlay planes are shared, 0 if both can be used
          simultaneously.

     GDPATS
          1 if 64x64 patterns are supported, 0 otherwise.  (See defpat.)

     GDPSCM
          1 if antialiased points are supported in the normal framebuffer in
          color map mode, 0 otherwise.  (See pntsmo.)

     GDPSRG
          1 if antialiased points are supported in RGB mode in all
          framebuffers that support RGB mode, 0 otherwise.  (See pntsmo.)

     GDPOMO
          1 if polymo is functional, 0 if it is not.

     GDPOSM
          1 if antialiased polygons are supported in RGB mode in all
          framebuffers that support RGB mode, 0 otherwise.  (See polysm.)

     GDPUPO
          1 if the popup bitplanes can be allocated as color map bitplanes in
          the overlay or underlay framebuffers, 0 if they cannot.

     GDRSRC
          1 if readso sources SRCAUT, SRCFRO, and SRCBAC are functional, 0 if
          they are not.

     GDRSZB
          1 if readso(SRCZBU) is functional, 0 if it is not.

     GDSCRB
          1 if scrbox is functional, 0 if it is not.

     GDSTYP
          Type of the currently selected screen.  Returns GDSTWM if there is
          window management on the screen or GDSTNW if there isn't.  There can
          be at most one window open on screens of the latter type.

     GDSTER
          1 if setmon(STRREC) is functional, 0 if it is not.

     GDSTIW
          1 if per-window stereo is functional, 0 if it is not.  (See stereo.)

     GDSBLI
     GDSBPN
     GDSBPO
          1 if subpixel positioned lines, points, and polygons (respectively)
          are supported in all framebuffers, 0 otherwise.  (See subpix.)

     GDTEXT
          1 if the textport routines are functional, 0 if they are not.
          Unlike most of the others, this inquiry is independent of the
          currently selected screen.  (See textpo.)

     GDTXTR
          1 if texture mapping routines are functional, 0 if they are not.
          (See texdf2.)

     GDTX3D
          1 if 3D texture mapping routines are functional, 0 if they are not.
          (See texdf3.)

     GDTXDE
          1 if TXDETA is functional, 0 if it is not.  (See texdef.)

     GDTXLU
          1 if texture lookup tables are functional, 0 if they are not.  (See
          tlutdef.)

     GDTXSH
          1 if TXSHAR is functional, 0 if it is not.  (See texdef.)

     GDTIME
          Frequency of graphics timer events.

     GDTROD
          Maximum order of a trimming curve.

     GDWSYS
          Type of window system running on the machine.  Returns GDWS4S if a
          windowing system is currently running or GDWSNO if there is no
          window system currently running.  Unlike most of the others, this
          inquiry is independent of the currently selected screen.

     GDZDGM

     GDZDPX
          1 if routines that render geometry and routines that render pixels
          (respectively) will do it into the z-buffer when zdraw is .TRUE., 0
          if they do not.

SEE ALSO
     gversi, scrnse

NOTES
     This routine is available only in immediate mode.

     To inquire about the screen on which the current window is displayed, use
     the following sequence:

               integer*4 svscrn, dummy
               ...
               savescrn = scrnse(getwsc)
               val1 = getgde(inquiry1)
               val2 = getgde(inquiry2)
               ...
               dummy = scrnse(svscrn)