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

getplanes Subroutine

Purpose

Returns the number of available bitplanes.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

Int32 getplanes( )

FORTRAN Syntax

INTEGER*4 GETPLA

Description

The getplanes subroutine returns the number of active bitplanes that are currently being used for drawing. The number returned depends on how the frame buffer has been configured. In particular, the returned value depends on the most recent setting of the drawmode subroutine, whether the system is in single or double buffer mode, whether it is in color map or RGB mode, and finally, on the capabilities of the installed adapter.

Note: This subroutine cannot be used to add to a display list.

Return Value

The number of bitplanes available under the current drawmode.

Example

The example C language program scrn_rotate.c uses the getplanes subroutine to get the number of bitplanes available.

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

Setting color map mode as the current mode with the cmode subroutine.

Setting the display mode to double buffer mode with the doublebuffer subroutine.

Choosing a set of bitplanes for drawing with the drawmode subroutine.

Organizing the color map as 16 small maps with the multimap subroutine.

Organizing the color map as one large map with the onemap subroutine.

Setting a display mode that bypasses the color map with the RGBmode subroutine.

Setting the display mode to single buffer mode with the singlebuffer subroutine.

Configuring the Frame Buffer, Writemasks and Logical Operations, and Querying the System.


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