int XReadBitmapFile(display, d, filename, width_return, height_return,
            			 bitmap_return, x_hot_return, y_hot_return)
	Display *display;
	Drawable d;
	char *filename;
	unsigned int *width_return, *height_return;
	Pixmap *bitmap_return;
	int *x_hot_return, *y_hot_return;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• d - идентификатор объекта вывода графики для определения экрана;
• filename - имя файла с изображением;
• width_return, height_return - возвращаемые значения размеров изображения;
• bitmap_return - идентификатор графического созданного образа;
• x_hot_return, y_hot_return - возвращаемые координаты точки привязки изображения.

     Функция XReadBitmapFile является комбинацией функций XReadBitmapFile и XCreateBitmapFromData. Она читает в память данные графического файла в формате XBM, затем по полученным данным создается и заполняется графический образ, идентификатор которого возвращается через аргумент bitmap_return. При заполнении созданного графического образа нулевые точки окрашиваются в белый цвет, а единичные точки окрашиваются в чёрный. Кроме того возвращаются такие параметры изображения как размеры изображения (width_return и height_return) и точки привязки изображения (x_hot_return и y_hot_return). Привязка изображения является особенностью формата XBM. Поскольку файлы в таком формате удобно использовать для создания собственных графических курсоров, то сразу в файле можно указать, какая точка изображения будет соответствовать позиции курсора (см. XCreatePixmapCursor).

     Если функции указанный файл окажется недоступен, функция вернёт значение BitmapOpenFailed. Если файл окажется с ошибками или будет другого формата, то функция вернёт значение BitmapFileInvalid. Если для загрузки данных будет недостаточно памяти, то будет получено значение BitmapNoMemory. Если чтение файла пройдёт успешно, то на выходе будет значение BitmapSuccess.

     Формат файла XBM и представление данных в этом файле рассматриваются в описании функции XReadBitmapFile.

     После того, как графический образ станет ненужным, его можно удалить используя функцию XFreePixmap.

     Функция XReadBitmapFile может генерировать следующие ошибки:

• BadAlloc - X-сервер не может выделить запрошенный ресурс или память;
• BadDrawable - ошибка указания окна или графического образа.

Cм. также: XCreatePixmapFromBitmapData, XCreateBitmapFromData, XReadBitmapFileData, XWriteBitmapFile, XFreePixmap, XCopyArea.