Cursor XCreatePixmapCursor(display, source, mask, foreground_color,
				background_color, x, y)
	Display *display;
	Pixmap source;
	Pixmap mask;
	XColor *foreground_color;
	XColor *background_color;
	unsigned int x, y;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• d - окно или графический образ для определения экрана сервера;
• width, height - размеры графического образа;
• depth - глубина цветности графического образа.

     Функция XCreatePixmapCursor создаёт графический курсор и возвращает его идентификатор. Образ курсора формируется из графического образа source, который определяет содержимое курсора и графического образа mask, который определяет, какие из точек source будут отображаться, а какие будут игнорироваться.

     Поскольку допускается использование только двухцветных графических курсоров, то глубина цветности для source и mask должна быть равна единице. Принадлежность этих графических образов одному корневому окну не обязательна. Точки в src, установленные в единицу будут отображаться цветом foreground. Нулевые точки будут отображаться цветом background. Те точки src, которые соотвествуют единичным точкам mask будут отображаться на экране, а точки, соответствующие нулевым точкам будут игнорироваться.

     В структурах XColor при задании цветов используются только значения RGB. При задании цветов, отличных от белого и чёрного приложению необходимо принимать во внимание, не работает-ли графический адаптер в чёрно-белом режиме.

     Размеры графических образов src и mask должны быть одинаковыми. Точка привязки курсора должна находиться в пределах размера графического курсора. Точка привязки показывает какая точка в графическом образе курсора будет соответствовать позиции курсора.

     Если после создания курсора пытаться внести изменения в графические образы src или dst, то результат может появиться, а может не появиться, поэтому изменять графические образы с целью изменить курсор не рекомендуется. Если дальнейшее использование графических образов src и dst не планируется, то их можно освободить сразу после создания курсора.

     После завершения работы с курсором, его можно удалить при помощи функции XFreeCursor.

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

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

Cм. также: XRecolorCursor, XFreeCursor, XQueryBestCursor, XCreateFontCursor, XCreateGlyphCursor, XDefineCursor, XUndefineCursor.