[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

glcompat Subroutine

Purpose

Controls backwards compatibility modes.

C Syntax

void glcompat (Int32 mode, Int32 value)

FORTRAN Syntax

SUBROUTINE GLCOMPAT (mode, value)
INTEGER*4 mode, value

Parameters

mode Token representing the compatibility mode to be changed.
value The value that the compatibility mode should have.

Functional Description

This subroutine governs various compatibility modes for the GL subsystem. Applications should use this subroutine judiciously to minimize porting headaches while maximizing useful function. The following glcompat modes can also be set with environment variables with the same corresponding names.

Mode GLC_CREATE_OVERLAY
Default FALSE
Function On the POWERgraphics GXT1000 adapter, this mode controls whether the winX subroutine will automatically create an overlay window. When this mode is set to TRUE, and the XID passed to winX is not an overlay window, then the winX routine will create an overlay window and make it a child of the indicted X window. Although the overlay window will be a distinct X11 window, internally, it will be used to emulate overlay plane functions. It can be accessed via the drawmode subroutine and can be drawn into with the usual GL functions.
When this mode is set to FALSE, the winX routine will simply accept the indicated X Window, and create and attach a GL context to that window. The drawmode subroutine should not be used with windows created by winX when this mode is FALSE.
This mode has no effect on graphics adapters other than the POWERgraphics GXT1000.
Mode GLC_ISSUE_OVERDRAW
Default FALSE
Function On the POWERgraphics GXT1000 adapter, this mode controls how exposure events for the overlay planes are handled. When the mode is TRUE, the REDRAW_OVERLAY event will be issued whenever the overlay planes are uncovered and need redrawing. The REDRAW event will not be issued if the main frame buffer window has not been damaged.
When the mode is FALSE, damage to the overlay planes will be reported with the REDRAW event. Note that if the main frame buffer has also been damaged, it may happen that two REDRAW events are reported for the window.
Set this mode to FALSE if your application does not handle REDRAW_OVERLAY events, but needs to find out when the overlays need to be redrawn.
This mode has no effect on graphics adapters other than the POWERgraphics GXT1000.
Mode GLC_FB_FULLSCREEN
Default FALSE
Function On the POWERgraphics GXT1000 adapter, this mode enables the fullscrn routine to affect the main frame buffer. By default, the fullscrn subroutine applies only to the overlay bit-planes.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h Contains FORTRAN constant and variable type definitions for GL.

[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]