ClosePath

Vektorová grafika, Definícia ciest a kreslenie

Opis

Zatvára aktuálny sub-path pathu spusteného StartPath. Od aktuálneho bodu k začiatočnému bodu pathu sa vedie priamka, vďaka čomu je tvar jediným uzavretým útvarom, nie dvoma koncovými bodmi spojenými len spojom. Volanie ClosePath path nekreslí — na obrajsovanie a/alebo výplň potom zavolajte DrawPath alebo DrawPathEvenOdd.

Syntax

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Návratové hodnoty

0	Failed — no document is open or no path has been started.
1	Aktuálna podcesta sa zatvorila.

Poznámky

Zatvorenie cesty je dôležité vždy, keď sa tvar bude kresliť ťahom: otvorená cesta necháva viditeľnú medzeru medzi posledným a prvým bodom a spoj ťahu v tomto vrchole sa vykreslí ako rovný koniec namiesto riadneho spoja čiar. Pri vyplňovaných cestách zatváraciu čiaru implikuje pravidlo výplne, ale výslovné zatvorenie aj tak dáva čistejší výstup a vyžaduje sa pred spustením novej podcesty ďalším StartPath.

Príklad

// 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

Pozri tiež

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd