XCreateBitmapFromData(3X) XLIB FUNCTIONS XCreateBitmapFromData(3X)
NAME
XCreateBitmapFromData - manipulate bitmaps
SYNTAX
map XCreateBitmapFromData(display, d, data, width, height)
Display *display;
Drawable d;
char *data;
unsigned int width, height;
ARGUMENTS
display Specifies the connection to the X server.
d Specifies the drawable that indicates the screen.
data Specifies the data in bitmap format.
width
height
Specify the width and height.
DESCRIPTION
The XCreateBitmapFromData function allows you to include in your C program (using #include) a bitmap file that was written out by
XWriteBitmapFile (X version 11 format only) without reading in the bitmap file. The following example creates a gray bitmap:
Pixmap bitmap;
bitmap = XCreateBitmapFromData(display, window, gray_bits, gray_width,
gray_height);
If insufficient working storage was allocated, XCreateBitmapFromData returns None. It is your responsibility to free the bitmap using
XFreePixmap when finished.
XCreateBitmapFromData can generate a BadAlloc error.
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), XReadBitmapFileData(3X), XWriteBitmapFile(3X), XCreatePixmapFromBitmapData(3X)
X Version 11 Release 6 XCreateBitmapFromData(3X)