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

0Misslyckades — inget dokument är öppet eller ingen path har påbörjats
1Aktuella 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 only

Se även

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd