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);
| FillMode | TPdfFillMode. Füllregel für das Innere des Pfads: fmNone (keine Füllung), fmAlternate (Gerade-Ungerade-Regel) oder fmWinding (Nicht-Null-Windungsregel). Standard ist fmNone |
| FillColor | TColor. Füllfarbe, die angewendet wird, wenn FillMode nicht fmNone ist. Standard ist clBlack |
| FillAlpha | Byte. Deckkraft der Füllung, wobei $00 vollständig transparent und $FF vollständig deckend ist. Standard ist $FF |
| Stroke | Boolean. Wenn True, wird die Pfadkontur mit StrokeColor, StrokeAlpha und StrokeWidth gezeichnet. Standard ist True |
| StrokeColor | TColor. Farbe der Pfadkontur. Standard ist clBlack |
| StrokeAlpha | Byte. Deckkraft der Kontur, wobei $00 vollständig transparent und $FF vollständig deckend ist. Standard ist $FF |
| StrokeWidth | Single. Breite der Konturlinie in PDF-User-Einheiten (Punkten). Standard ist 1.0 |
| LineCap | TPdfLineCap. Stil für offene Pfadendpunkte: lcDefault, lcButt, lcRound oder lcProjectingSquare. Standard ist lcDefault |
| LineJoin | TPdfLineJoin. Stil an Verbindungsstellen von Pfadsegmenten: ljDefault, ljMiter, ljRound oder ljBevel. Standard ist ljDefault |
| BlendMode | TPdfBlendMode. Mischmodus für das Pfadobjekt. Standard ist bmDefault (normal) |
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);
| FillMode | TPdfFillMode. Fill rule for the rectangle interior. Default is fmNone. |
| FillColor | TColor. Fill color for the rectangle. Default is clBlack. |
| FillAlpha | Byte. Opacity of the fill ($00–$FF). Default is $FF. |
| Stroke | Boolean. When True, the rectangle outline is drawn. Default is True. |
| StrokeColor | TColor. Color of the rectangle outline. Default is clBlack. |
| StrokeAlpha | Byte. Opacity of the stroke ($00–$FF). Default is $FF. |
| StrokeWidth | Single. Width of the outline stroke in points. Default is 1.0. |
| LineCap | TPdfLineCap. Line cap style for the rectangle corners. Default is lcDefault. |
| LineJoin | TPdfLineJoin. Line join style for the rectangle corners. Default is ljDefault. |
| BlendMode | TPdfBlendMode. Compositing blend mode. Default is bmDefault. |
CreatePath beginnt mit dem Aufbau eines neuen Vektorpfadobjekts. Sie muss vor allen Pfadaufbau-Methoden (MoveTo, LineTo, BezierTo, ClosePath) aufgerufen werden, und die Sequenz muss mit einem Aufruf von AddPath abgeschlossen werden, um den Pfad auf der aktuellen Seite zu übernehmen.
Es stehen zwei Überladungen zur Verfügung. Die zweikoordinatische Form CreatePath(X, Y, ...) initialisiert einen leeren Pfad mit dem aktuellen Punkt bei (X, Y); Sie bauen die Form dann frei mit den Pfadsegment-Methoden auf. Die vierkoordinatische Form CreatePath(X, Y, Width, Height, ...) erzeugt direkt einen geschlossenen rechteckigen Pfad - zusätzliche Segmentaufrufe vor AddPath sind nicht nötig.
Alle visuellen Eigenschaften des Pfads - Füllfarbe und -regel, Konturfarbe, Breite, Deckkraft, Linienkappe, Linienverbindung und Mischmodus - werden beim Erzeugen über die optionalen Parameter gesetzt. Die Standardwerte ergeben eine 1-Punkt-schwarz konturierte Form ohne Füllung.
Es kann immer nur ein Pfad gleichzeitig aufgebaut werden. Wenn Sie CreatePath erneut aufrufen, bevor AddPath erfolgt ist, wird der vorherige ausstehende Pfad verworfen.
// Ein blau gefülltes Dreieck mit schwarzer 2-Punkt-Kontur zeichnen
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;
// Ein rot gefülltes Rechteck mit der 4-Koordinaten-Überladung zeichnen
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;