ClosePath

Векторная графика, определение и рисование контуров

Описание

Замыкает текущий подпуть контура, начатого StartPath. От текущей точки к начальной точке контура проводится прямая линия, благодаря чему фигура становится единым замкнутым контуром, а не двумя конечными точками, соединёнными только стыком линий. Вызов ClosePath контур не отрисовывает — для обводки и/или заливки затем вызовите DrawPath или DrawPathEvenOdd.

Синтаксис

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Возвращаемые значения

0	Failed — no document is open or no path has been started.
1	Текущий подпуть замкнут

Примечания

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

Пример

// Draw a closed triangle, stroked
PDF.SetStrokeColor(0, 0, 0);
PDF.SetLineWidth(1);
PDF.StartPath(100, 100);
PDF.AddLineToPath(200, 100);
PDF.AddLineToPath(150, 180);
PDF.ClosePath;          // line back to (100, 100)
PDF.DrawPath(0);        // 0 = outline only

См. также

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd