Series 300 and 800 Only

NAME

XHPFileToWindow - Transfer an image stored in a file into a window. 

SYNOPSIS

XHPFileToWindow (display, w, modify_cmap, gc, src_x, src_y, dst_x, dst_y, width, height,
filename)
Display∗display;
Windoww;
intmodify_cmap;
GCgc;
intsrc_x, src_y;
intdst_x, dst_y;
unsigned intwidth, height;
char    ∗filename;

ARGUMENTS

display Specifies the connection to the X server. 

w Specifies the window ID. This is where the image will be placed. 

modify_cmap Specifies colormap modification. If zero, the window’s colormap is unchanged; if nonzero, the window’s colormap is updated from colormap data contained in the image file. 

gc Specifies the graphics context. 

src_x, src_y Specifies the x and y coordinates of the upper left corner of the rectangle to be transfered from the image file. 

dst_x, dst_y Specifies the x and y coordinates within the window where the upper left corner of the image will be drawn. 

width, height Specifies the width and height of the subimage. These arguments define the dimensions of the rectangle. 

filename Specifies the file name to use. The format of the file name is operating system specific. 

DESCRIPTION

The XHPFileToWindow function transfers an image saved in a file in the (ad hoc) standard xwd (X Window Dump) format into a window. 

The graphics context specified by the gc parameter is used to control image transfer details. Refer to the description of graphics context associated with XPutImage in the “Transferring Images Between Client and Server” section of the Programming With Xlib manual. 

If the gc parameter is zero, the default graphics context for the display’s default screen will be used. 

RETURN VALUE

The XHPFileToWindow function returns one of the following values defined in /usr/include/X11/XHPImageIO.h:

XHPIFSuccess Successful completion. 

XHPIFDrawableErr Couldn’t get drawable attributes or geometry. 

XHPIFFileErr Problem accessing file. 

XHPIFRequestErr Bad placement or size. 

XHPIFAllocErr Memory allocation failure. 

XHPIFHeaderErr File header version or size problem. 

FILES

none

ORIGIN

Hewlett-Packard Company

SEE ALSO

XHPFileToPixmap(3X)
XHPPixmapToFile(3X)
XHPQueryImageFile(3X)
XHPWindowToFile(3X)
XPutImage(3X)