backend_agg#

Un backend de géométrie anti-grain (AGG).

Fonctionnalités implémentées :

  • styles de majuscule et styles de jointure

  • tirets

  • largeur de ligne

  • lignes, rectangles, ellipses

  • découper dans un rectangle

  • sortie aux formats d'image pris en charge par RGBA et Pillow

  • mélange alpha

  • Mise à l'échelle DPI correcte - tout est correctement mis à l'échelle (tirets, largeurs de ligne, etc.)

  • dessiner un polygone

  • freetype2 avec ft2font

A FAIRE ENCORE :

  • intégrer l'écran dpi avec ppi et texte

matplotlib.backends.backend_agg. FigureCanvas [source] #

pseudonyme deFigureCanvasAgg

classe matplotlib.backends.backend_agg. FigureCanvasAgg ( figure = Aucun ) [source] #

Socles :FigureCanvasBase

buffer_rgba ( ) [source] #

Obtenez l'image en tant que memoryviewdans le tampon du moteur de rendu.

drawdoit être appelée au moins une fois avant que cette fonction ne fonctionne et pour mettre à jour le moteur de rendu pour toute modification ultérieure de la figure.

copy_from_bbox ( bbox ) [source] #
dessiner ( ) [source] #

Rendre le Figure.

Cette méthode doit parcourir l'arborescence des artistes, même si aucune sortie n'est produite, car elle déclenche un travail différé auquel les utilisateurs peuvent souhaiter accéder avant d'enregistrer la sortie sur le disque. Par exemple, calculer des limites, des limites automatiques et des valeurs de tick.

get_renderer ( cleared =< paramètre obsolète> ) [source] #
print_jpeg ( filename_or_obj , * args , pil_kwargs = None ) [source] #

Écrivez la figure dans un fichier JPEG.

Paramètres :
filename_or_obj str ou comme un chemin ou comme un fichier

Le fichier dans lequel écrire.

pil_kwargs dict, facultatif

Arguments de mots clés supplémentaires qui sont transmis à PIL.Image.Image.savelors de l'enregistrement de la figure.

print_jpg ( filename_or_obj , * args , pil_kwargs = None ) [source] #

Écrivez la figure dans un fichier JPEG.

Paramètres :
filename_or_obj str ou comme un chemin ou comme un fichier

Le fichier dans lequel écrire.

pil_kwargs dict, facultatif

Arguments de mots clés supplémentaires qui sont transmis à PIL.Image.Image.savelors de l'enregistrement de la figure.

print_png ( filename_or_obj , * args , metadata = None , pil_kwargs = None ) [source] #

Écrivez la figure dans un fichier PNG.

Paramètres :
filename_or_obj str ou comme un chemin ou comme un fichier

Le fichier dans lequel écrire.

dict de métadonnées , facultatif

Métadonnées dans le fichier PNG sous forme de paires clé-valeur d'octets ou de chaînes encodables en latin-1. Selon la spécification PNG, les clés doivent être inférieures à 79 caractères.

La spécification PNG définit certains mots clés courants qui peuvent être utilisés selon les besoins :

  • Titre : Titre court (une ligne) ou légende de l'image.

  • Auteur : Nom du créateur de l'image.

  • Description : Description de l'image (éventuellement longue).

  • Droits d'auteur : Avis de droit d'auteur.

  • Heure de création : heure de création de l'image originale (généralement au format RFC 1123).

  • Logiciel : Logiciel utilisé pour créer l'image.

  • Avis de non-responsabilité : avis de non-responsabilité.

  • Avertissement : Avertissement sur la nature du contenu.

  • Source : appareil utilisé pour créer l'image.

  • Commentaire : commentaire divers ; conversion à partir d'un autre format d'image.

D'autres mots clés peuvent être inventés à d'autres fins.

Si 'Software' n'est pas donné, une valeur générée automatiquement pour Matplotlib sera utilisée. Cela peut être supprimé en le définissant sur Aucun .

Pour plus de détails, consultez la spécification PNG .

pil_kwargs dict, facultatif

Arguments de mot-clé passés à PIL.Image.Image.save.

Si la clé 'pnginfo' est présente, elle remplace complètement metadata , y compris la clé 'Software' par défaut.

print_raw ( filename_or_obj , * args ) [source] #
print_rgba ( filename_or_obj , * args ) [source] #
print_tif ( filename_or_obj , * , pil_kwargs = None ) [source] #

Écrivez la figure dans un fichier TIFF.

Paramètres :
filename_or_obj str ou comme un chemin ou comme un fichier

Le fichier dans lequel écrire.

pil_kwargs dict, facultatif

Arguments de mots clés supplémentaires qui sont transmis à PIL.Image.Image.savelors de l'enregistrement de la figure.

print_tiff ( filename_or_obj , * , pil_kwargs = None ) [source] #

Écrivez la figure dans un fichier TIFF.

Paramètres :
filename_or_obj str ou comme un chemin ou comme un fichier

Le fichier dans lequel écrire.

pil_kwargs dict, facultatif

Arguments de mots clés supplémentaires qui sont transmis à PIL.Image.Image.savelors de l'enregistrement de la figure.

print_to_buffer ( ) [source] #
print_webp ( filename_or_obj , * , pil_kwargs = None ) [source] #

Écrivez la figure dans un fichier WebP.

Paramètres :
filename_or_obj str ou comme un chemin ou comme un fichier

