Series 300 and 800 Only

NAME

XHPFileToPixmap - Transfer an image stored in a file into a pixmap. 

SYNOPSIS

XHPFileToPixmap (display, pixmap, cmap, gc, src_x, src_y, dst_x, dst_y, width, height, filename)
Display ∗display;
Pixmappixmap;
Colormapcmap;
GCgc;
intsrc_x, src_y;
intdst_x, dst_y;
unsigned intwidth, height;
char    ∗filename;

ARGUMENTS

display Specifies the connection to the X server. 

pixmap Specifies the pixmap ID. This is where the image will be placed. 

cmap Specifies colormap ID. If nonzero, the 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 XHPFileToPixmap function is similar to XHPFileToWindow but has a cmap parameter to directly specify the colormap to be modified by the colormap stored in the image file. If cmap is zero, the colormap is not modified. 

RETURN VALUE

The XHPFileToPixmap 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

XHPFileToWindow(3X), XHPPixmapToFile(3X), XHPQueryImageFile(3X), XHPWindowToFile(3X)