NewGraphicsState

Vektorgrafik, Text, Seitenlayout

Beschreibung

Erstellt oder verwendet ein PDF-ExtGState erneut, das Fülltransparenz, Konturtransparenz, Linienbreite, Linienende, Linienverbindung und Gehrungsgrenze zur späteren Anwendung mit SetGraphicsState kombinieren kann

Syntax

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

Parameter

FillTransparency	Prozentsatz der Fülltransparenz, wobei 0 deckend und 100 unsichtbar bedeutet, oder -1, um `/ca` auszulassen
StrokeTransparency	Prozentsatz der Strichtransparenz, wobei 0 deckend und 100 unsichtbar bedeutet, oder -1, um `/CA` auszulassen
LineWidth	Linienbreite in den aktuellen Maßeinheiten, 0 für eine PDF-Haarlinie oder -1 zum Auslassen von `/LW`
LineCap	Linienendstil 0 = stumpf, 1 = rund, 2 = überstehendes Quadrat oder -1, um `/LC` auszulassen
LineJoin	Linienverbindungsstil 0 = Gehrung, 1 = rund, 2 = abgeschrägt oder -1, um `/LJ` auszulassen
MiterLimit	Gehrungsgrenzverhältnis größer als 0 oder -1, um `/ML` auszulassen

Rückgabewerte

0	Es wurde keine gültige Grafikzustandseigenschaft angegeben, ein Parameter lag außerhalb des Bereichs oder Transparenz ist im aktuellen PDF/A-Modus nicht zulässig
>0	Eine wiederverwendbare Grafikzustands-ID für das ausgewählte Dokument

Anmerkungen

Identische Einstellungen verwenden dasselbe ExtGState-Objekt erneut, statt doppelte Ressourcenwörterbücher zu schreiben

Transparenzeinträge erhöhen die effektive Dokumentversion automatisch auf PDF 1.4; Einträge, die nur den Linienzustand betreffen, erhöhen sie auf PDF 1.3

Die zurückgegebene ID gehört zum aktuellen Dokument und sollte vor dem Zeichnen von Inhalten, die diese Einstellungen verwenden sollen, an SetGraphicsState übergeben werden

Siehe auch

NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency