PDFium Component Docs

CreatePath Metoda

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.
Komponent: TPdf  ·  Moduł: PDFium
Tworzy nowy obiekt ścieżki w położeniu początkowym

Składnia

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łnienia wnętrza ścieżki: fmNone (bez wypełnienia), fmAlternate (reguła parzyste-nieparzyste) albo fmWinding (reguła niezerowego nawijania) Domyślnie fmNone
FillColorTColor. Kolor wypełnienia stosowany, gdy FillMode nie jest fmNone Domyślnie clBlack
FillAlphaByte. Krycie wypełnienia, gdzie $00 oznacza pełną przezroczystość, a $FF pełną nieprzezroczystość 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 obrysu, gdzie $00 oznacza pełną przezroczystość, a $FF pełną nieprzezroczystość Domyślnie $FF
StrokeWidthSingle. Szerokość linii obrysu w jednostkach użytkownika PDF (punktach) Domyślnie 1.0
LineCapTPdfLineCap. Styl stosowany do końców otwartej ścieżki: lcDefault, lcButt, lcRound albo lcProjectingSquare Domyślnie lcDefault
LineJoinTPdfLineJoin. Styl stosowany w miejscach łączenia segmentów ścieżki: ljDefault, ljMiter, ljRound albo ljBevel Domyślnie ljDefault
BlendModeTPdfBlendMode. Tryb mieszania kompozycji dla obiektu ścieżki Domyślnie bmDefault (normalny)

 

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łnienia wnętrza prostokąta Domyślna wartość to fmNone
FillColorTColor. Kolor wypełnienia prostokąta Domyślnie clBlack
FillAlphaByte. Krycie wypełnienia ($00–$FF) Domyślnie $FF
StrokeBoolean. Gdy True, rysowany jest kontur prostokąta Domyślnie True
StrokeColorTColor. Kolor konturu prostokąta Domyślnie clBlack
StrokeAlphaByte. Krycie obrysu ($00–$FF) Domyślnie $FF
StrokeWidthSingle. Szerokość obrysu w punktach Domyślnie 1.0
LineCapTPdfLineCap. Styl zakończenia linii dla narożników prostokąta Domyślnie lcDefault
LineJoinTPdfLineJoin. Styl łączenia linii dla narożników prostokąta Domyślnie ljDefault
BlendModeTPdfBlendMode. Tryb mieszania kompozycji Domyślnie bmDefault

Opis

CreatePath rozpoczyna budowę nowego obiektu ścieżki wektorowej Musi zostać wywołany przed jakąkolwiek metodą budującą ścieżkę (MoveTo, LineTo, BezierTo, ClosePath), a sekwencję trzeba zakończyć wywołaniem AddPath, aby zatwierdzić ścieżkę na bieżącej stronie

Dostępne są dwa przeciążenia Wersja z dwoma współrzędnymi CreatePath(X, Y, ...) inicjuje pustą ścieżkę z bieżącym punktem w (X, Y); następnie budujesz kształt swobodnie, używając metod segmentów ścieżki Wersja z czterema współrzędnymi CreatePath(X, Y, Width, Height, ...) tworzy bezpośrednio zamkniętą prostokątną ścieżkę — przed AddPath nie trzeba wywoływać żadnych dodatkowych segmentów

Wszystkie wizualne właściwości ścieżki — kolor i reguła wypełnienia, kolor obrysu, szerokość, krycie, zakończenie linii, łączenie linii i tryb mieszania — są ustawiane w chwili tworzenia przez parametry opcjonalne Wartości domyślne dają czarny obrys o grubości 1 punktu bez wypełnienia

Tylko jedna ścieżka może być naraz w trakcie budowy Ponowne wywołanie CreatePath przed AddPath porzuca poprzednią oczekującą ścieżkę

Przykład

// Rysuje wypełniony niebieski trójkąt z czarnym obrysem 2 pt
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;

// Rysuje czerwony wypełniony prostokąt z użyciem przeciążenia czterech współrzędnych
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;

Zobacz też

MoveTo, LineTo, BezierTo, ClosePath, AddPath