PDFium Delphi Component Docs

CreatePath Méthode

Composant: TPdf  ·  Unit: PDFium
Crée un nouvel objet de chemin à une position initiale

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. Règle de remplissage de l’intérieur du chemin : fmNone (aucun remplissage), fmAlternate (règle pair-impair) ou fmWinding (règle d’enroulement non nul). La valeur par défaut est fmNone
FillColorTColor. Couleur de remplissage appliquée lorsque FillMode ne vaut pas fmNone. La valeur par défaut est clBlack
FillAlphaByte. Opacité du remplissage, où $00 est totalement transparent et $FF totalement opaque. La valeur par défaut est $FF
StrokeBoolean. Lorsque True, le contour du chemin est dessiné en utilisant StrokeColor, StrokeAlpha et StrokeWidth. La valeur par défaut est True
StrokeColorTColor. Couleur du contour du chemin. La valeur par défaut est clBlack
StrokeAlphaByte. Opacité du tracé, où $00 est totalement transparent et $FF totalement opaque. La valeur par défaut est $FF
StrokeWidthSingle. Largeur de la ligne de tracé en unités utilisateur PDF (points). La valeur par défaut est 1.0
LineCapTPdfLineCap. Style appliqué aux extrémités ouvertes du chemin : lcDefault, lcButt, lcRound ou lcProjectingSquare. La valeur par défaut est lcDefault
LineJoinTPdfLineJoin. Style appliqué aux jointures des segments du chemin : ljDefault, ljMiter, ljRound ou ljBevel. La valeur par défaut est ljDefault
BlendModeTPdfBlendMode. Mode de fusion de composition pour l’objet de chemin. La valeur par défaut est bmDefault, qui compose comme 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. Règle de remplissage de l’intérieur du rectangle. La valeur par défaut est fmNone
FillColorTColor. Couleur de remplissage du rectangle. La valeur par défaut est clBlack
FillAlphaByte. Opacité du remplissage ($00–$FF). La valeur par défaut est $FF
StrokeBoolean. Lorsque True, le contour du rectangle est dessiné. La valeur par défaut est True
StrokeColorTColor. Couleur du contour du rectangle. La valeur par défaut est clBlack
StrokeAlphaByte. Opacité du tracé ($00–$FF). La valeur par défaut est $FF
StrokeWidthSingle. Largeur du tracé du contour en points. La valeur par défaut est 1.0
LineCapTPdfLineCap. Style de terminaison de ligne pour les coins du rectangle. La valeur par défaut est lcDefault
LineJoinTPdfLineJoin. Style de jointure de ligne pour les coins du rectangle. La valeur par défaut est ljDefault
BlendModeTPdfBlendMode. Mode de fusion de composition. La valeur par défaut est bmDefault

Description

CreatePath commence la construction d’un nouvel objet de chemin vectoriel. Elle doit être appelée avant toute méthode de construction de chemin (MoveTo, LineTo, BezierTo, ClosePath), et la séquence doit être complétée par un appel à AddPath pour valider le chemin sur la page active

Deux surcharges sont disponibles. La forme à deux coordonnées CreatePath(X, Y, ...) initialise un chemin vide avec son point courant à (X, Y) ; vous construisez ensuite librement la forme à l’aide des méthodes de segments de chemin. La forme à quatre coordonnées CreatePath(X, Y, Width, Height, ...) crée directement un chemin rectangulaire fermé — aucun appel de segment supplémentaire n’est nécessaire avant AddPath

Toutes les propriétés visuelles du chemin — couleur et règle de remplissage, couleur de tracé, largeur, opacité, terminaison de ligne, jointure de ligne et mode de fusion — sont définies à la création via les paramètres facultatifs. Les valeurs par défaut produisent un contour noir tracé de 1 point sans remplissage

Un seul chemin peut être en construction à la fois. Appeler CreatePath de nouveau avant AddPath abandonne le chemin en attente précédent

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