PDFium Component Docs

CreatePath metóda

Component: TPdf  ·  Unit: PDFium
Vytvorí nový objekt cesty na počiatočnej pozícii

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. Pravidlo výplne pre vnútro cesty: fmNone (bez výplne), fmAlternate (pravidlo pár-nepár) alebo fmWinding (pravidlo nenulového vinutia). Predvolené je fmNone.
FillColorTColor. Farba výplne aplikovaná, keď FillMode nie je fmNone. Predvolená je clBlack.
FillAlphaByte. Nepriehľadnosť výplne, kde $00 je úplne priehľadné a $FF je úplne nepriehľadné. Predvolená je $FF.
StrokeBoolean. Keď je True, obrys cesty sa nakreslí pomocou StrokeColor, StrokeAlpha a StrokeWidth. Predvolené je True.
StrokeColorTColor. Farba obrysu cesty. Predvolená je clBlack.
StrokeAlphaByte. Nepriehľadnosť ťahu, kde $00 je úplne priehľadné a $FF je úplne nepriehľadné. Predvolená je $FF.
StrokeWidthSingle. Šírka čiary ťahu v používateľských jednotkách PDF (bodoch). Predvolená je 1.0.
LineCapTPdfLineCap. Štýl aplikovaný na koncové body otvorenej cesty: lcDefault, lcButt, lcRound alebo lcProjectingSquare. Predvolené je lcDefault.
LineJoinTPdfLineJoin. Štýl aplikovaný na spoje segmentov cesty: ljDefault, ljMiter, ljRound alebo ljBevel. Predvolené je ljDefault.
BlendModeTPdfBlendMode. Režim kompozitného miešania pre objekt cesty. Predvolený je bmDefault (normálny).

 

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. Pravidlo výplne pre vnútro obdĺžnika. Predvolené je fmNone.
FillColorTColor. Farba výplne obdĺžnika. Predvolená je clBlack.
FillAlphaByte. Nepriehľadnosť výplne ($00–$FF). Predvolená je $FF.
StrokeBoolean. Keď je True, obrys obdĺžnika sa nakreslí. Predvolené je True.
StrokeColorTColor. Farba obrysu obdĺžnika. Predvolená je clBlack.
StrokeAlphaByte. Nepriehľadnosť ťahu ($00–$FF). Predvolená je $FF.
StrokeWidthSingle. Šírka ťahu obrysu v bodoch. Predvolená je 1.0.
LineCapTPdfLineCap. Štýl zakončenia čiary pre rohy obdĺžnika. Predvolené je lcDefault.
LineJoinTPdfLineJoin. Štýl spoja čiary pre rohy obdĺžnika. Predvolené je ljDefault.
BlendModeTPdfBlendMode. Režim kompozitného miešania. Predvolený je bmDefault.

Description

CreatePath začína konštrukciu nového vektorového objektu cesty. Musí sa zavolať pred akoukoľvek z metód budovania cesty (MoveTo, LineTo, BezierTo, ClosePath) a sekvencia sa musí dokončiť volaním AddPath, aby sa cesta zapísala na aktuálnu stranu.

Sú k dispozícii dve preťaženia. Dvojsúradnicová forma CreatePath(X, Y, ...) inicializuje prázdnu cestu s jej aktuálnym bodom na (X, Y); potom tvar slobodne budujete pomocou metód segmentov cesty. Štvorsúradnicová forma CreatePath(X, Y, Width, Height, ...) vytvorí priamo uzavretú obdĺžnikovú cestu — pred AddPath nie sú potrebné žiadne ďalšie volania segmentov.

Všetky vizuálne vlastnosti cesty — farba a pravidlo výplne, farba ťahu, šírka, nepriehľadnosť, zakončenie čiary, spoj čiary a režim miešania — sa nastavujú v čase vytvorenia cez voliteľné parametre. Predvolené hodnoty vytvoria 1-bodový čierny obrys ťahom bez výplne.

Naraz môže byť v konštrukcii iba jedna cesta. Opätovné volanie CreatePath pred AddPath zahodí predchádzajúcu čakajúcu cestu.

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