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