DrawPath

Vektorgrafik, Pfaddefinition und Zeichnen

Beschreibung

Zeichnet den aktuellen Pfad — zusammengesetzt mit StartPath, AddLineToPath, AddCurveToPath, AddArcToPath und ClosePath — mit der Füllregel Winding ungleich null. Nach dem Zeichnen wird der Pfadzustand zurückgesetzt, sodass das nächste StartPath eine neue Form beginnt.

Syntax

Delphi

Function TPDFlib.DrawPath(PathOptions: Integer): Integer;

ActiveX

Function PDFlib::DrawPath(PathOptions As Long) As Long

DLL

int DLDrawPath(int InstanceID, int PathOptions);

Parameter

PathOptions	Zeichenmodus: 0 — Nur Kontur mit den aktuellen Linieneinstellungen. 1 — Nur Füllung mit der aktuellen Füllfarbe und der Nichtnull-Windungsregel. 2 — Füllung und Kontur

Rückgabewerte

0	Fehlgeschlagen — PathOptions liegt außerhalb des Bereichs, es ist kein Dokument geöffnet oder es wurde kein Pfad begonnen.
1	Der Pfad wurde erfolgreich gezeichnet

Anmerkungen

Legen Sie Strich- und Füllfarben sowie Linienattribute (SetLineWidth, SetLineCap, SetLineDash) vor dem Aufruf von DrawPath fest. Der aktuelle Grafikzustand wird am Aufrufort erfasst.

Bei überlappenden oder selbstschneidenden Pfaden behandelt die Nichtnull-Windungsregel jeden Teilpfad als Bestandteil desselben Bereichs: Für ein Loch in einer größeren Form muss der innere Teilpfad entgegengesetzt zum äußeren verlaufen. Wenn dies unpraktisch ist, rufen Sie stattdessen DrawPathEvenOdd auf — die Gerade-Ungerade-Regel wechselt bei jeder Überschreitung einfach zwischen innen und außen und vereinfacht damit ausgestanzte Löcher

Beispiel

// Filled outlined diamond
PDF.SetStrokeColor(0, 0, 0);
PDF.SetFillColor(0.6, 0.8, 1);
PDF.SetLineWidth(1.5);

PDF.StartPath(150, 100);
PDF.AddLineToPath(200, 150);
PDF.AddLineToPath(150, 200);
PDF.AddLineToPath(100, 150);
PDF.ClosePath;
PDF.DrawPath(2);                       // 2 = fill and outline

Siehe auch

DrawPathEvenOdd, StartPath, AddLineToPath, AddCurveToPath, AddArcToPath, ClosePath, SetLineWidth