VPutImage
Name
VPutImage - puts an image in the specified window.
Synopsis
VPutImage(win, ximage, img_xloc, img_yloc, win_xloc, win_yloc, width,
height)
Window win;
XImage *ximage;
int img_xloc, img_yloc;
int win_xloc, win_yloc;
int width, height;
Description
VPutImage puts an image in the specified window. If there is a prepared
image generated from VPrepareGrayImage or VPrepareColorImage, then
VPutImage displays the image. VPutImage does not scale the image nor does
it compute the overlays. If the image is to be drawn on the image window,
and the dialog window is in front of the lower part of the image window,
then VPutImage draws the lower part of the image to a pixmap. If the pixmap is
NULL, VPutImage returns an error code.
Return Value
0 - work successfully.
6 - invalid window ID.
Parameters
win - specifies the ID of the window.
img_xloc, img_yloc - specifies x and y coordinates of the upper left corner
of the rectangle, relative to the origin of the image.
win_xloc, win_yloc - specifies x and y coordinates of the upper left corner
of the rectangle, relative to the origin of the window.
width, height - specifies the width and height in pixels of the image.
ximage - specifies the XImage structure.
Side Effects
None.
Entry Conditions
The appropriate colormap for the image should be installed first. If
win_xloc, win_yloc, img_xloc, img_yloc, width, or height is not valid, or
VCreateColormap is not called earlier, or the image to be displayed is totally
out of the specified window boundary, VPutImage prints an error message to
the standard error stream, produces a core dump file and exits from the
current process.
Related Functions
VGetImage,
VPrepareGrayImage,
VPrepareColorImage,
VDisplayGrayImage,
VDisplayColorImage,
VTurnOnTruecolor,
VRestoreDefaultColormap.