Документация PDFiumPas

CreatePath Метод

Эта запись API сохраняет идентификаторы, сигнатуры, блоки кода и термины PDF в исходном виде.
Компонент: TPdf  ·  Модуль: PDFium
Create a new path object at an initial position.

Синтаксис

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. Fill rule for the path interior: fmNone (no fill), fmAlternate (even-odd rule), or fmWinding (non-zero winding rule). Default is fmNone.
FillColorTColor. Fill color applied when FillMode is not fmNone. Default is clBlack.
FillAlphaByte. Непрозрачность заливки, где $00 полностью прозрачен, а $FF полностью непрозрачен. По умолчанию $FF
StrokeBoolean. When True, the path outline is drawn using StrokeColor, StrokeAlpha, and StrokeWidth. Default is True.
StrokeColorTColor. Color of the path outline. Default is clBlack.
StrokeAlphaByte. Непрозрачность обводки, где $00 полностью прозрачен, а $FF полностью непрозрачен. По умолчанию $FF
StrokeWidthSingle. Width of the stroke line in PDF user units (points). Default is 1.0.
LineCapTPdfLineCap. Style applied to open path endpoints: lcDefault, lcButt, lcRound, or lcProjectingSquare. Default is lcDefault.
LineJoinTPdfLineJoin. Style applied at path segment joins: ljDefault, ljMiter, ljRound, or ljBevel. Default is ljDefault.
BlendModeTPdfBlendMode. Compositing blend mode for the path object. Default is 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. Fill rule for the rectangle interior. Default is fmNone.
FillColorTColor. Fill color for the rectangle. Default is clBlack.
FillAlphaByte. Непрозрачность заливки ($00–$FF). По умолчанию $FF
StrokeBoolean. When True, the rectangle outline is drawn. Default is True.
StrokeColorTColor. Color of the rectangle outline. Default is clBlack.
StrokeAlphaByte. Непрозрачность обводки ($00–$FF). По умолчанию $FF
StrokeWidthSingle. Width of the outline stroke in points. Default is 1.0.
LineCapTPdfLineCap. Line cap style for the rectangle corners. Default is lcDefault.
LineJoinTPdfLineJoin. Line join style for the rectangle corners. Default is ljDefault.
BlendModeTPdfBlendMode. Compositing blend mode. Default is bmDefault.

Описание

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

Доступны две перегрузки. Вариант с двумя координатами CreatePath(X, Y, ...) инициализирует пустой путь с текущей точкой в (X, Y); затем форму можно свободно строить методами сегментов пути. Вариант с четырьмя координатами CreatePath(X, Y, Width, Height, ...) сразу создает замкнутый прямоугольный путь — дополнительные вызовы сегментов перед AddPath не нужны

All visual properties of the path — fill color and rule, stroke color, width, opacity, line cap, line join, and blend mode — are set at creation time via the optional parameters. Default values produce a 1-point black stroked outline with no fill.

Одновременно может быть построен только один путь. Повторный вызов 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