PDFium Delphi Component Docs

CreatePath Metodo

Componente: TPdf  ·  Unità: PDFium
Crea un nuovo oggetto percorso in una posizione iniziale

Sintassi

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. Regola di riempimento per l'interno del percorso: fmNone (nessun riempimento), fmAlternate (regola pari-dispari) o fmWinding (regola del winding diverso da zero). Il valore predefinito è fmNone
FillColorTColor. Colore di riempimento applicato quando FillMode non è fmNone. Il valore predefinito è clBlack
FillAlphaByte. Opacità del riempimento, dove $00 è completamente trasparente e $FF completamente opaco. Il valore predefinito è $FF
StrokeBoolean. Quando True, il contorno del percorso viene disegnato usando StrokeColor, StrokeAlpha e StrokeWidth. Il valore predefinito è True
StrokeColorTColor. Colore del contorno del percorso. Il valore predefinito è clBlack
StrokeAlphaByte. Opacità del tratto, dove $00 è completamente trasparente e $FF completamente opaco. Il valore predefinito è $FF
StrokeWidthSingle. Larghezza della linea del tratto in unità utente PDF (punti). Il valore predefinito è 1.0
LineCapTPdfLineCap. Stile applicato alle estremità aperte del percorso: lcDefault, lcButt, lcRound o lcProjectingSquare. Il valore predefinito è lcDefault
LineJoinTPdfLineJoin. Stile applicato alle giunzioni dei segmenti del percorso: ljDefault, ljMiter, ljRound o ljBevel. Il valore predefinito è ljDefault
BlendModeTPdfBlendMode. Modalità di fusione di compositing per l'oggetto percorso. Il valore predefinito è bmDefault, che composita come 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. Regola di riempimento per l'interno del rettangolo. Il valore predefinito è fmNone
FillColorTColor. Colore di riempimento del rettangolo. Il valore predefinito è clBlack
FillAlphaByte. Opacità del riempimento ($00–$FF). Il valore predefinito è $FF
StrokeBoolean. Quando True, il contorno del rettangolo viene disegnato. Il valore predefinito è True
StrokeColorTColor. Colore del contorno del rettangolo. Il valore predefinito è clBlack
StrokeAlphaByte. Opacità del tratto ($00–$FF). Il valore predefinito è $FF
StrokeWidthSingle. Larghezza del tratto del contorno in punti. Il valore predefinito è 1.0
LineCapTPdfLineCap. Stile delle estremità di linea per gli angoli del rettangolo. Il valore predefinito è lcDefault
LineJoinTPdfLineJoin. Stile di giunzione della linea per gli angoli del rettangolo. Il valore predefinito è ljDefault
BlendModeTPdfBlendMode. Modalità di fusione di compositing. Il valore predefinito è bmDefault

Descrizione

CreatePath avvia la costruzione di un nuovo oggetto percorso vettoriale. Deve essere chiamato prima di qualsiasi metodo di costruzione del percorso (MoveTo, LineTo, BezierTo, ClosePath) e la sequenza deve essere completata con una chiamata a AddPath per eseguire il commit del percorso nella pagina corrente

Sono disponibili due overload. La forma a due coordinate CreatePath(X, Y, ...) inizializza un percorso vuoto con il punto corrente in (X, Y); la forma viene poi costruita liberamente con i metodi dei segmenti del percorso. La forma a quattro coordinate CreatePath(X, Y, Width, Height, ...) crea direttamente un percorso rettangolare chiuso — non sono necessarie chiamate di segmenti aggiuntive prima di AddPath

Tutte le proprietà visive del percorso — colore e regola di riempimento, colore, larghezza e opacità del tratto, estremità di linea, giunzioni di linea e modalità di fusione — vengono impostate alla creazione tramite i parametri facoltativi. I valori predefiniti producono un contorno con tratto nero di 1 punto senza riempimento

Un solo percorso può essere in costruzione alla volta. Chiamare di nuovo CreatePath prima di AddPath scarta il percorso in sospeso precedente

Esempio

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

Vedi anche

MoveTo, LineTo, BezierTo, ClosePath, AddPath