VSaveColormap



Name
  VSaveColormap - saves the 3DVIEWNIX colormap to COLOR.COM file.
 
Synopsis
  VSaveColormap()
 
Description
  VSaveColormap saves the 3DVIEWNIX colormap to COLOR.COM file. VSaveColormap
writes the number of overlays, the number of colormap entries, the contents
of the colormap, and the colors and colorcells reserved by 3DVIEWNIX to
COLOR.COM file in ASCII format. VSaveColormap should be called everytime the
number of overlays is changed to update the new entries in the colormap.
To load the entries of colormap stored in COLOR.COM file, VLoadColormap
should be called.
 
Return Value
  0 - work successfully.
  3 - write error.
 
Side Effects
  None.
 
Entry Conditions
  If VCreateColormap is not called earlier, VSaveColormap prints an error
message to the standard error stream, produces a core dump file and exits from
the current process.
 
Related Functions
VGetReservedColormap, VGetFreeColorcells, VGetColormap, VPutColormap, VLoadColormap, VCreateColormap, VGetColorcellStatus.