VEraseOverlayRectangle


 
Name
  VEraseOverlayRectangle - erases a 1-bit overlay rectangle.
 
Synopsis
  VEraseOverlayRectangle(win, ovl, xloc, yloc, width, height)
  Window win;
  int ovl;
  int xloc, yloc;
  int width, height;
 
Description
  VEraseOverlayRectangle erases a 1-bit overlay rectangle in the image
 
Return Value
  0 - work successfully.
  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 erase the rectangle.
  xloc, yloc - specifies x and y coordinates of the upper left corner of the
        rectangle, relative to the origin of the specified window.
  width, height - specifies the width and height in pixels of the frame.
 
Side Effects
  Any other graphics in that overlay on that rectangle will also be erased.
 
Entry Conditions
  If ovl, xloc, yloc, width, or height is not valid, or VCreateColormap is
not called earlier, or the rectangle to be drawn is totally out of the
specified window boundary, VEraseOverlayRectangle prints an error message
to the standard error stream, produces a core dump file and exits from the
current process.
 
Related Functions
VDisplayOverlayRectangle, VEraseOverlay, VTurnOffOverlay.