VFillImageRectangle
Name
VFillImageRectangle - fills a rectangle in the image window.
Synopsis
VFillImageRectangle(win, xloc, yloc, width, height, value)
Window win;
int xloc, yloc;
int width, height;
unsigned long value;
Description
VFillImageRectangle fills a specified rectangle in the image window or one
of its subwindows with the specified pixel value. If the image is partially
out of the window boundary, VFillImageRectangle clips the image, displays the
clipped image in the window, and returns an error code.
Return Value
0 - work successfully.
6 - invalid window ID.
240 - image displayed is out of window boundary.
Parameters
win - the image window ID or one of its subwindows' ID.
xloc, yloc - specifies x and y coordinates of the upper left corner of the
rectangle, relative to the origin of the specified window.
value - specifies the pixel value to fill the image window.
Side Effects
None.
Entry Conditions
If the value xloc, yloc, width, height, or value is not valid, or
VCreateColormap is not called earlier, or the rectangle to be filled is
totally out of the specified window boundary, VFillImageRectangle prints an
error message to the standard error stream, produces a core dump file and
exits from the current process.
Related Functions
VFillOverlayRectangle,
VClearWindow,
VGetFreeColorcells.