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.