PDFium Delphi Component Docs

метод CreatePath

Компонент: TPdf  ·  Модул: PDFium
Създава нов path обект на начална позиция

Синтаксис

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

Описание

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

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

Всички визуални свойства на пътя - цвят и правило за запълване, цвят на щриха, дебелина, непрозрачност, line cap, line join и blend mode - се задават при създаване чрез незадължителните параметри. Стойностите по подразбиране дават черен щрих с дебелина 1 точка, без запълване

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

Пример

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

Виж също

MoveTo, LineTo, BezierTo, ClosePath, AddPath