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

gversion Subroutine

Purpose

Returns graphics hardware and library version information.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

Int32 gversion(Char8 *v)

FORTRAN Syntax

INTEGER*4 GVERSI(v, length)
CHARACTER*(*) v
INTEGER*4 length

Description

The gversion subroutine fills the buffer, identified by the v parameter, with a null-terminated string that specifies the graphics hardware type and the version number of GL.

It is not necessary to open a GL window or to call the ginit subroutine before using the getdesc subroutine.

The gversion subroutine returns a value of -1 if GL is not supported on this particular hardware configuration.

Note: This subroutine cannot be used to add to a display list.
Attention: Calling the gversion subroutine before calling the winopen subroutine on the POWERgraphics GTO and the POWERstation 730, results in a core dump when the initial winopen subroutine call is made.

Return Value

In the following values table, m and n indicate the major and minor release numbers of the installed software libraries:

Installed Adapter String Returned
3-D Color Graphics Processor GL:CGP-m.n
Supergraphics Processor GL:GTO-m.n
POWER GTO adapter GL:GTO-m.n
POWER Gt4 adapter GL:GT4-m.n
POWER Gt4x adapter GL:GT4-m.n

Parameters

v Specifies a buffer into which you can copy a string. Reserve at least a 12-character buffer.
length Specifies the length of the string.

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.

Related Information

Creating a new window with the winopen subroutine.

Understanding the Hardware Used by GL and Clearing, Resetting, and Initializing GL in GL3.2 Version 4 for AIX: Programming Concepts.


[ Previous | Next | Contents | Glossary | Home | Search ]