XFillPolygon(display, d, gc, points, npoints, shape, mode)
	Display *display;
	Drawable d;
	GC gc;
	XPoint *points;
	int npoints;
	int shape;
	int mode;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• d - окно или графический образ для вывода графики;
• gc - используемый графический контекст;
• points - список точек, описывающих полигон;
• npoints - количество точек в списке points;
• shape - описание формы полигона (Complex, Convex или Nonconvex);
• mode - режим интерпретации координат (CoordModeOrigin или CoordModePrevious).

     Функция XFillPolygon рисует заполненную область, ограниченную ломаной линией, точки которой перечислены в списке points. Ломаная линия автоматически замыкается, если первая и последняя точка в списке не совпадают. При отрисовке заполненного полигона ни одна точка не отрисовывается повторно.

     Аргумент mode задает режим интерпретации координат. В режиме CoordModeOrigin координаты всегда считаются относительно нулевых координат объекта назначения. В режиме CoordModePrevious координаты точки в списке интерпретируются относительно координат предыдущей точки. Координаты первой точки списка в любом случае указываются относительно нулевых координат объекта назначения.

     Аргумент shape указывает на характер формы полигона:

• Complex - ломаная линия, образующая границу может пересекать себя. Последовательность точек с одинаковыми координатами за пересечение не воспринимается;

• Convex - прямая линия, соединяющая любые две точки внутри полигона не будет пересекать границу полигона. Другими словами, полигон имеет форму выпуклого многоугольника. Если заранее известно, что полигон имеет такую форму, то указание такого параметра значительно увеличит скорость вывода полигона. Если в аругменте указать такое значение, но при этом полигон на самом деле не будет иметь такой формы, результаты будут непредсказуемы;

• Nonconvex - полигон имеет произвольную форму, но ломаная линия, образующая границу полигона себя не пересекает. Отрисовка таких полигонов происходит как правило быстрее, чем полигонов с формой Complex, однако, если указать такую форму для полигона с пересекающейся границей, результаты будут непредсказуемы.

     Функция XFillPolygon использует следующие параметры графического контекста: function, plane_mask, fill_style, fill_rule, subwindow_mode, clip_x_origin, clip_y_origin и clip_mask. Также, в зависимости от режимов, установленных в графическом контексте, могут использоваться следующие параметры графического контекста: foreground, background, tile, stipple, tile- stipple- _x_origin, tile- stipple- _y_origin.

     Назначение перечисленных параметров приведено в описании структуры XGCValues.

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

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

Cм. также: XFillRectangle, XFillRectangles, XFillArc, XFillArcs.