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/setrgb32
       and loadrgb4/loadrgb32 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()/getrgb32() to query it or setrgb4cm/setrgb32cm
       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()