VDisplayOverlayPoints


 
Name
  VDisplayOverlayPoints - displays 1-bit overlay points.
 
Synopsis
  VDisplayOverlayPoints(win, ovl, points, npoints)
  Window win;
  int ovl;
  XPoint *points;
  int npoints;
 
Description
  VDisplayOverlayPoints displays 1-bit overlay points (pixels), in the image 
window or one of its subwindows. VTurnOnOverlay should be called earlier to 
turn on the overlays.
 
Return Value
  0 - work successfully.
  1 - memory allocation fault.
  6 - invalid window ID.
  225 - no overlay created.
  237 - the overlay does not turn on.
 
Parameters
  win - the image window ID or one of its subwindows' ID.
  ovl - specifies the overlay number to be used to display the points.
  points - specifies a pointer to an array of XPoint structures containing
        the positions of the points.
  npoints - specifies the number of points to be displayed.
 
Side Effects
  None.
 
Entry Conditions
  VTurnOnOverlay should be called first. If ovl or npoint is not valid, or 
points is NULL, or VCreateColormap is not called earlier, or the points to be 
displayed are totally out of the specified window boundary, 
VDisplayOverlayPoints prints an error message to the standard error stream, 
produces a core dump file and exits from the current process.
 
Related Functions
VEraseOverlayPoints, VTurnOnOverlay, VTurnOffOverlay.