ClosePath

Vektorgrafik, Pfaddefinition und Zeichnen

Beschreibung

Schließt den aktuellen Unterpfad des mit StartPath begonnenen Pfads. Vom aktuellen Punkt wird eine gerade Linie zurück zum Anfangspunkt des Pfads gezeichnet, sodass die Figur eine einzige geschlossene Form bildet und nicht aus zwei Endpunkten besteht, die nur durch eine Linienverbindung verbunden sind. Der Aufruf von ClosePath malt den Pfad nicht — rufen Sie anschließend DrawPath oder DrawPathEvenOdd auf, um ihn zu konturieren und/oder zu füllen.

Syntax

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

Rückgabewerte

Anmerkungen

Das Schließen des Pfads ist immer wichtig, wenn die Form gestrichen wird: Ein offener Pfad lässt zwischen dem letzten und ersten Punkt eine sichtbare Lücke, und die Strichverbindung an diesem Scheitelpunkt wird als stumpfe Kappe statt als korrekte Linienverbindung gerendert. Bei gefüllten Pfaden ergibt sich die Abschlusslinie aus der Füllregel, doch ein ausdrückliches Schließen erzeugt weiterhin eine sauberere Ausgabe und ist vor dem Beginn eines neuen Teilpfads mit einem weiteren StartPath erforderlich.

Beispiel

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

Siehe auch

StartPath, AddLineToPath, AddCurveToPath, DrawPath, DrawPathEvenOdd