VGetFreeColorcells - returns the available colorcells.
unsigned long **avail_colorcells; /*RETURN*/
long *num_avail_colorcells; /*RETURN*/
VGetFreeColorcells returns the available colorcells, after accounting
for reserved colors and overlays. VGetFreeColorcells also returns the
number of available colorcells. VGetFreeColorcells allocates the memory
space for array and returns a pointer to *avail_colorcells. This space
can be freed by the user by calling free().
0 - work successfully.
1 - memory allocation error.
avail_colorcells - returns the available colorcells.
num_avail_colorcells - returns the number of available colorcells.
If avail_colorcells or num_avail_colorcells is NULL, or VCreateColormap
is not called earlier, VGetFreeColorcells prints an error message to the
standard error stream, produces a core dump file and exits from the current