VGetColorcellStatus


 
Name
  VGetColorcellStatus - gets the status of a colorcell.
 
Synospsis
  VGetColorcellStatus(cell, status)
  unsigned long cell;
  int *status;                          /*RETURN*/
 
Description
  VGetColorcellStatus gets the status of a specified colorcell. The status 
can be read only (0); read/write - grayscale/pseudocolor (1); read/write -
overlay (2); reserved colors (3). Please note that VGetColorcellStatus does
not return the status of individual components when the visual class is 
DirectColor.
 
Return Value
  0 - work successfully.
 
Parameters
  cell - the specified colorcell.
  status - returns the status of the desired colorcell. The status can be :
        0 - read only; 1 - gray / pseudo; 2 - overlay;
        3 - 3DVIEWNIX reserved colorcell.
 
Side Effects
  None.
 
Entry Conditions
  If cell value is invalid, status is NULL, or VCreateColormap is not called
earlier, VGetColorcellStatus prints an error mesage to the standard error
stream, produces a core dump file and exits from the current process.
 
Related Functions
VGetReservedColors, VGetFreeColorcells, VLoadColormap, VPutColormap, VSaveColormap, VCreateColormap, VGetColormap.