backend_agg#

Un backend de geometría antigrano (AGG).

Características que se implementan:

  • capstyles y estilos de unión

  • guiones

  • ancho de línea

  • líneas, rectángulos, elipses

  • recortar a un rectángulo

  • salida a formatos de imagen compatibles con RGBA y Pillow

  • mezcla alfa

  • Escalado de DPI correctamente: todo se escala correctamente (guiones, anchos de línea, etc.)

  • dibujar polígono

  • freetype2 con fuente ft2

Todavía POR HACER:

  • integrar pantalla dpi con ppi y texto

matplotlib.backends.backend_agg. FigureCanvas [fuente] #

alias deFigureCanvasAgg

clase matplotlib.backends.backend_agg. FigureCanvasAgg ( figura = Ninguno ) [fuente] #

Bases:FigureCanvasBase

buffer_rgba ( ) [fuente] #

Obtenga la imagen como un memoryviewbúfer del renderizador.

drawdebe llamarse al menos una vez antes de que esta función funcione y para actualizar el renderizador para cualquier cambio posterior en la figura.

copy_from_bbox ( bbox ) [fuente] #
dibujar ( ) [fuente] #

Renderizar el Figure.

Este método debe recorrer el árbol del artista, incluso si no se produce ningún resultado, ya que activa el trabajo diferido al que los usuarios pueden querer acceder antes de guardar el resultado en el disco. Por ejemplo, calcular límites, límites automáticos y valores de marca.

get_renderer ( cleared=< parámetro en desuso> ) [fuente] #
print_jpeg ( filename_or_obj , * args , pil_kwargs = Ninguno ) [fuente] #

Escriba la figura en un archivo JPEG.

Parámetros :
filename_or_obj str o similar a una ruta o similar a un archivo

El archivo a escribir.

dictado de pil_kwargs , opcional

Argumentos de palabras clave adicionales que se pasan PIL.Image.Image.saveal guardar la figura.

print_jpg ( filename_or_obj , * args , pil_kwargs = Ninguno ) [fuente] #

Escriba la figura en un archivo JPEG.

Parámetros :
filename_or_obj str o similar a una ruta o similar a un archivo

El archivo a escribir.

dictado de pil_kwargs , opcional

Argumentos de palabras clave adicionales que se pasan PIL.Image.Image.saveal guardar la figura.

print_png ( filename_or_obj , * args , metadata = Ninguno , pil_kwargs = Ninguno ) [fuente] #

Escriba la figura en un archivo PNG.

Parámetros :
filename_or_obj str o similar a una ruta o similar a un archivo

El archivo a escribir.

dictado de metadatos , opcional

Metadatos en el archivo PNG como pares clave-valor de bytes o cadenas codificables latin-1. De acuerdo con la especificación PNG, las claves deben tener menos de 79 caracteres.

La especificación PNG define algunas palabras clave comunes que pueden usarse según corresponda:

  • Título: Título corto (una línea) o leyenda para la imagen.

  • Autor: Nombre del creador de la imagen.

  • Descripción: Descripción de la imagen (posiblemente larga).

  • Derechos de autor: Aviso de derechos de autor.

  • Hora de creación: hora de creación de la imagen original (generalmente en formato RFC 1123).

  • Software: Software utilizado para crear la imagen.

  • Descargo de responsabilidad: Aviso legal.

  • Advertencia: Advertencia de la naturaleza del contenido.

  • Fuente: Dispositivo utilizado para crear la imagen.

  • Comentario: comentario misceláneo; conversión de otro formato de imagen.

Se pueden inventar otras palabras clave para otros fines.

Si no se proporciona 'Software', se utilizará un valor generado automáticamente para Matplotlib. Esto se puede eliminar configurándolo en Ninguno .

Para obtener más detalles, consulte la especificación PNG .

dictado de pil_kwargs , opcional

Argumentos de palabra clave pasados ​​a PIL.Image.Image.save.

Si la clave 'pnginfo' está presente, anula completamente los metadatos , incluida la clave predeterminada de 'Software'.

print_raw ( nombre de archivo_u_obj , * argumentos ) [fuente] #
print_rgba ( nombre de archivo_u_obj , * argumentos ) [fuente] #
print_tif ( filename_or_obj , * , pil_kwargs = Ninguno ) [fuente] #

Escriba la figura en un archivo TIFF.

Parámetros :
filename_or_obj str o similar a una ruta o similar a un archivo

El archivo a escribir.

dictado de pil_kwargs , opcional

Argumentos de palabras clave adicionales que se pasan PIL.Image.Image.saveal guardar la figura.

print_tiff ( nombre de archivo_u_obj , * , pil_kwargs = Ninguno ) [fuente] #

Escriba la figura en un archivo TIFF.

Parámetros :
filename_or_obj str o similar a una ruta o similar a un archivo

El archivo a escribir.

dictado de pil_kwargs , opcional

Argumentos de palabras clave adicionales que se pasan PIL.Image.Image.saveal guardar la figura.

print_to_buffer ( ) [fuente] #
print_webp ( filename_or_obj , * , pil_kwargs = Ninguno ) [fuente] #

