VGetFreeColorcells
Name
VGetFreeColorcells - returns the available colorcells.
Synopsis
VGetFreeColorcells(avail_colorcells, num_avail_colorcells)
unsigned long **avail_colorcells; /*RETURN*/
long *num_avail_colorcells; /*RETURN*/
Description
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().
Return Value
0 - work successfully.
1 - memory allocation error.
Parameters
avail_colorcells - returns the available colorcells.
num_avail_colorcells - returns the number of available colorcells.
Side Effects
None.
Entry Conditions
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
process.
Related Functions
VCreateColormap,
VGetReservedColors,
VGetColormap,
VPutColormap,
VSaveColormap,
VLoadColormap,
VGetColorcellStatus.