NAME
    GetColorMap -- allocate and initialize Colormap


SYNOPSIS
    cm = GetColorMap( entries )
          d0                   d0

    struct colormap *getcolormap( ulong);

FUNCTION
    Allocates, initializes and returns a pointer to a colormap
    data structure, later enabling calls to setrgb4
    and loadrgb4 to load colors for a view port. the colortable
    pointer in the colormap structure points to a hardware
    specific colormap data structure. You should not count on
    it being anything you can understand. Use getrgb4() to
    query it or setrgb4cm to set it directly.

INPUTS
    entries - number of entries for this colormap

RESULT
    The pointer value returned by this routine, if nonzero,
    may be stored into the ViewPort.ColorMap pointer.
    If a value of 0 is returned, the system was unable
    to allocate enough memory space for the required
    data structures.

BUGS

SEE ALSO
    setrgb4() freecolormap()