XWriteBitmapFile(3X) XLIB FUNCTIONS XWriteBitmapFile(3X)NAMEXWriteBitmapFile - writes a bitmap
SYNTAX
int XWriteBitmapFile(display, filename, bitmap, width, height, x_hot,
y_hot)
Display *display;
char *filename;
Pixmap bitmap;
unsigned int width, height;
int x_hot, y_hot;
ARGUMENTS
display Specifies the connection to the X server.
filename Specifies the file name to use. The format of the file name
is operating-system dependent.
bitmap Specifies the bitmap.
width
height Specify the height.
x_hot
y_hot Specify where to place the hotspot coordinates (or -1,-1 if
none are present) in the file.
DESCRIPTION
The XWriteBitmapFile function writes a bitmap out to a file in the X
Version 11 format. The name used in the output file is derived from
the file name by deleting the directory prefix. The file is written in
the encoding of the current locale. If the file cannot be opened for
writing, it returns BitmapOpenFailed. If insufficient memory is allo‐
cated, XWriteBitmapFile returns BitmapNoMemory; otherwise, on no error,
it returns BitmapSuccess. If x_hot and y_hot are not -1, -1,
XWriteBitmapFile writes them out as the hotspot coordinates for the
bitmap.
XWriteBitmapFile can generate BadDrawable and BadMatch errors.
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), XReadBitmapFileData(3X), XCreatePixmapFromBitmap‐
Data(3X), XCreateBitmapFromData(3X)X Version 11 Release 6 XWriteBitmapFile(3X)