onemap(3G)

NAME
     onemap - organizes the color map as one large map

C SPECIFICATION
     void onemap()

PARAMETERS
     none

DESCRIPTION
     onemap organizes the color map of the currently active framebuffer as a
     single map.  Because single map mode is the default value for all GL
     framebuffers, it can be called in any of the framebuffer drawmodes
     (NORMALDRAW, PUPDRAW, OVERDRAW, and UNDERDRAW).  To return the normal
     framebuffer to single map mode, however, you must call onemap while in
     drawmode NORMALDRAW.

     The single color map allocated to a framebuffer in onemap mode has as
     many entries as are supported by the bitplanes in that framebuffer.  The
     normal framebuffer has up to 12 bitplanes, and therefore up to 4096 color
     map entries.  Call getplanes after setting draw 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.

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

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

SEE ALSO
     cmode, drawmode, gconfig, getcmmode, getmap, multimap, setmap

NOTES
     This routine is available only in immediate mode.

     On Iris Entry, Indy, XL, XS, XS24, XZ, Elan, Extreme, and IRIS-4D
     RealityEngine systems multimap is not supported so onemap is always in
     effect for color map mode.