VTurnOffOverlay

 
Name
  VTurnOffOverlay - turns the specified overlay off.
 
Synopsis
  VTurnOffOverlay(ovl)
  int ovl;
 
Description
  VTurnOffOverlay turns the specified overlay off by resetting colormap
entries. VTurnOffOverlay also updates the 3DVIEWNIX reserved colors for the
specified overlay. If the specified overlay is 0, VTurnOffOverlay turns all
overlays off.
 
Return Value
  0 - work successfully.
  1 - memory allocation error.
  225 - no overlay created.
 
Parameters
  ovl - specifies the overlay number to be turned on.
 
Side Effects
  None.
 
Entry Conditions
  If ovl is not valid, or VCreateColormap is not called earlier,
VTurnOffOverlay prints an error message to the standard error stream,
produces a core dump file and exits from the current process.
 
Related Functions