matplotlib.backends.backend_ps

Ein PostScript-Backend, das sowohl PostScript .ps als auch .eps erzeugen kann.

matplotlib.backends.backend_ps.FigureCanvas

Alias von FigureCanvasPS

class matplotlib.backends.backend_ps.FigureCanvasPS(figure=None)

Bases: FigureCanvasBase

draw()

Rendert die Figure.

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

filetypes = {'eps': 'Encapsulated Postscript', 'ps': 'Postscript'}

fixed_dpi = 72

get_default_filetype()

Gibt das Standardformat für die Speicherabbildung zurück, wie in rcParams["savefig.format"] (Standard: 'png') angegeben.

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

print_eps(outfile, *, metadata=None, papertype=None, orientation='portrait', bbox_inches_restore=None, **kwargs)

print_ps(outfile, *, metadata=None, papertype=None, orientation='portrait', bbox_inches_restore=None, **kwargs)

class matplotlib.backends.backend_ps.RendererPS(width, height, pswriter, imagedpi=72)

Bases: RendererPDFPSBase

Der Renderer behandelt alle Zeichenprimitiven mit einer Instanz des Grafikkontexts, die die Farben/Stile steuert.

create_hatch(hatch, linewidth)

draw_gouraud_triangles(gc, points, colors, trans)

Zeichnet eine Reihe von Gouraud-Dreiecken.

Parameter:

gcGraphicsContextBase

Der Grafikkontext.

triangles_array(N, 3, 2) array-ähnlich

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

colors_array(N, 3, 4) array-ähnlich

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

transformTransform

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

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

Zeichnet ein RGBA-Bild.

Parameter:

gcGraphicsContextBase

Ein Grafikkontext mit Clipping-Informationen.

xfloat

Der Abstand in physikalischen Einheiten (d. h. Punkten oder Pixeln) vom linken Rand der Zeichenfläche.

yfloat

Der Abstand in physikalischen Einheiten (d. h. Punkten oder Pixeln) vom unteren Rand der Zeichenfläche.

im(N, M, 4) Array von numpy.uint8

Ein Array von RGBA-Pixeln.

transformAffine2DBase

Nur wenn das konkrete Backend so geschrieben ist, dass option_scale_image True zurückgibt, kann eine affine Transformation (d.h. ein Affine2DBase) an draw_image übergeben werden. Der Translationsvektor der Transformation ist in physikalischen Einheiten (d.h. Punkten oder Pixeln) angegeben. Beachten Sie, dass die Transformation x und y nicht überschreibt und vor dem Übersetzen des Ergebnisses um x und y angewendet werden muss (dies kann durch Hinzufügen von x und y zum Translationsvektor, der von transform definiert wird, erreicht werden).

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

Zeichnet eine Markierung an jeder der path-Scheitelpunkte (außer Kontrollpunkte).

Die Basisimplementierung (Fallback) macht mehrere Aufrufe von draw_path. Backends möchten dies möglicherweise überschreiben, um den Marker nur einmal zu zeichnen und ihn mehrmals mit unterschiedlichen Offsets, Farben, Stilen usw. wiederzuverwenden.

Parameter:

gcGraphicsContextBase

Der Grafikkontext.

marker_pathPath

Der Pfad für die Markierung.

marker_transTransform

Eine affine Transformation, die auf die Markierung angewendet wird.

pathPath

Die Orte, an denen die Markierungen gezeichnet werden sollen.

transTransform

Eine affine Transformation, die auf den Pfad angewendet wird.

rgbFacecolor, optional

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

Zeichnen Sie den Mathetext mit matplotlib.mathtext.

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

Zeichnet eine Path-Instanz 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)

Zeichnet 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. Anschließend werden sie durch den entsprechenden Eintrag in offsets verschoben, die zuvor durch offset_trans transformiert wurden.

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

offset_position wird jetzt nicht mehr verwendet, aber das Argument bleibt aus Kompatibilitätsgründen erhalten.

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

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

Zeichnet eine TeX-Instanz.

Parameter:

gcGraphicsContextBase

Der Grafikkontext.

xfloat

Die x-Koordinate des Textes in Anzeigekoordinaten.

yfloat

Die y-Koordinate der Textbasislinie in Anzeigekoordinaten.

sstr

Der TeX-Textstring.

propFontProperties

Die Schrifteigenschaften.

anglefloat

Der Rotationswinkel in Grad gegen den Uhrzeigersinn.

mtextText

Das ursprüngliche Textobjekt, das gerendert werden soll.

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

Zeichnet eine Textinstanz.

Parameter:

gcGraphicsContextBase

Der Grafikkontext.

xfloat

Die x-Koordinate des Textes in Anzeigekoordinaten.

yfloat

Die y-Koordinate der Textbasislinie in Anzeigekoordinaten.

sstr

Der Textstring.

propFontProperties

Die Schrifteigenschaften.

anglefloat

Der Rotationswinkel in Grad gegen den Uhrzeigersinn.

ismathbool oder "TeX"

Wenn True, verwende den mathtext-Parser.

mtextText

Das ursprüngliche Textobjekt, das gerendert werden soll.

Anmerkungen

Hinweise für Backend-Implementierer

RendererBase.draw_text unterstützt auch die Übergabe von "TeX" an den Parameter *ismath*, um TeX-Rendering zu verwenden, dies ist jedoch für tatsächliche Rendering-Backends nicht erforderlich, und viele integrierte Backends unterstützen dies nicht. Vielmehr wird TeX-Rendering von draw_tex bereitgestellt.

get_image_magnification()

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

set_color(r, g, b, store=True)

set_font(fontname, fontsize, store=True)

set_linecap(linecap, store=True)

set_linedash(offset, seq, store=True)

set_linejoin(linejoin, store=True)

set_linewidth(linewidth, store=True)

matplotlib.backends.backend_ps.get_bbox_header(lbrt, rotated=False)

[Veraltet] Gibt einen PostScript-Header-String für die angegebene Bbox lbrt=(l, b, r, t) zurück. Optional kann ein Rotationsbefehl zurückgegeben werden.

Anmerkungen

Seit Version 3.9 veraltet.

matplotlib.backends.backend_ps.gs_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)

Verwendet das pswrite- oder epswrite-Gerät von Ghostscript, um eine Datei zu destillieren. Dies ergibt kleinere Dateien ohne illegale gekapselte PostScript-Operatoren. Die Ausgabe ist Low-Level und konvertiert Text in Umrisse.

matplotlib.backends.backend_ps.pstoeps(tmpfile, bbox=None, rotated=False)

Konvertiert PostScript in gekapseltes PostScript. Die Bbox der EPS-Datei wird durch das angegebene bbox-Argument ersetzt. Wenn None, wird die ursprüngliche Bbox verwendet.

matplotlib.backends.backend_ps.xpdf_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)

Verwendet ps2pdf von Ghostscript und pdftops von xpdf/poppler, um eine Datei zu destillieren. Dies ergibt kleinere Dateien ohne illegale gekapselte PostScript-Operatoren. Dieser Destillierer wird bevorzugt und erzeugt High-Level-PostScript-Ausgabe, die Text als Text behandelt.