matplotlib.backends.backend_cairo

Ein Cairo-Backend für Matplotlib

Autor:

Steve Chaplin und andere

Dieses Backend hängt von cairocffi oder pycairo ab.

matplotlib.backends.backend_cairo.FigureCanvas

Alias von FigureCanvasCairo

class matplotlib.backends.backend_cairo.FigureCanvasCairo(figure=None)

Bases: FigureCanvasBase

copy_from_bbox(bbox)

get_renderer()

print_pdf(fobj, *, orientation='portrait')

print_png(fobj)

print_ps(fobj, *, orientation='portrait')

print_raw(fobj)

print_rgba(fobj)

print_svg(fobj, *, orientation='portrait')

print_svgz(fobj, *, orientation='portrait')

restore_region(region)

class matplotlib.backends.backend_cairo.GraphicsContextCairo(renderer)

Bases: GraphicsContextBase

get_antialiased()

Gibt zurück, ob das Objekt mit Kantenglättung gerendert werden soll.

get_rgb()

Gibt ein Tupel aus drei oder vier Gleitkommazahlen von 0 bis 1 zurück.

restore()

Stellt den Grafikkontext vom Stapel wieder her - nur erforderlich für Backends, die Grafikkontexte auf einem Stapel speichern.

set_alpha(alpha)

Legt den für die Mischung verwendeten Alpha-Wert fest - wird nicht von allen Backends unterstützt.

Wenn alpha=None (Standard), werden die Alpha-Komponenten der Vordergrund- und Füllfarben verwendet, um ihre jeweiligen Transparenzen einzustellen (wo zutreffend); andernfalls überschreibt alpha diese.

set_antialiased(b)

Legt fest, ob Objekte mit Kantenglättung gezeichnet werden sollen.

set_capstyle(cs)

Legt fest, wie die Endpunkte von Linien gezeichnet werden.

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clip_path(path)

Setzt den Clipping-Pfad auf einen TransformedPath oder None.

set_clip_rectangle(rectangle)

Setzt das Clipping-Rechteck auf eine Bbox oder None.

set_dashes(offset, dashes)

Setzt den Strichstil für den GC.

Parameter:

dash_offsetfloat

Der Abstand, in Punkten, innerhalb des Strichmusters, an dem das Muster beginnen soll. Wird normalerweise auf 0 gesetzt.

dash_listarray-like oder None

Die Ein/Aus-Sequenz als Punkte. None gibt eine durchgezogene Linie an. Alle Werte müssen ansonsten nicht-negativ sein (\(\ge 0\)).

Anmerkungen

Siehe S. 666 des PostScript Language Reference für weitere Informationen.

set_foreground(fg, isRGBA=None)

Setzt die Vordergrundfarbe.

Parameter:

fgFarbe

isRGBAbool

Wenn fg als Tupel (r, g, b, a) bekannt ist, kann isRGBA auf True gesetzt werden, um die Leistung zu verbessern.

set_joinstyle(js)

Legt fest, wie Verbindungen zwischen Liniensegmenten gezeichnet werden.

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_linewidth(w)

Legt die Linienstärke in Punkten fest.

class matplotlib.backends.backend_cairo.RendererCairo(dpi)

Bases: RendererBase

draw_image(gc, x, y, im)

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. Punkten oder Pixeln) angegeben. Beachten Sie, dass die Transformation x und y nicht überschreibt und angewendet werden muss, bevor das Ergebnis um x und y übersetzt wird (dies kann durch Hinzufügen von x und y zum durch transform definierten Translationsvektor erreicht werden).

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

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

Die Basis (Fallback)-Implementierung macht mehrere Aufrufe von draw_path. Backends möchten diese Methode möglicherweise überschreiben, um den Marker nur einmal zu zeichnen und ihn mehrfach 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_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_canvas_width_height()

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

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.

new_gc()

Gibt eine Instanz eines GraphicsContextBase zurück.

points_to_pixels(points)

Konvertiert Punkte in Anzeigeeinheiten.

Sie müssen diese Funktion überschreiben (es sei denn, Ihr Backend hat keinen DPI-Wert, z. B. PostScript oder SVG). Einige Bildsysteme nehmen einen bestimmten Wert für Pixel pro Zoll an.

points to pixels = points * pixels_per_inch/72 * dpi/72

Parameter:

pointsfloat oder array-ähnlich

Gibt zurück:

Punkte, konvertiert in Pixel

set_context(ctx)