backend_pdf

Ein PDF-Matplotlib-Backend.

Autor: Jouni K. Seppänen < jks @ iki . fi > und andere.

matplotlib.backends.backend_pdf. FigureCanvas

Pseudonym vonFigureCanvasPdf

Klasse matplotlib.backends.backend_pdf. FigureCanvasPdf ( figure = None )

Basen:FigureCanvasBase

zeichnen ( )

Rendern Sie die Figure.

Diese Methode muss den Künstlerbaum durchlaufen, auch wenn keine Ausgabe erzeugt wird, da sie verzögerte Arbeit auslöst, auf die Benutzer möglicherweise zugreifen möchten, bevor sie die Ausgabe auf der Festplatte speichern. Zum Beispiel das Berechnen von Limits, Auto-Limits und Tick-Werten.

filetypes = {'pdf': 'Portable Document Format'}

fixed_dpi = 72

get_default_filetype ( )

Gibt das standardmäßige savefig-Dateiformat wie in rcParams["savefig.format"](Standard: 'png') angegeben zurück.

Die zurückgegebene Zeichenfolge enthält keinen Punkt. Diese Methode wird in Backends überschrieben, die nur einen einzigen Dateityp unterstützen.

print_pdf ( filename , * , bbox_inches_restore = None , metadata = None )

Klasse matplotlib.backends.backend_pdf. GraphicsContextPdf ( Datei )

Basen:GraphicsContextBase

alpha_cmd ( alpha , erzwungen , effektive_alphas )

capstyle_cmd ( Stil )

capstyles = {'butt': 0, 'projecting': 2, 'round': 1}

clip_cmd ( cliprect , clippath )

Beschneidungsrechteck festlegen. Anrufe pop()und push().

Befehle = ((('_cliprect', '_clippath'), <function GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_ Effective_alphas'), <function GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <Funktion GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <Funktion GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <Funktion GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <Funktion GraphicsContextPdf.linewidth_cmd>), (('_Dashes',), <function GraphicsContextPdf.dash_cmd>), (('_rgb',), <function GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <Funktion GraphicsContextPdf.hatch_cmd>))

copy_properties ( andere )

Eigenschaften von other in self kopieren.

dash_cmd ( Bindestriche )

Delta ( andere )

Eigenschaften von other in self kopieren und PDF-Befehle zurückgeben, die benötigt werden, um self in other umzuwandeln.

füllen ( * args )

Prädikat: muss der Pfad gefüllt werden?

Ein optionales Argument kann verwendet werden, um eine alternative _fillcolor anzugeben, wie von RendererPdf.draw_markers benötigt.

fillcolor_cmd ( rgb )

finalisieren ( )

Stellen Sie sicher, dass jeder gepushte Grafikzustand geknallt ist.

hatch_cmd ( hatch , hatch_color )

joinstyle_cmd ( style )

joinstyles = {'bevel': 2, 'miter': 0, 'round': 1}

linewidth_cmd ( Breite )

Farbe ( )

Geben Sie den entsprechenden PDF-Operator zurück, um zu bewirken, dass der Pfad gestrichelt, gefüllt oder beides wird.

pop ( )

drücken ( )

rgb_cmd ( rgb )

Strich ( )

Prädikat: muss der Pfad gestrichen (seine Umrisse gezeichnet) werden? Dies testet auf die verschiedenen Bedingungen, die das Streichen des Pfads deaktivieren, in diesem Fall würde er vermutlich gefüllt werden.

Klasse matplotlib.backends.backend_pdf. Name ( Name )

Basen:object

PDF-Namensobjekt.

statisches Verhexen ( Übereinstimmung )

[ Veraltet ]

Anmerkungen

Veraltet seit Version 3.6:

Name

pdfRepr ( )

Klasse matplotlib.backends.backend_pdf. Op ( Wert )

Basen:Enum

PDF-Operatoren (keine vollständige Liste).

begin_text = b'BT'

clip = b'W'

close_fill_stroke = b'b'

close_stroke = b's'

closepath = b'h'

concat_matrix = b'cm'

curveto = b'c'

end_text = b'ET'

endpath = b'n'

fill = b'f'

fill_stroke = b'B'

grestore = b'Q'

gsave = b'q'

lineto = b'l'

moveto = b'm'

Eigenschaft op

Klassenmethode Paint_path ( Füllung , Strich )

Geben Sie den PDF-Operator zurück, um einen Pfad zu zeichnen.

Parameter :

bool füllen

Füllen Sie den Pfad mit der Füllfarbe.

Strich bool

Streichen Sie den Umriss des Pfades mit der Linienfarbe.

pdfRepr ( )

Rechteck = b're'

selectfont = b'Tf'

setcolor_nonstroke = b'scn'

setcolor_stroke = b'SCN'

setcolorspace_nonstroke = b'cs'

setcolorspace_stroke = b'CS'

setdash = b'd'

setgray_nonstroke = b'g'

setgray_stroke = b'G'

setgstate = b'gs'

setlinecap = b'J'

setlinejoin = b'j'

setlinewidth = b'w'

setrgb_nonstroke = b'rg'

setrgb_stroke = b'RG'

Schattierung = b'sh'

show = b'Tj'

showkern = b'TJ'

Strich = b'S'

textmatrix = b'Tm'

textpos = b'Td'

use_xobject = b'Do'

Klasse matplotlib.backends.backend_pdf. Operator ( op )

Basen:object

[ Veraltet ]

Anmerkungen

Veraltet seit Version 3.6:

op

pdfRepr ( )

Klasse matplotlib.backends.backend_pdf. PdfFile ( Dateiname , Metadaten = None )

Basen:object

PDF-Dateiobjekt.

Parameter :

filename str oder pfadartig oder dateiartig

Ausgabeziel; wenn es sich um einen String handelt, wird eine Datei zum Schreiben geöffnet.

Metadaten diktieren von Zeichenfolgen zu Zeichenfolgen und Datumsangaben

Information-Dictionary-Objekt (siehe PDF-Referenz Abschnitt 10.2.1 'Document Information Dictionary'), zB: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

Die Standardschlüssel sind 'Titel', 'Autor', 'Betreff', 'Schlüsselwörter', 'Ersteller', 'Produzent', 'Erstellungsdatum', 'Änderungsdatum' und 'Trapped'. Für 'Creator', 'Producer' und 'CreationDate' wurden Werte vordefiniert. Sie können entfernt werden, indem Sie sie auf setzen None.

addGouraudTriangles ( Punkte , Farben )

Fügen Sie eine Gouraud-Dreiecksschattierung hinzu.

Parameter :

Punkte np.ndarray

Dreieckscheitel, Form (n, 3, 2) wobei n = Anzahl der Dreiecke, 3 = Eckpunkte, 2 = x, y.

Farben np.ndarray

Scheitelpunktfarben, Form (n, 3, 1) oder (n, 3, 4) wie bei Punkten, aber die letzte Dimension ist entweder (grau,) oder (r, g, b, alpha).

Rückgaben :

Name, Referenz

alphaState ( alpha )

Rückgabename eines ExtGState, der Alpha auf den angegebenen Wert setzt.

beginStream ( id , len , extra = None , png = None )

schließen ( )

Leeren Sie alle Puffer und geben Sie alle Ressourcen frei.

createType1Descriptor ( t1font , fontfile )

dviFontName ( dvifont )

Geben Sie bei einem gegebenen DVI-Schriftartobjekt einen für Op.selectfont geeigneten Namen zurück. Dadurch werden die Schriftinformationen registriert, self.dviFontInfofalls sie noch nicht registriert sind.

embedTTF ( Dateiname , Zeichen )

Betten Sie die TTF-Schriftart aus der benannten Datei in das Dokument ein.

endStream ( )

finalisieren ( )

Schreiben Sie die verschiedenen zurückgestellten Objekte und das PDF-Ende auf.

fontName ( fontprop )

Wählen Sie eine Schriftart basierend auf fontprop aus und geben Sie einen für Op.selectfont geeigneten Namen zurück. Wenn fontprop ein String ist, wird er als Dateiname der Schriftart interpretiert.

hatchPattern ( hatch_style )

imageObject ( Bild )

Gibt den Namen eines Bild-XObject zurück, das das angegebene Bild darstellt.

markerObject ( path , trans , fill , stroke , lw , joinstyle , capstyle )

Gibt den Namen eines Markierungs-XObject zurück, das den angegebenen Pfad darstellt.

newPage ( Breite , Höhe )

newTextnote ( text , positionRect = [-100, -100, 0, 0] )

Ausgabe ( * Daten )

outputStream ( ref , data , * , extra = None )

pathCollectionObject ( gc , path , trans , padding , filled , stroked )

statische pathOperations ( path , transform , clip = None , vereinfachen = None , sketch = None )

recordXref ( id )

reserveObject ( name = '' )

Reservieren Sie eine ID für ein indirektes Objekt.

Der Name wird zum Debuggen verwendet, falls wir vergessen, das Objekt mit writeObject auszudrucken.

schreiben ( Daten )

writeExtGSTates ( )

writeFonts ( )

writeGouraudTriangles ( )

writeHatches ( )

writeImages ( )

writeInfoDict ( )

Schreiben Sie das Info-Wörterbuch aus und überprüfen Sie es auf gute Form

writeMarkers ( )

writeObject ( Objekt , Inhalt )

writePath ( path , transform , clip = False , sketch = None )

writePathCollectionTemplates ( )

writeTrailer ( )

Schreiben Sie den PDF-Trailer aus.

writeXref ( )

Schreiben Sie die XRef-Tabelle aus.

Klasse matplotlib.backends.backend_pdf. PdfPages ( filename , keep_empty = True , metadata = None )

Basen:object

Eine mehrseitige PDF-Datei.

Anmerkungen

In Wirklichkeit PdfPagesist ein dünner Wrapper um PdfFile, um Verwechslungen bei der Verwendung savefigund dem Vergessen des Format-Arguments zu vermeiden.

Beispiele

>>> import matplotlib.pyplot as plt
>>> # Initialize:
>>> with PdfPages('foo.pdf') as pdf:
...     # As many times as you like, create a figure fig and save it:
...     fig = plt.figure()
...     pdf.savefig(fig)
...     # When no figure is specified the current figure is saved
...     pdf.savefig()

Erstellen Sie ein neues PdfPages-Objekt.

Parameter :

filename str oder pfadartig oder dateiartig

Plots mit PdfPages.savefigwerden an dieser Stelle in eine Datei geschrieben. Die Datei wird sofort geöffnet und eine ältere Datei mit demselben Namen wird überschrieben.

keep_empty bool, optional

Wenn auf False gesetzt, werden leere PDF-Dateien beim Schließen automatisch gelöscht.

Metadatenverzeichnis , optional

Information-Dictionary-Objekt (siehe PDF-Referenz Abschnitt 10.2.1 'Document Information Dictionary'), zB: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

Die Standardschlüssel sind 'Titel', 'Autor', 'Betreff', 'Schlüsselwörter', 'Ersteller', 'Produzent', 'Erstellungsdatum', 'Änderungsdatum' und 'Trapped'. Für 'Creator', 'Producer' und 'CreationDate' wurden Werte vordefiniert. Sie können entfernt werden, indem Sie sie auf setzen None.

Attach_note ( Text , PositionRect = [-100, -100, 0, 0] )

Fügen Sie der Seite eine neue Textnotiz hinzu, die als nächstes gespeichert werden soll. Das optionale positionRect gibt die Position der neuen Notiz auf der Seite an. Es befindet sich standardmäßig außerhalb der Seite, um sicherzustellen, dass es auf Ausdrucken nicht sichtbar ist.

schließen ( )

Finalisieren Sie dieses Objekt und machen Sie die zugrunde liegende Datei zu einer vollständigen PDF-Datei.

get_pagecount ( )

Gibt die aktuelle Seitenzahl in der mehrseitigen PDF-Datei zurück.

infodict ( )

Gibt ein modifizierbares Informationswörterbuchobjekt zurück (siehe PDF-Referenzabschnitt 10.2.1 „Dokumentinformationswörterbuch“).

Keep_empty

savefig ( figure = None , ** kwargs )

Speichern Sie eine Figurein dieser Datei als neue Seite.

Alle anderen Schlüsselwortargumente werden an übergeben savefig.

Parameter :

figure Figureoder int, default: die aktive Zahl

Die Abbildung oder der Index der Abbildung, die in der Datei gespeichert wird.

Klasse matplotlib.backends.backend_pdf. Referenz ( id )

Basen:object

PDF-Referenzobjekt.

Verwenden Sie PdfFile.reserveObject(), um Referenzen zu erstellen.

pdfRepr ( )

schreiben ( Inhalt , Datei )

Klasse matplotlib.backends.backend_pdf. RendererPdf ( file , image_dpi , height , width )

Basen:RendererPDFPSBase

check_gc ( gc , Füllfarbe = Keine )

draw_gouraud_triangle ( gc , Punkte , Farben , trans )

Zeichne ein Gouraud-schattiertes Dreieck.

Parameter :

ggGraphicsContextBase

Der grafische Kontext.

Punkte (3, 2) Array-artig

Array von (x, y) Punkten für das Dreieck.

Farben (3, 4) Array-artig

RGBA-Farben für jeden Punkt des Dreiecks.

verwandelnmatplotlib.transforms.Transform

Eine affine Transformation, die auf die Punkte angewendet werden soll.

draw_gouraud_triangles ( gc , points , colors , trans )

Zeichne eine Reihe von Gouraud-Dreiecken.

Parameter :

Punkte (N, 3, 2) Array-artig

Array von N (x, y) Punkten für die Dreiecke.

Farben (N, 3, 4) Array-artig

Array von N RGBA-Farben für jeden Punkt der Dreiecke.

verwandelnmatplotlib.transforms.Transform

Eine affine Transformation, die auf die Punkte angewendet werden soll.

draw_image ( gc , x , y , im , transform = None )

Zeichnen Sie ein RGBA-Bild.

Parameter :

ggGraphicsContextBase

Ein Grafikkontext mit Clipping-Informationen.

x Skalar

Der Abstand in physikalischen Einheiten (dh Punkte oder Pixel) von der linken Seite der Leinwand.

y Skalar

Der Abstand in physikalischen Einheiten (dh Punkte oder Pixel) von der unteren Seite der Leinwand.

im (N, M, 4) Array-ähnlich von np.uint8

Ein Array von RGBA-Pixeln.

verwandelnmatplotlib.transforms.Affine2DBase

Nur wenn das konkrete Backend so geschrieben ist, dass es option_scale_imagezurückgibt , kannTrue eine affine Transformation (dh ein Affine2DBase) an übergeben werden . Der Translationsvektor der Transformation wird in physikalischen Einheiten (dh Punkten oder Pixeln) angegeben. Beachten Sie, dass die Transformation x und y nicht überschreibt und angewendet werden muss, bevor das Ergebnis durch x und y übersetzt wird (dies kann erreicht werden, indem x und y zu dem durch transform definierten Übersetzungsvektor hinzugefügt werden ).draw_image

draw_markers ( gc , marker_path , marker_trans , path , trans , rgbFace = None )

Zeichnen Sie eine Markierung an jedem Scheitelpunkt von Pfad (außer Kontrollpunkten).

Die Basisimplementierung (Fallback) führt mehrere Aufrufe von draw_path. Back-Ends möchten diese Methode möglicherweise überschreiben, um die Markierung nur einmal zu zeichnen und mehrmals wiederzuverwenden.

Parameter :

ggGraphicsContextBase

Der grafische Kontext.

marker_transmatplotlib.transforms.Transform

Eine auf den Marker angewendete affine Transformation.

transmatplotlib.transforms.Transform

Eine auf den Pfad angewendete affine Transformation.

draw_mathtext ( gc , x , y , s , prop , angle )

draw_path ( gc , path , transform , rgbFace = None )

Zeichne eine PathInstanz mit der gegebenen affinen Transformation.

draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiaseds , urls , offset_position )

Zeichnen Sie eine Sammlung von Pfaden .

Jeder Pfad wird zuerst durch den entsprechenden Eintrag in all_transforms (eine Liste von (3, 3)-Matrizen) und dann durch master_transform transformiert . Sie werden dann durch den entsprechenden Eintrag in offsets übersetzt , der zuvor durch offset_trans transformiert wurde .

facecolors , edgecolors , linewidths , linestyles und antialiased sind Listen, die die entsprechenden Eigenschaften festlegen.

offset_position wird jetzt nicht verwendet, aber das Argument wird aus Gründen der Abwärtskompatibilität beibehalten.

Die Basisimplementierung (Fallback) führt mehrere Aufrufe von draw_path. Backends möchten dies möglicherweise überschreiben, um jeden Satz von Pfaddaten nur einmal zu rendern und dann diesen Pfad mehrmals mit den verschiedenen Offsets, Farben, Stilen usw. zu referenzieren. Die Generatormethoden _iter_collection_raw_pathsund _iter_collectionwerden bereitgestellt, um bei der Implementierung zu helfen (und diese zu standardisieren). über Backends hinweg. Es wird dringend empfohlen, diese Generatoren zu verwenden, damit Änderungen am Verhalten von draw_path_collectionglobal vorgenommen werden können.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None )

draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None )

Zeichnen Sie eine Textinstanz.

Parameter :

ggGraphicsContextBase

Der grafische Kontext.

x schweben

Die x-Position des Textes in Anzeigekoordinaten.

y schweben

Die y-Position der Textgrundlinie in Anzeigekoordinaten.

s -str

Die Textzeichenfolge.

Stützematplotlib.font_manager.FontProperties

Die Schrifteigenschaften.

Winkelschwimmer _

Der Drehwinkel in Grad gegen den Uhrzeigersinn.

Textmatplotlib.text.Text

Das ursprüngliche Textobjekt, das gerendert werden soll.

Anmerkungen

Hinweis für Backend-Implementierer:

Wenn Sie versuchen festzustellen, ob Sie Ihren Begrenzungsrahmen richtig gemacht haben (was das Textlayout / die Textausrichtung ermöglicht, richtig zu funktionieren), hilft es, die Zeile in text.py zu ändern:

if 0: bbox_artist(self, renderer)

zu if 1, und dann wird der eigentliche Begrenzungsrahmen zusammen mit Ihrem Text geplottet.

encode_string ( s , fonttype )

finalisieren ( )

get_image_magnification ( )

Holen Sie sich den Faktor, um den Bilder vergrößert werden sollen, die an übergeben werden draw_image. Ermöglicht einem Backend, Bilder mit einer anderen Auflösung als andere Künstler zu haben.

new_gc ( )

Gibt eine Instanz von a zurück GraphicsContextBase.

Klasse matplotlib.backends.backend_pdf. Stream ( id , len , file , extra = None , png = None )

Basen:object

PDF-Stream-Objekt.

Dies hat keine pdfRepr-Methode. Rufen Sie stattdessen begin() auf, geben Sie dann den Inhalt des Streams aus, indem Sie write() aufrufen, und rufen Sie schließlich end() auf.

Parameter :

ID int

Objekt-ID des Streams.

len Referenz oder Keine

Ein ungenutztes Referenzobjekt für die Länge des Streams; None bedeutet, dass ein Speicherpuffer verwendet wird, damit die Länge eingefügt werden kann.

Datei PdfDatei

Das zugrunde liegende Objekt, in das der Stream geschrieben werden soll.

zusätzliches Diktat von Name zu irgendetwas oder None

Zusätzliche Schlüssel-Wert-Paare, die in den Stream-Header aufgenommen werden sollen.

png dict oder None

Wenn die Daten bereits png-codiert sind, werden die Dekodierungsparameter.

compressobj

Ende ( )

Stream abschließen.

zusätzlich

Datei

ID

Länge

pdfDatei

Position

schreiben ( Daten )

Schreiben Sie einige Daten in den Stream.

Klasse matplotlib.backends.backend_pdf. Wörtlich ( x )

Basen:object

Speichern Sie wörtliche PDF-Befehlsinhalte zur späteren Aufnahme in den Stream.

pdfRepr ( )

matplotlib.backends.backend_pdf. fill ( strings , linelen = 75 )

[ Veraltet ]

Anmerkungen

Veraltet seit Version 3.6: Verwenden Sie stattdessen eine vom Anbieter bereitgestellte Kopie von _fill.

matplotlib.backends.backend_pdf. pdfRepr ( obj )

Ordnen Sie Python-Objekte der PDF-Syntax zu.