multimap(3G)							  multimap(3G)

NAME    [Toc]    [Back]

     multimap -	organizes the color map	as a number of smaller maps

C SPECIFICATION    [Toc]    [Back]

     void multimap()

PARAMETERS    [Toc]    [Back]

     none

DESCRIPTION    [Toc]    [Back]

     multimap organizes	the color map of the currently active framebuffer as a
     number of smaller maps.  Because only the normal framebuffer supports
     multiple color maps, multimap should be called only while drawmode	is
     NORMALDRAW.

     There are getgdesc(GD_NMMAPS) maps, each of which will have up to 256
     entries, depending	on the number of bitplanes available.  Call getplanes
     after setting the drawing mode to the desired framebuffer to determine
     the color map size.  getgdesc can also be called at any time to determine
     the size of the color map of any framebuffer.

     multimap does not take effect until gconfig is called.  When called,
     gconfig executes multimap requests	pending	for all	drawing	modes,
     regardless	of the current drawing mode.

     A framebuffer's color map is used to display pixels only if the
     framebuffer is in color map mode.

SEE ALSO    [Toc]    [Back]

     cmode, drawmode, gconfig, getcmmode, getgdesc, getmap, onemap, setmap

NOTES    [Toc]    [Back]

     This routine is available only in immediate mode.

     multimap is not supported on Iris Entry, Indy, XL,	XS, XS24, XZ, Elan,
     Extreme, and IRIS-4D RealityEngine	systems.


									PPPPaaaaggggeeee 1111