PDFium Component Docs

CreatePath methode

Component: TPdf  ·  Unit: PDFium
Maakt een nieuw padobject op een beginpositie aan

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. Vulregel voor de interieur van het pad: fmNone (geen vulling), fmAlternate (even-odd-regel) of fmWinding (non-zero winding-regel). Standaard is fmNone.
FillColorTColor. Vulkleur toegepast wanneer FillMode niet fmNone is. Standaard is clBlack.
FillAlphaByte. Dekking van de vulling, waarbij $00 volledig transparant is en $FF volledig dekkend. Standaard is $FF.
StrokeBoolean. Bij True wordt de padomtrek getekend met StrokeColor, StrokeAlpha en StrokeWidth. Standaard is True.
StrokeColorTColor. Kleur van de padomtrek. Standaard is clBlack.
StrokeAlphaByte. Dekking van de lijn, waarbij $00 volledig transparant is en $FF volledig dekkend. Standaard is $FF.
StrokeWidthSingle. Breedte van de strooklijn in PDF-gebruikereenheden (punten). Standaard is 1.0.
LineCapTPdfLineCap. Stijl toegepast op open padeindpunten: lcDefault, lcButt, lcRound of lcProjectingSquare. Standaard is lcDefault.
LineJoinTPdfLineJoin. Stijl toegepast op padsegmentverbindingen: ljDefault, ljMiter, ljRound of ljBevel. Standaard is ljDefault.
BlendModeTPdfBlendMode. Composiet-blendmodus voor het padobject. Standaard is bmDefault, dat samenstelt als 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. Vulregel voor de interieur van de rechthoek. Standaard is fmNone.
FillColorTColor. Vulkleur voor de rechthoek. Standaard is clBlack.
FillAlphaByte. Dekking van de vulling ($00–$FF). Standaard is $FF.
StrokeBoolean. Bij True wordt de omtrek van de rechthoek getekend. Standaard is True.
StrokeColorTColor. Kleur van de omtrek van de rechthoek. Standaard is clBlack.
StrokeAlphaByte. Dekking van de lijn ($00–$FF). Standaard is $FF.
StrokeWidthSingle. Breedte van de omtrekstrook in punten. Standaard is 1.0.
LineCapTPdfLineCap. Line-cap-stijl voor de hoeken van de rechthoek. Standaard is lcDefault.
LineJoinTPdfLineJoin. Line-join-stijl voor de hoeken van de rechthoek. Standaard is ljDefault.
BlendModeTPdfBlendMode. Composiet-blendmodus. Standaard is bmDefault.

Description

CreatePath begint de constructie van een nieuw vectorpadobject. Het moet worden aangeroepen vóór elk van de padbouwende methoden (MoveTo, LineTo, BezierTo, ClosePath), en de reeks moet worden afgerond met een aanroep van AddPath om het pad op de huidige pagina vast te leggen.

Er zijn twee overloads beschikbaar. De tweekoördinatenvorm CreatePath(X, Y, ...) initialiseert een leeg pad met zijn huidige punt op (X, Y); daarna wordt de vorm vrij opgebouwd met de padsegmentmethoden. De viercoördinatenvorm CreatePath(X, Y, Width, Height, ...) maakt direct een gesloten rechthoekig pad aan — er zijn geen extra segmentaanroepen nodig vóór AddPath.

Alle visuele eigenschappen van het pad — vulkleur en vulregel, lijnkleur, breedte, dekking, line cap, line join en blendmodus — worden bij het aanmaken ingesteld via de optionele parameters. Standaardwaarden leveren een zwarte getekende omtrek van 1 punt op zonder vulling.

Er is hooguit één pad tegelijk in aanbouw. CreatePath opnieuw aanroepen vóór AddPath verwijdert het vorige wachtende pad.

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