Escriba la figura en un archivo WebP.

Parámetros :
filename_or_obj str o similar a una ruta o similar a un archivo

El archivo a escribir.

dictado de pil_kwargs , opcional

Argumentos de palabras clave adicionales que se pasan PIL.Image.Image.saveal guardar la figura.

restore_region ( región , bbox = Ninguno , xy = Ninguno ) [fuente] #
tostring_argb ( ) [fuente] #

Obtenga la imagen como ARGB bytes.

drawdebe llamarse al menos una vez antes de que esta función funcione y para actualizar el renderizador para cualquier cambio posterior en la figura.

tostring_rgb ( ) [fuente] #

Obtenga la imagen como RGB bytes.

drawdebe llamarse al menos una vez antes de que esta función funcione y para actualizar el renderizador para cualquier cambio posterior en la figura.

clase matplotlib.backends.backend_agg. RendererAgg ( ancho , alto , ppp ) [fuente] #

Bases:RendererBase

El renderizador maneja todas las primitivas de dibujo usando una instancia de contexto de gráficos que controla los colores/estilos

buffer_rgba ( ) [fuente] #
borrar ( ) [fuente] #
draw_mathtext ( gc , x , y , s , prop , angle ) [fuente] #

Dibujar texto matemático usando matplotlib.mathtext.

dibujar_ruta ( gc , ruta , transformar , rgbFace = Ninguno ) [fuente] #

Dibuja una Pathinstancia usando la transformación afín dada.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = Ninguno ) [fuente] #
dibujar_texto ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [fuente] #

Dibuja una instancia de texto.

Parámetros :
gcGraphicsContextBase

El contexto gráfico.

x flotador

La ubicación x del texto en las coordenadas de visualización.

flotas _

La ubicación y de la línea de base del texto en las coordenadas de visualización.

calle s

La cadena de texto.

apuntalarmatplotlib.font_manager.FontProperties

Las propiedades de la fuente.

ángulo de flotación

El ángulo de rotación en grados en sentido contrario a las agujas del reloj.

textommatplotlib.text.Text

El objeto de texto original que se representará.

notas

Nota para los implementadores de back-end:

Cuando intenta determinar si ha acertado con el cuadro delimitador (que es lo que permite que el diseño/alineación del texto funcione correctamente), es útil cambiar la línea en text.py:

if 0: bbox_artist(self, renderer)

a si 1, y luego el cuadro delimitador real se trazará junto con su texto.

get_canvas_width_height ( ) [fuente] #

Devuelve el ancho y la altura del lienzo en las coordenadas de visualización.

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

Obtenga el ancho, la altura y el descenso (desplazamiento desde la parte inferior hasta la línea de base), en coordenadas de visualización, de la cadena s con prop .FontProperties

lock = < propietario del objeto _thread.RLock desbloqueado =0 cuenta=0> #
option_image_nocomposite ( ) [fuente] #

Devuelve si se debe omitir la composición de la imagen por Matplotlib.

Los backends de ráster generalmente deben devolver False (permitiendo que el rasterizador de nivel C se encargue de la composición de la imagen); los backends vectoriales generalmente deberían devolver .not rcParams["image.composite_image"]

option_scale_image ( ) [fuente] #

Devuelve si se admiten transformaciones afines arbitrarias draw_image(Verdadero para la mayoría de los backends vectoriales).

points_to_pixels ( puntos ) [fuente] #

Convierte puntos a unidades de visualización.

Debe anular esta función (a menos que su backend no tenga un dpi, por ejemplo, postscript o svg). Algunos sistemas de imágenes asumen algún valor de píxeles por pulgada:

points to pixels = points * pixels_per_inch/72 * dpi/72
Parámetros :
puntos flotantes o en forma de matriz

un flotador o una matriz numpy de flotadores

Devoluciones :
Puntos convertidos en píxeles
restore_region ( región , bbox = Ninguno , xy = Ninguno ) [fuente] #

Restaurar la región guardada. Si se proporciona bbox (instancia de BboxBase o sus extensiones), solo se restaurará la región especificada por bbox. xy (un par de flotantes) opcionalmente especifica la nueva posición (la LLC de la región original, no la LLC de bbox) donde se restaurará la región.

>>> 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 ( ) [fuente] #

Empezar a filtrar. Simplemente crea un nuevo lienzo (el anterior se guarda).

stop_filter ( post_procesamiento ) [fuente] #

Guarde la trama en el lienzo actual como una imagen y aplique la función de procesamiento posterior .

def post_procesamiento (imagen, dpi):

# ny, nx, depth = image.shape # image (matriz numpy) tiene canales RGBA y tiene una profundidad de 4. ... # crea una nueva_imagen (matriz numpy de 4 canales, el tamaño puede ser # diferente). La imagen resultante puede tener desplazamientos desde # la esquina inferior izquierda de la imagen original devuelve nueva_imagen, desplazamiento_x, desplazamiento_y

El renderizador guardado se restaura y la imagen devuelta de post_processing se traza (usando draw_image) en él.

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