hpux man page for xreadbitmapfiledata

XReadBitmapFileData(3X) 					  XLIB FUNCTIONS					   XReadBitmapFileData(3X)

NAME
       XReadBitmapFileData - reads in a file containing a bitmap

SYNTAX
       int XReadBitmapFileData(filename, width_return, height_return, data_return, x_hot_return, y_hot_return)
	     char *filename;
	     unsigned int *width_return, *height_return;
	     unsigned char *data_return;
	     int *x_hot_return, *y_hot_return;

ARGUMENTS
       filename  Specifies the file name to use.  The format of the file name is operating-system dependent.

       width_return
       height_return
		 Return the width and height values of the read in bitmap file.

       data_return
		 Returns the bitmap data.

       x_hot_return
       y_hot_return
		 Return the hotspot coordinates.

DESCRIPTION
       The XReadBitmapFileData function reads in a file containing a bitmap, in the same manner as XReadBitmapFile, but returns the data directly
       rather than creating a pixmap in the server.  The bitmap data is returned in data_return; the client must free this storage when finished
       with it by calling XFree.  The status and other return values are the same as for XReadBitmapFile.

DIAGNOSTICS
       BadAlloc  The server failed to allocate the requested resource or server memory.

       BadDrawable
		 A value for a Drawable argument does not name a defined Window or Pixmap.

       BadMatch  An InputOnly window is used as a Drawable.

SEE ALSO
       XReadBitmapFile(3X), XWriteBitmapFile(3X), XCreatePixmapFromBitmapData(3X), XCreateBitmapFromData(3X)

X Version 11							     Release 6						   XReadBitmapFileData(3X)