PDFium Delphi Component Docs

CreatePath Methode

Komponente: TPdf  ·  Unit: PDFium
Erzeugt ein neues Pfadobjekt an einer Ausgangsposition

Syntax

procedure CreatePath(X, Y: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);

FillModeTPdfFillMode. Füllregel für das Pfadinnere: fmNone (keine Füllung), fmAlternate (Even-Odd-Regel) oder fmWinding (Non-Zero-Winding-Regel). Standard ist fmNone
FillColorTColor. Füllfarbe, angewendet wenn FillMode nicht fmNone ist. Standard ist clBlack
FillAlphaByte. Deckkraft der Füllung, wobei $00 vollständig transparent und $FF vollständig deckend ist. Standard ist $FF
StrokeBoolean. Bei True wird die Pfadkontur mit StrokeColor, StrokeAlpha und StrokeWidth gezeichnet. Standard ist True
StrokeColorTColor. Farbe der Pfadkontur. Standard ist clBlack
StrokeAlphaByte. Deckkraft der Kontur, wobei $00 vollständig transparent und $FF vollständig deckend ist. Standard ist $FF
StrokeWidthSingle. Breite der Konturlinie in PDF-Benutzereinheiten (Punkten). Standard ist 1.0
LineCapTPdfLineCap. Stil für offene Pfadenden: lcDefault, lcButt, lcRound oder lcProjectingSquare. Standard ist lcDefault
LineJoinTPdfLineJoin. Stil an den Verbindungen von Pfadsegmenten: ljDefault, ljMiter, ljRound oder ljBevel. Standard ist ljDefault
BlendModeTPdfBlendMode. Compositing-Blend-Modus für das Pfadobjekt. Standard ist bmDefault, was als bmNormal komponiert wird

 

procedure CreatePath(X, Y, Width, Height: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);

FillModeTPdfFillMode. Füllregel für das Rechteckinnere. Standard ist fmNone
FillColorTColor. Füllfarbe des Rechtecks. Standard ist clBlack
FillAlphaByte. Deckkraft der Füllung ($00–$FF). Standard ist $FF
StrokeBoolean. Bei True wird die Rechteckkontur gezeichnet. Standard ist True
StrokeColorTColor. Farbe der Rechteckkontur. Standard ist clBlack
StrokeAlphaByte. Deckkraft der Kontur ($00–$FF). Standard ist $FF
StrokeWidthSingle. Breite der Konturlinie in Punkten. Standard ist 1.0
LineCapTPdfLineCap. Linienenden-Stil für die Rechteckecken. Standard ist lcDefault
LineJoinTPdfLineJoin. Linienverbindungs-Stil für die Rechteckecken. Standard ist ljDefault
BlendModeTPdfBlendMode. Compositing-Blend-Modus. Standard ist bmDefault

Beschreibung

CreatePath beginnt den Aufbau eines neuen Vektorpfad-Objekts. Es muss aufgerufen werden, bevor eine der Pfadaufbau-Methoden verwendet wird (MoveTo, LineTo, BezierTo, ClosePath), und die Sequenz muss durch einen Aufruf von AddPath abgeschlossen werden, um den Pfad auf die aktuelle Seite zu übernehmen

Zwei Überladungen sind verfügbar. Die Zwei-Koordinaten-Form CreatePath(X, Y, ...) initialisiert einen leeren Pfad mit seinem aktuellen Punkt bei (X, Y); anschließend bauen Sie die Form frei mit den Pfadsegment-Methoden auf. Die Vier-Koordinaten-Form CreatePath(X, Y, Width, Height, ...) erzeugt direkt einen geschlossenen rechteckigen Pfad — zusätzliche Segmentaufrufe sind vor AddPath nicht nötig

Alle visuellen Eigenschaften des Pfads — Füllfarbe und Füllregel, Konturfarbe, Breite, Deckkraft, Line-Cap, Line-Join und Blend-Modus — werden zur Erstellungszeit über die optionalen Parameter gesetzt. Die Standardwerte erzeugen eine schwarze 1-Punkt-Kontur ohne Füllung

Nur ein Pfad kann gleichzeitig im Aufbau sein. Ein erneuter Aufruf von CreatePath vor AddPath verwirft den vorherigen ausstehenden Pfad

Beispiel

// Draw a filled blue triangle with a 2-pt black outline
Pdf1.NewPage(595, 842);
Pdf1.CreatePath(100, 100, fmWinding, clBlue, $FF, True, clBlack, $FF, 2.0);
Pdf1.LineTo(200, 300);
Pdf1.LineTo(300, 100);
Pdf1.ClosePath;
Pdf1.AddPath;

// Draw a red filled rectangle using the 4-coordinate overload
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;

Siehe auch

MoveTo, LineTo, BezierTo, ClosePath, AddPath