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 de
FigureCanvasAgg
- classe matplotlib.backends.backend_agg. FigureCanvasAgg ( figure = Aucun ) [source] #
Socles :
FigureCanvasBase
- buffer_rgba ( ) [source] #
Obtenez l'image en tant que
memoryview
dans le tampon du moteur de rendu.draw
doit ê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.
- 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.
- 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.save
lors 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.save
lors 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_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.save
lors 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.save
lors de l'enregistrement de la figure.
- 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.save
lors de l'enregistrement 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
- 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
Path
instance à l'aide de la transformation affine donnée.
- draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [source] #
Dessinez une instance de texte.
- Paramètres :
- gc
GraphicsContextBase
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.
- soutenir
matplotlib.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.
- textmult
matplotlib.text.Text
L'objet texte d'origine à rendre.
- gc
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_image
sont 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.