XReadBitmapFileData(3X) XLIB FUNCTIONS XReadBitmapFileData(3X)NAMEXReadBitmapFileData - 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 fin‐
ished 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 Win‐
dow or Pixmap.
BadMatch An InputOnly window is used as a Drawable.
SEE ALSOXReadBitmapFile(3X), XWriteBitmapFile(3X), XCreatePixmapFromBitmap‐
Data(3X), XCreateBitmapFromData(3X)X Version 11 Release 6 XReadBitmapFileData(3X)