PDFium Delphi Component Docs

CreatePath метод

Component: TPdf  ·  Unit: PDFium
Створює новий об'єкт шляху в початковій позиції

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. Режим змішування (blend mode) для об'єкта шляху. Типове — 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. Режим змішування (blend mode). Типове — bmDefault

Description

CreatePath починає побудову нового векторного об'єкта шляху. Його треба викликати перед будь-яким із методів побудови шляху (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 відкидає попередній очікуваний шлях

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