multimap(3G)

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

C SPECIFICATION
     void multimap()

PARAMETERS
     none

DESCRIPTION
     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
     cmode, drawmode, gconfig, getcmmode, getgdesc, getmap, onemap, setmap

NOTES
     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.