matplotlib.backends.backend_svg

matplotlib.backends.backend_svg.FigureCanvas

alias von FigureCanvasSVG

class matplotlib.backends.backend_svg.FigureCanvasSVG(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 = {'svg': 'Scalable Vector Graphics', 'svgz': 'Scalable Vector Graphics'}

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_svg(filename, *, bbox_inches_restore=None, metadata=None)

Parameter:

filenamestr oder Pfad-ähnlich oder datei-ähnlich

Ausgabeziel; wenn ein String, wird eine Datei zum Schreiben geöffnet.

metadatadict[str, Any], optional

Metadaten in der SVG-Datei, definiert als Schlüssel-Wert-Paare von Strings, Datetimes oder Listen von Strings, z. B. {'Creator': 'Meine Software', 'Contributor': ['Ich', 'Mein Freund'], 'Title': 'Großartig'}.

Die Standard-Schlüssel und ihre Wertetypen sind

• str: 'Coverage', 'Description', 'Format', 'Identifier', 'Language', 'Relation', 'Source', 'Title' und 'Type'.

• str oder Liste von str: 'Contributor', 'Creator', 'Keywords', 'Publisher' und 'Rights'.

• str, date, datetime oder Tupel davon: 'Date'. Wenn kein str, wird es als ISO 8601 formatiert.

Werte sind für 'Creator', 'Date', 'Format' und 'Type' vordefiniert. Sie können entfernt werden, indem sie auf None gesetzt werden.

Informationen werden als Dublin Core Metadaten kodiert.

print_svgz(filename, **kwargs)

class matplotlib.backends.backend_svg.RendererSVG(width, height, svgwriter, basename=None, image_dpi=72, *, metadata=None)

Bases: RendererBase

close_group(s)

Schließt ein Gruppierungselement mit der Beschriftung s.

Wird nur vom SVG-Renderer verwendet.

draw_gouraud_triangles(gc, triangles_array, colors_array, transform)

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

Wenn und 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. Punkte oder Pixel) 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 Addition von x und y zum durch transform definierten Translationsvektor 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 Basis- (Fallback-)Implementierung ruft draw_path mehrmals auf. Backends möchten diese Methode möglicherweise überschreiben, um den Marker nur einmal zu zeichnen und ihn mehrmals mit den verschiedenen Offsets 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_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 Basis- (Fallback-)Implementierung ruft draw_path mehrmals auf. Backends möchten dies möglicherweise überschreiben, um jeden Satz von Pfaddaten nur einmal zu rendern und diesen Pfad dann mehrmals mit den unterschiedlichen Offsets, Farben, Stilen usw. zu referenzieren. Die Generator-Methoden _iter_collection_raw_paths und _iter_collection werden bereitgestellt, um bei der Implementierung (und Standardisierung) über Backends hinweg zu helfen. Es wird dringend empfohlen, diese Generatoren zu verwenden, damit Änderungen am Verhalten von draw_path_collection global vorgenommen werden können.

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.

finalize()

flipy()

Gibt zurück, ob die y-Werte von oben nach unten zunehmen.

Beachten Sie, dass dies nur das Zeichnen von Texten beeinflusst.

get_canvas_width_height()

Gibt die Breite und Höhe der Leinwand in Anzeigekoordinaten zurück.

get_image_magnification()

Faktor abrufen, um die an draw_image übergebenen Bilder zu vergrößern. Ermöglicht es einem Backend, Bilder mit einer anderen Auflösung als andere Künstler zu haben.

get_text_width_height_descent(s, prop, ismath)

Gibt die Breite, Höhe und den Abstieg (Offset von unten zur Basislinie) in Anzeigekoordinaten des Strings s mit FontProperties prop zurück.

Leerzeichen am Anfang und Ende von s sind in der gemeldeten Breite enthalten.

open_group(s, gid=None)

Öffnet ein Gruppierungselement mit der Beschriftung s und gid (falls gesetzt) als ID.

Wird nur vom SVG-Renderer verwendet.

option_image_nocomposite()

Gibt zurück, ob die Bildkomposition durch Matplotlib übersprungen werden soll.

Raster-Backends sollten normalerweise False zurückgeben (damit der C-Level-Rasterer die Bildkomposition übernimmt); Vektor-Backends sollten normalerweise not rcParams["image.composite_image"] zurückgeben.

option_scale_image()

Gibt zurück, ob beliebige affine Transformationen in draw_image unterstützt werden (True für die meisten Vektor-Backends).

class matplotlib.backends.backend_svg.XMLWriter(file)

Bases: object

Parameter:

filebeschreibbares text-ähnliches Datei-Objekt

close(id)

Schließt offene Elemente, bis zu (und einschließlich) dem durch die gegebene Kennung identifizierten Element.

Parameter:

id

Element-Kennung, wie von der start()-Methode zurückgegeben.

comment(comment)

Fügt einen Kommentar zum Ausgabe-Stream hinzu.

Parameter:

commentstr

Kommentartext.

data(text)

Fügt Zeichendaten zum Ausgabe-Stream hinzu.

Parameter:

textstr

Zeichendaten.

element(tag, text=None, attrib={}, **extra)

Fügt ein ganzes Element hinzu. Dies entspricht dem Aufruf von start(), data() und end() nacheinander. Das Argument text kann weggelassen werden.

end(tag=None, indent=True)

Schließt das aktuelle Element (geöffnet durch den letzten Aufruf von start()).

Parameter:

tag

Element-Tag. Wenn angegeben, muss das Tag mit dem Start-Tag übereinstimmen. Wenn weggelassen, wird das aktuelle Element geschlossen.

indentbool, standardmäßig: True

flush()

Spült den Ausgabe-Stream.

start(tag, attrib={}, **extra)

Öffnet ein neues Element. Attribute können als Schlüsselwortargumente oder als String/String-Dictionary angegeben werden. Die Methode gibt eine undurchsichtige Kennung zurück, die an die close()-Methode übergeben werden kann, um alle offenen Elemente bis einschließlich dieses zu schließen.

Parameter:

tag

Element-Tag.

attrib

Attribut-Dictionary. Alternativ können Attribute als Schlüsselwortargumente angegeben werden.

Gibt zurück:

Element-Kennung.