ClosePath
Vektorgrafik, Bandefinition och ritning
Beskrivning
Stänger aktuellt sub-path hos den path som StartPath påbörjade. En rak linje ritas från den aktuella punkten tillbaka till pathens startpunkt, vilket säkerställer att figuren är en enda sluten form i stället för två ändpunkter förbundna bara av en kantanslutning. Att anropa ClosePath målar inte pathen — anropa DrawPath eller DrawPathEvenOdd därefter för att stryka och/eller fylla den
Syntax
Delphi
Function TPDFlib.ClosePath: Integer;
ActiveX
Function PDFlib::ClosePath() As Long
DLL
int DLClosePath(int InstanceID);
Returvärden
| 0 | Misslyckades — inget dokument är öppet eller ingen path har påbörjats |
|---|---|
| 1 | Aktuella sub-path har stängts |
Anmärkningar
Att stänga pathen är viktigt varje gång formen ska dras med kantlinje: en öppen path lämnar ett synligt gap mellan sista punkten och första punkten, och kantanslutningen vid det hörnet renderas som en butt-cap i stället för en riktig linjeanslutning. För fyllda pather är stängningslinjen underförstådd av fyllnadsregeln, men att stänga explicit ger ändå renare utdata och krävs innan en ny sub-path startas med en ny StartPath
Exempel
// 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 onlySe även
StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd