VClearOverlayLine


 
Name
  VClearOverlayLine - erases a 1-bit overlay line.
 
Synopsis
  VClearOverlayLine(win, ovl, x1, y1, x2, y2)
  Window win;
  int ovl;
  int x1, y1, x2, y2;
 
Description
  VClearOverlayLine erases a 1-bit overlay line, in the image window or
one of its subwindows. 
 
Return Value
  0 - work successfully.
  1 - memory allocation error.
  6 - invalid window ID.
  225 - no overlay created.
  237 - the overlay is not on.
 
Parameters
  win - the image window ID or one of its subwindows' ID.
  ovl - specifies the overlay number to be used to ease the line.
  x1, y1 - specifies the first point of the line.
  x2, y2 - specifies the second point of the line.
 
Side Effects
  Any other graphics in that overlay on that line will also be erased.
 
Entry Conditions
  VTurnOnOverlay should be called first. If ovl, x1, x2, y1, or y2 is not 
valid, or VCreateColormap is not called earlier VClearOverlayLine prints an 
error message to the standard error stream, produces a core dump file and 
exits from the current process.
 
Related Functions
VDisplayOverlayLine, VClearOverlay, VTurnOffOverlay.