NewGraphicsState

Graphiques vectoriels, texte, disposition des pages

Description

Crée ou réutilise un ExtGState PDF capable de combiner les paramètres de transparence du remplissage, de transparence du contour, de largeur de ligne, d’extrémité de ligne, de jointure et de limite de pointe pour une application ultérieure avec SetGraphicsState

Syntaxe

Delphi

Function TPDFlib.NewGraphicsState(FillTransparency, StrokeTransparency: Integer; LineWidth: Double; LineCap, LineJoin: Integer; MiterLimit: Double): Integer;

ActiveX

Function PDFlib::NewGraphicsState(FillTransparency As Long, StrokeTransparency As Long, LineWidth As Double, LineCap As Long, LineJoin As Long, MiterLimit As Double) As Long

DLL

int DLNewGraphicsState(int InstanceID, int FillTransparency, int StrokeTransparency, double LineWidth, int LineCap, int LineJoin, double MiterLimit);

Paramètres

FillTransparency	Pourcentage de transparence du remplissage, où 0 est opaque et 100 invisible, ou -1 pour omettre `/ca`
StrokeTransparency	Pourcentage de transparence du contour, où 0 est opaque et 100 invisible, ou -1 pour omettre `/CA`
LineWidth	Largeur de ligne dans les unités de mesure actuelles, 0 pour un filet PDF, ou -1 pour omettre `/LW`
LineCap	Style d'extrémité de ligne 0 = plate, 1 = ronde, 2 = carrée saillante, ou -1 pour omettre `/LC`
LineJoin	Style de jointure de ligne 0 = pointe, 1 = arrondi, 2 = biseau, ou -1 pour omettre `/LJ`
MiterLimit	Rapport de limite d’onglet supérieur à 0, ou -1 pour omettre `/ML`

Valeurs de retour

0	Aucune propriété d'état graphique valide n'a été fournie, un paramètre était hors plage ou la transparence n'est pas autorisée dans le mode PDF/A actuel
>0	ID d’état graphique réutilisable pour le document sélectionné

Remarques

Des paramètres identiques réutilisent le même objet ExtGState au lieu d'écrire des dictionnaires de ressources en double

Les entrées de transparence relèvent automatiquement la version effective du document à PDF 1.4 ; les entrées d'état de ligne seules la relèvent à PDF 1.3

L'ID renvoyé appartient au document actuel et doit être transmis à SetGraphicsState avant de dessiner un contenu qui doit utiliser ces réglages

Voir aussi

NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency