PDFium Component Docs

Метод CreatePath

Component: TPdf  ·  Unit: PDFium
Създава нов обект път (path) с първоначална позиция

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. Правило за запълване на вътрешността на пътя: fmNone (без запълване), fmAlternate (правило четно-нечетно) или fmWinding (правило на ненулево навиване). По подразбиране е fmNone.
FillColorTColor. Цвят на запълване, прилаган когато FillMode не е fmNone. По подразбиране е clBlack.
FillAlphaByte. Непрозрачност на запълването, където $00 е напълно прозрачно, а $FF е напълно непрозрачно. По подразбиране е $FF.
StrokeBoolean. Когато е True, контурът на пътя се чертае чрез StrokeColor, StrokeAlpha и StrokeWidth. По подразбиране е True.
StrokeColorTColor. Цвят на контура на пътя. По подразбиране е clBlack.
StrokeAlphaByte. Непрозрачност на щриха, където $00 е напълно прозрачно, а $FF е напълно непрозрачно. По подразбиране е $FF.
StrokeWidthSingle. Ширина на линията на щриха в потребителски единици на PDF (точки). По подразбиране е 1.0.
LineCapTPdfLineCap. Стил, прилаган към отворените краища на пътя: lcDefault, lcButt, lcRound или lcProjectingSquare. По подразбиране е lcDefault.
LineJoinTPdfLineJoin. Стил, прилаган при съединенията на отсечките на пътя: ljDefault, ljMiter, ljRound или ljBevel. По подразбиране е ljDefault.
BlendModeTPdfBlendMode. Режим на смесване (compositing blend mode) за обекта път. По подразбиране е 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);

FillModeTPdfFillMode. Правило за запълване на вътрешността на правоъгълника. По подразбиране е fmNone.
FillColorTColor. Цвят на запълване за правоъгълника. По подразбиране е clBlack.
FillAlphaByte. Непрозрачност на запълването ($00–$FF). По подразбиране е $FF.
StrokeBoolean. Когато е True, контурът на правоъгълника се чертае. По подразбиране е True.
StrokeColorTColor. Цвят на контура на правоъгълника. По подразбиране е clBlack.
StrokeAlphaByte. Непрозрачност на щриха ($00–$FF). По подразбиране е $FF.
StrokeWidthSingle. Ширина на контура в точки. По подразбиране е 1.0.
LineCapTPdfLineCap. Стил на краищата за ъглите на правоъгълника. По подразбиране е lcDefault.
LineJoinTPdfLineJoin. Стил на съединение за ъглите на правоъгълника. По подразбиране е ljDefault.
BlendModeTPdfBlendMode. Режим на смесване. По подразбиране е bmDefault.

Description

CreatePath започва изграждането на нов векторен обект път. Трябва да се извика преди който и да е от методите за изграждане на път (MoveTo, LineTo, BezierTo, ClosePath), а последователността трябва да бъде завършена с извикване на AddPath, за да се приложи пътят към текущата страница.

Налични са две презареждания (overload). Двukoординатната форма CreatePath(X, Y, ...) инициализира празен път с текуща точка (X, Y); след това изграждате формата свободно чрез методите за отсечки. Четирикоординатната форма CreatePath(X, Y, Width, Height, ...) създава затворен правоъгълен път директно — не са необходими допълнителни извиквания на отсечки преди AddPath.

Всички визуални свойства на пътя — цвят и правило на запълване, цвят на щриха, ширина, непрозрачност, краища, съединения и режим на смесване — се задават при създаване чрез допълнителните параметри. Стойностите по подразбиране дават черен контур с ширина 1 точка без запълване.

В даден момент може да се изгражда само един път. Извикването на CreatePath отново преди AddPath отхвърля предишния неизпълнен път.

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