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 de
FigureCanvasAgg
- clase matplotlib.backends.backend_agg. FigureCanvasAgg ( figura = Ninguno ) [fuente] #
Bases:
FigureCanvasBase
- buffer_rgba ( ) [fuente] #
Obtenga la imagen como un
memoryview
búfer del renderizador.draw
debe llamarse al menos una vez antes de que esta función funcione y para actualizar el renderizador para cualquier cambio posterior en la figura.
- 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.
- 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.save
al 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.save
al 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_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.save
al 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.save
al guardar la figura.
- 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.save
al guardar 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
- 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
Path
instancia usando la transformación afín dada.
- dibujar_texto ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [fuente] #
Dibuja una instancia de texto.
- Parámetros :
- gc
GraphicsContextBase
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.
- apuntalar
matplotlib.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.
- textom
matplotlib.text.Text
El objeto de texto original que se representará.
- gc
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.