XCopyPlane(display, src, dest, gc, src_x, src_y, width, height, dest_x, dest_y,plane)
	Display *display;
	Drawable src, dest;
	GC gc;
	int src_x, src_y;
	unsigned int width, height;
	int dest_x, dest_y;
	unsigned long plane;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• src, dest - исходный объект вывода и объект назначения;
• gc - маска, указывающая какие параметры контекста необходимо копировать;
• src_x, src_y - координаты левого верхнего угла области копирования в исходном объекте;
• width, height - размеры области копирования по горизонтали и вертикали;
• dst_x, dst_y - координаты для левого верхнего угла области копирования в объекте назначения.
• plane - указатель битовой плоскости.

     Функция XCopyPlane производит вывод прямоугольной области в объекте назначения dest используя данные одной битовой плоскости прямоугольной области такого же размера исходного объекта src. Битовая плоскость указывается установкой в единицу разряда, который соответствует требуемой битовой плоскости.

     Действие по копированию происходит следующим образом:

1. создаётся графический образ, глубина цветности которого равна глубине цветности dest;
2. образ заполняется цветом foreground графического контекста в тех точках, в которых значение разряда исходной битовой плоскости равно единице и цветом background, где разряды битовой плоскости равны нулю.
3. выполняется операция XCopyArea из сформированного графического образа в dest.

     Можно рассматривать эту операцию как использование данных битовой плоскости src как параметр графического контекста stipple при использовании стиля заполнения FillOpaqueStippled для заполнения прямоугольной области в dest.

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

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

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

Cм. также: XClearWindow, XClearArea, XCopyArea.