XReadBitmapFileData

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().

See also

XCreateBitmapFromData(), XCreatePixmap(), XCreatePixmapFromBitmapData(), XPutImage(), XWriteBitmapFile(), "Manipulating Bitmaps".
Christophe Tronche, ch@tronche.com