PDFium Component Docs

CreatePath Metoda

Component: TPdf  ·  Unit: PDFium
Tworzy nowy obiekt ścieżki w pozycji początkowej

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. Reguła wypełniania wnętrza ścieżki: fmNone (bez wypełnienia), fmAlternate (reguła parzystości) albo fmWinding (reguła niezerowego nawinięcia). Domyślnie fmNone
FillColorTColor. Kolor wypełnienia stosowany, gdy FillMode różni się od fmNone. Domyślnie clBlack
FillAlphaByte. Krycie wypełnienia, gdzie $00 oznacza pełną przezroczystość, a $FF pełne krycie. Domyślnie $FF
StrokeBoolean. Gdy True, kontur ścieżki jest rysowany z użyciem StrokeColor, StrokeAlpha i StrokeWidth. Domyślnie True
StrokeColorTColor. Kolor konturu ścieżki. Domyślnie clBlack
StrokeAlphaByte. Krycie konturu, gdzie $00 oznacza pełną przezroczystość, a $FF pełne krycie. Domyślnie $FF
StrokeWidthSingle. Szerokość linii konturu w jednostkach użytkownika PDF (punkty). Domyślnie 1.0
LineCapTPdfLineCap. Styl stosowany na otwartych końcach ścieżki: lcDefault, lcButt, lcRound albo lcProjectingSquare. Domyślnie lcDefault
LineJoinTPdfLineJoin. Styl stosowany w złączeniach segmentów ścieżki: ljDefault, ljMiter, ljRound albo ljBevel. Domyślnie ljDefault
BlendModeTPdfBlendMode. Tryb mieszania kompozycji dla obiektu ścieżki. Domyślnie bmDefault, który komponuje jak 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. Reguła wypełniania wnętrza prostokąta. Domyślnie fmNone
FillColorTColor. Kolor wypełnienia prostokąta. Domyślnie clBlack
FillAlphaByte. Krycie wypełnienia ($00–$FF). Domyślnie $FF
StrokeBoolean. Gdy True, kontur prostokąta jest rysowany. Domyślnie True
StrokeColorTColor. Kolor konturu prostokąta. Domyślnie clBlack
StrokeAlphaByte. Krycie konturu ($00–$FF). Domyślnie $FF
StrokeWidthSingle. Szerokość linii konturu w punktach. Domyślnie 1.0
LineCapTPdfLineCap. Styl zakończeń linii dla narożników prostokąta. Domyślnie lcDefault
LineJoinTPdfLineJoin. Styl złączeń linii dla narożników prostokąta. Domyślnie ljDefault
BlendModeTPdfBlendMode. Tryb mieszania kompozycji. Domyślnie bmDefault

Description

CreatePath rozpoczyna budowę nowego wektorowego obiektu ścieżki. Trzeba go wywołać przed którąkolwiek z metod budowania ścieżki (MoveTo, LineTo, BezierTo, ClosePath), a sekwencję trzeba domknąć wywołaniem AddPath, które zatwierdza ścieżkę na bieżącej stronie

Dostępne są dwa warianty. Forma dwuwspółrzędna CreatePath(X, Y, ...) inicjuje pustą ścieżkę z punktem bieżącym w (X, Y); kształt buduje się potem swobodnie metodami segmentów ścieżki. Forma czterowspółrzędna CreatePath(X, Y, Width, Height, ...) tworzy od razu zamkniętą prostokątną ścieżkę — przed AddPath nie są potrzebne żadne dodatkowe wywołania segmentów

Wszystkie właściwości wizualne ścieżki — kolor i reguła wypełnienia, kolor konturu, jego szerokość i krycie, zakończenia linii, złączenia linii oraz tryb mieszania — są ustawiane w chwili tworzenia przez parametry opcjonalne. Wartości domyślne dają czarny kontur o szerokości 1 punktu bez wypełnienia

W danym momencie budowana może być tylko jedna ścieżka. Ponowne wywołanie CreatePath przed AddPath porzuca poprzednią ścieżkę oczekującą na zatwierdzenie

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