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

АРГУМЕНТЫ

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

    Функция XDrawLines рисует npoints-1 прямых линий между каждой парой следующих друг за другом точек в списке точек (point[i] - [point[i+1]). Отрисовка происходит в том порядке, в котором перечислены точки в списке. Также, XDrawLines производит состыковку линий в соответствии с заданным параметром графического контекста join_style. Корректное объединение линий происходит во всех промежуточных точках, а также, если совпадают первая и последняя точки списка. Вызов функции XDrawLines с точки зрения производительности гораздо более эффективен, чем отрисовка точек по-отдельности через функцию XDrawLine.

     В каждой отдельной линии никакая точка не отрисовывается повторно. Если происходит отрисовка линий, которым задана нулевая ширина, и при этом какие-то линии пересекаются, то точки, расположенные в местах пересечения отрисовываются повторно. Если в списке есть пересекающиеся линии и отрисовка идет линиями ненулевой ширины, то в местах пересечения точки отрисовываются только один раз.

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

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

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

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

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

Cм. также: XDrawPoint, XDrawPoints, XDrawArc, XDrawArcs, XDrawLine, XDrawRectangle, XDrawRectangles, XDrawSegments.