XPutImage(display, d, gc, image, src_x, src_y, dest_x, dest_y, width, height)
	Display *display;
	Drawable d;
	GC gc;
	XImage *image;
	int src_x, src_y;
	int dest_x, dest_y;
	unsigned int width, height;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• d - идентификатор объекта вывода графики;
• gc - используемый контекст вывода графики;
• image - изображение с исходными данными;
• src_x, src_y - координаты левого верхнего угла прямоугольной области в исходном изображении;
• dest_x, dest_y - координаты для левого верхнего угла прямоугольной области в объекте d;
• width, height - размеры выводимой прямоугольной области.

     Эта функция выводит прямоугольную область исходного изображения image с координатами левого верхнего угла (src_x, src_y) и размерами width и height в область такого же размера объекта вывода графики d, но с координатами левого верхнего угла (dest_x, dest_y).

     Если используется изображение формата XYBitmap, что соответствует монохромному изображению, то точки, установленные в единицы выводятся цветом foreground графического контекста gc, а точки с нулевыми значениями выводятся цветом background.

     Для форматов изображения XYPixmap и ZPixmap глубина цветности изображения должна совпадать с глубиной цветности объекта вывода графики d, иначе появится ошибка BadMatch.

     Если некоторые параметры изображения (к примеру byte_order и bitmap_unit) не соответсвуют требуемым для X-сервера, то XPutImage сама производит необходимые преобразования.

     Функция XPutImage использует следующие параметры графического контекста при выводе изображения: function, plane_mask, subwindow_mode, clip_x_origin, clip_y_origin и clip_mask. Также, в зависимости от формата исходного изображения могут быть использованы параметры foreground и background. Назначение этих параметров рассмотрено в описании структуры XGCValues.

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

• BadDrawable - ошибка указания объекта вывода графики;
• BadGC - ошибка указания контекста вывода графики;
• BadMatch - несоотвествие одного или нескольких аргуметов допустимым значениям;
• BadValue - какое-то из числовых значений выходит за допустимый диапазон.

См. также: XCreateImage, XInitImagePixel, XGetPixel, XPutPixel, XSubImage, XAddPixel, XDestroyImage, XGetImage, XGetSubImage.