Le fichier dans lequel écrire.

pil_kwargs dict, facultatif

Arguments de mots clés supplémentaires qui sont transmis à PIL.Image.Image.savelors de l'enregistrement de la figure.

restore_region ( region , bbox = None , xy = None ) [source] #
tostring_argb ( ) [source] #

Obtenez l'image au format ARGB bytes.

drawdoit être appelée au moins une fois avant que cette fonction ne fonctionne et pour mettre à jour le moteur de rendu pour toute modification ultérieure de la figure.

tostring_rgb ( ) [source] #

Obtenez l'image au format RVB bytes.

drawdoit être appelée au moins une fois avant que cette fonction ne fonctionne et pour mettre à jour le moteur de rendu pour toute modification ultérieure de la figure.

classe matplotlib.backends.backend_agg. RendererAgg ( largeur , hauteur , dpi ) [source] #

Socles :RendererBase

Le moteur de rendu gère toutes les primitives de dessin à l'aide d'une instance de contexte graphique qui contrôle les couleurs/styles

buffer_rgba ( ) [source] #
effacer ( ) [source] #
draw_mathtext ( gc , x , y , s , prop , angle ) [source] #

Dessinez un texte mathématique à l'aide de matplotlib.mathtext.

draw_path ( gc , path , transform , rgbFace = None ) [source] #

Dessinez une Pathinstance à l'aide de la transformation affine donnée.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None ) [source] #
draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [source] #

Dessinez une instance de texte.

Paramètres :
gcGraphicsContextBase

Le contexte graphique.

x flotteur

L'emplacement x du texte dans les coordonnées d'affichage.

je flotte

L'emplacement y de la ligne de base du texte dans les coordonnées d'affichage.

s str

La chaîne de texte.

soutenirmatplotlib.font_manager.FontProperties

Les propriétés de la police.

flotteur d' angle

L'angle de rotation en degrés dans le sens inverse des aiguilles d'une montre.

textmultmatplotlib.text.Text

L'objet texte d'origine à rendre.

Remarques

Remarque pour les implémenteurs backend :

Lorsque vous essayez de déterminer si vous avez correctement défini votre cadre de délimitation (ce qui permet à la disposition/à l'alignement du texte de fonctionner correctement), il est utile de modifier la ligne dans text.py :

if 0: bbox_artist(self, renderer)

à si 1, puis la zone de délimitation réelle sera tracée avec votre texte.

get_canvas_width_height ( ) [source] #

Renvoie la largeur et la hauteur du canevas dans les coordonnées d'affichage.

get_text_width_height_descent ( s , prop , ismath ) [source] #

Obtenez la largeur, la hauteur et la descente (décalage du bas à la ligne de base), dans les coordonnées d'affichage, de la chaîne s avec prop .FontProperties

lock = <unlocked _thread.RLock object owner=0 count=0> #
option_image_nocomposite ( ) [source] #

Indique si la composition d'image par Matplotlib doit être ignorée.

Les backends raster doivent généralement renvoyer False (laissant le rastériseur de niveau C s'occuper de la composition de l'image); les backends vectoriels doivent généralement renvoyer .not rcParams["image.composite_image"]

option_scale_image ( ) [source] #

Renvoie si les transformations affines arbitraires draw_imagesont prises en charge (True pour la plupart des backends vectoriels).

points_to_pixels ( points ) [source] #

Convertissez des points en unités d'affichage.

Vous devez remplacer cette fonction (sauf si votre backend n'a pas de dpi, par exemple, postscript ou svg). Certains systèmes d'imagerie supposent une certaine valeur pour les pixels par pouce :

points to pixels = points * pixels_per_inch/72 * dpi/72
Paramètres :
les points flottent ou ressemblent à des tableaux

un float ou un tableau numpy de float

Retours :
Points convertis en pixels
restore_region ( region , bbox = None , xy = None ) [source] #

Restaurez la région enregistrée. Si bbox (instance de BboxBase, ou ses extensions) est donnée, seule la région spécifiée par bbox sera restaurée. xy (une paire de flottants) spécifie éventuellement la nouvelle position (la LLC de la région d'origine, pas la LLC de la bbox) où la région sera restaurée.

>>> region = renderer.copy_from_bbox()
>>> x1, y1, x2, y2 = region.get_extents()
>>> renderer.restore_region(region, bbox=(x1+dx, y1, x2, y2),
...                         xy=(x1-dx, y1))
start_filter ( ) [source] #

Commencez le filtrage. Il crée simplement un nouveau canevas (l'ancien est enregistré).

stop_filter ( post_processing ) [source] #

Enregistrez le tracé dans le canevas actuel en tant qu'image et appliquez la fonction post_processing .

def post_processing(image, dpi):

# ny, nx, depth = image.shape # l'image (tableau numpy) a des canaux RGBA et a une profondeur de 4. ... # crée une nouvelle_image (tableau numpy de 4 canaux, la taille peut être # différente). L'image résultante peut avoir des décalages depuis # le coin inférieur gauche de l'image d'origine return new_image, offset_x, offset_y

Le moteur de rendu enregistré est restauré et l'image renvoyée par post_processing est tracée (à l'aide de draw_image) dessus.

tostring_argb ( ) [source] #
tostring_rgb ( ) [source] #
matplotlib.backends.backend_agg. get_hinting_flag ( ) [source] #