PDFium Delphi Component Docs

CreatePath-metod

Component: TPdf  ·  Unit: PDFium
Skapar ett nytt sidobjekt av typen bana vid en startposition

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. Fyllnadsregel för banans inre: fmNone (ingen fyllnad), fmAlternate (jämna-udda-regeln) eller fmWinding (nollskild vindningsregel). Standard är fmNone
FillColorTColor. Fyllnadsfärg som tillämpas när FillMode inte är fmNone. Standard är clBlack
FillAlphaByte. Fyllnadens opacitet, där $00 är helt transparent och $FF är helt opak. Standard är $FF
StrokeBoolean. När True ritas banans kontur med StrokeColor, StrokeAlpha och StrokeWidth. Standard är True
StrokeColorTColor. Färg på banans kontur. Standard är clBlack
StrokeAlphaByte. Strykningens opacitet, där $00 är helt transparent och $FF är helt opak. Standard är $FF
StrokeWidthSingle. Bredd på stryklinjen i PDF-användarenheter (punkter). Standard är 1.0
LineCapTPdfLineCap. Stil som tillämpas på öppna banändpunkter: lcDefault, lcButt, lcRound eller lcProjectingSquare. Standard är lcDefault
LineJoinTPdfLineJoin. Stil som tillämpas vid banans segmentanslutningar: ljDefault, ljMiter, ljRound eller ljBevel. Standard är ljDefault
BlendModeTPdfBlendMode. Sammansättningsblendläge för sidobjektet. Standard är bmDefault, som sätter samman som bmNormal

 

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. Fyllnadsregel för rektangelns inre. Standard är fmNone
FillColorTColor. Fyllnadsfärg för rektangeln. Standard är clBlack
FillAlphaByte. Fyllnadens opacitet ($00–$FF). Standard är $FF
StrokeBoolean. När True ritas rektangelns kontur. Standard är True
StrokeColorTColor. Färg på rektangelns kontur. Standard är clBlack
StrokeAlphaByte. Strykningens opacitet ($00–$FF). Standard är $FF
StrokeWidthSingle. Bredd på konturstrykningen i punkter. Standard är 1.0
LineCapTPdfLineCap. Line cap-stil för rektangelns hörn. Standard är lcDefault
LineJoinTPdfLineJoin. Line join-stil för rektangelns hörn. Standard är ljDefault
BlendModeTPdfBlendMode. Sammansättningsblendläge. Standard är bmDefault

Description

CreatePath inleder byggandet av ett nytt vektorsidobjekt av ban-typ. Den måste anropas innan någon av banbyggarmetoderna (MoveTo, LineTo, BezierTo, ClosePath), och sekvensen måste avslutas med ett anrop till AddPath för att committa banan till den aktuella sidan

Två overloads finns tillgängliga. Tvåkoordinatformen CreatePath(X, Y, ...) initierar en tom bana med sin aktuella punkt vid (X, Y); du bygger därefter formen fritt med bansegmentmetoderna. Fyrkoordinatformen CreatePath(X, Y, Width, Height, ...) skapar en stängd rektangulär bana direkt — inga ytterligare segmentanrop behövs före AddPath

Alla visuella egenskaper hos banan — fyllnadsfärg och regel, strykfärg, bredd, opacitet, line cap, line join och blend mode — sätts vid skapandet via de valfria parametrarna. Standardvärdena ger en 1-punkters svart strykkontur utan fyllnad

Bara en bana får vara under konstruktion åt gången. Att anropa CreatePath igen före AddPath kastar den tidigare väntande banan

Example

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

See Also

MoveTo, LineTo, BezierTo, ClosePath, AddPath