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

setmap Subroutine


Selects one of 16 small color maps in multimap mode.


Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void setmap(Int16 mapnum)


INTEGER*4 mapnum
Note: For FORTRAN users, this subroutine accepts long integer parameters (INTEGER*4) when invoked from a FORTRAN program, although it accepts short integers when invoked from a C program. The C and FORTRAN syntax shown here reflect this difference.


The setmap subroutine selects one of the 16 small independent maps to be the current color map. Whenever the system is in color map mode, the contents of the frame buffer is interpreted throught a color map to arrive at the color displayed on the screen. When the system is in multimap mode, there are 16 small independent color maps; this subroutine chooses which of these is to be active. Only the least significant bits in the frame buffer are used to look up entries in the current color map.

The 16 small color maps are numbered 0 to 15.

This subroutine is valid only in multimap mode, and is ignored in onemap mode. It will not function in RGB mode.

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


mapnum Number of the color map selected, 0 to 15.

Implementation Specifics

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

The POWER GXT1000 adapter does not support the setmap subroutine.


/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

Returning the number of the current color map with the getmap subroutine.

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

Working in Color Map and RGB Modes.

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