VReadColorcomFile


 
Name
  VReadColorcomFile - loads the colormap from the COLOR.COM file.
 
Synopsis
  VReadColorcomFile()
 
Description
  VReadColorcomFile loads the colormap from the COLOR.COM file. VReadColorcomFile
reads the the COLOR.COM file which contains the 3DVIEWNIX colormap saved by
VWriteColorcomFile. VReadColorcomFile 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, VReadColorcomFile should be called
to update and install the colormap of process2 for process1. If the overlays
of process2 are different from process1, VReadColorcomFile 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, VReadColorcomFile 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, VWriteColorcomFile, VCreateColormap, VGetColorcellStatus.