VLoadColormap


 
Name
  VLoadColormap - loads the colormap from the COLOR.COM file.
 
Synopsis
  VLoadColormap()
 
Description
  VLoadColormap loads the colormap from the COLOR.COM file. VLoadColormap
reads the the COLOR.COM file which contains the 3DVIEWNIX colormap saved by
VSaveColormap. VLoadColormap gets the overlays and the reserved colors from
the COLOR.COM file and updates the current colormap. If process1 calls
process2, then after process2 is exited, VLoadColormap should be called
to update and install the colormap of process2 for process1. If the overlays
of process2 are different from process1, VLoadColormap updates both the
overlays and the colormap, else just the colormap of process1.
 
Return Value
  0 - work successfully.
  1 - memory allocation error.
  2 - read error.
  3 - write error.
  4 - file open error.
 
Parameters
  None.
 
Side Effects
  None.
 
Entry Conditions
  If VCreateColormap is not called earlier, VLoadColormap prints an error
meassage to the standard error stream, produces a core dump file and
exits from the current process.
 
Related Functions
VGetReservedColors, VGetFreeColorcells, VGetColormap, VPutColormap, VSaveColormap, VCreateColormap, VGetColorcellStatus.