matplotlib.backend_bases#

Las clases base abstractas definen las primitivas que los renderizadores y los contextos gráficos deben implementar para servir como backend de Matplotlib.

RendererBase

Una clase base abstracta para manejar operaciones de dibujo/renderizado.

FigureCanvasBase

La capa de abstracción que separa los Figuredetalles específicos del back-end, como un área de dibujo de la interfaz de usuario.

GraphicsContextBase

Una clase base abstracta que proporciona color, estilos de línea, etc.

Event

La clase base para todo el manejo de eventos de Matplotlib. Clases derivadas como KeyEventy MouseEventalmacenan metadatos como teclas y botones presionados, ubicaciones x e y en píxeles y Axescoordenadas.

ShowBase

La clase base para la Showclase de cada backend interactivo; el invocable 'show' se establece en Show.__call__.

ToolContainerBase

La clase base para la clase Toolbar de cada backend interactivo.

clase matplotlib.backend_bases. CloseEvent ( nombre , lienzo , guiEvent = Ninguno ) [fuente] #

Bases:Event

Un evento desencadenado por el cierre de una figura.

clase matplotlib.backend_bases. DrawEvent ( nombre , lienzo , renderizador ) [fuente] #

Bases:Event

Un evento desencadenado por una operación de dibujo en el lienzo.

En la mayoría de los backends, las devoluciones de llamadas suscritas a este evento se activarán después de que se complete la representación, pero antes de que se actualice la pantalla. Cualquier artista adicional atraído por el renderizador del lienzo se reflejará sin una llamada explícita a blit.

Advertencia

Las llamadas canvas.drawy canvas.blitestas devoluciones de llamadas pueden no ser seguras con todos los backends y pueden causar una repetición infinita.

Un DrawEvent tiene una serie de atributos especiales además de los definidos por la Eventclase principal.

Atributos :
renderizadorRendererBase

El renderizador para el evento de sorteo.

clase matplotlib.backend_bases. Evento ( nombre , lienzo , guiEvent = Ninguno ) [fuente] #

Bases:object

Un evento de Matplotlib.

Los siguientes atributos se definen y se muestran con sus valores predeterminados. Las subclases pueden definir atributos adicionales.

Atributos :
nombre str

El nombre del evento.

lienzoFigureCanvasBase

La instancia de lienzo específica del backend que genera el evento.

guiEvent

El evento GUI que activó el evento Matplotlib.

clase matplotlib.backend_bases. FigureCanvasBase ( figura = Ninguno ) [fuente] #

Bases:object

El lienzo en el que se convierte la figura.

Atributos :
figuramatplotlib.figure.Figure

Una instancia de figura de alto nivel.

blit ( bbox = Ninguno ) [fuente] #

Blit el lienzo en bbox (lienzo completo predeterminado).

propiedad button_pick_id #
button_press_event ( x , y , button , dblclick = False , guiEvent = None ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para eventos de pulsación del botón del mouse.

Las clases derivadas de back-end deben llamar a esta función al presionar cualquier botón del mouse. ( x , y ) son las coordenadas del lienzo ((0, 0) está abajo a la izquierda). el botón y la tecla son como se definen en MouseEvent.

Este método llamará a todas las funciones conectadas al 'button_press_event' con una MouseEventinstancia.

notas

En desuso desde la versión 3.6: utilice callbacks.process('button_press_event', MouseEvent(...)) en su lugar.

button_release_event ( x , y , button , guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para eventos de liberación del botón del mouse.

Las clases derivadas de back-end deben llamar a esta función al soltar cualquier botón del mouse.

Este método llamará a todas las funciones conectadas al 'button_release_event' con una MouseEventinstancia.

Parámetros :
x flotador

Las coordenadas del lienzo donde 0=izquierda.

flotas _

Las coordenadas del lienzo donde 0=abajo.

guiEvent

El evento de interfaz de usuario nativo que generó el evento Matplotlib.

notas

En desuso desde la versión 3.6: utilice callbacks.process('button_release_event', MouseEvent(...)) en su lugar.

devoluciones de llamada de propiedad #
close_event ( guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Pase CloseEventa todas las funciones conectadas a close_event.

notas

En desuso desde la versión 3.6: utilice callbacks.process('close_event', CloseEvent(...)) en su lugar.

propiedad device_pixel_ratio #

La proporción de píxeles físicos a lógicos utilizados para el lienzo en pantalla.

De forma predeterminada, es 1, lo que significa que los píxeles físicos y lógicos tienen el mismo tamaño. Las subclases que admiten pantallas de alto DPI pueden establecer esta propiedad para indicar que dicha relación es diferente. Toda la interacción de Matplotlib, a menos que se trabaje directamente con el lienzo, permanece en píxeles lógicos.

dibujar ( * argumentos , ** kwargs ) [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.

draw_event ( procesador ) [fuente] #

[ Obsoleto ] Pase DrawEventa todas las funciones conectadas a draw_event.

notas

En desuso desde la versión 3.6: Use callbacks.process('draw_event', DrawEvent(...)) en su lugar.

draw_idle ( * argumentos , ** kwargs ) [fuente] #

Solicite que se vuelva a dibujar el widget una vez que el control regrese al bucle de eventos de la GUI.

Incluso si se draw_idleproducen varias llamadas antes de que el control vuelva al bucle de eventos de la GUI, la figura solo se representará una vez.

notas

Los backends pueden optar por anular el método e implementar su propia estrategia para evitar representaciones múltiples.

enter_notify_event ( guiEvent = Ninguno , xy = Ninguno ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para el cursor del mouse que ingresa al lienzo.

Las clases derivadas de back-end deben llamar a esta función al ingresar a canvas.

Parámetros :
guiEvent

El evento de interfaz de usuario nativo que generó el evento Matplotlib.

xy (flotante, flotante)

La ubicación de las coordenadas del puntero cuando se ingresa al lienzo.

notas

En desuso desde la versión 3.6: use callbacks.process('enter_notify_event', LocationEvent(...)) en su lugar.

eventos = ['resize_event', 'draw_event', 'key_press_event', 'key_release_event', 'button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event', 'pick_event', 'figure_enter_event', 'figure_leave_event', 'axes_enter_event' , 'axes_leave_event', 'close_event'] #
filetypes = {'eps': ' Postscript encapsulado ', 'jpeg': 'Grupo conjunto de expertos en fotografía ', 'jpg': 'Grupo conjunto de expertos en fotografía ', 'pdf': ' Formato de documento portátil', 'pgf': 'PGF código para LaTeX', 'png': ' Gráficos de red portátiles ', 'ps': 'Postscript', 'raw': 'Mapa de bits RGBA sin procesar ', 'rgba': 'Mapa de bits RGBA sin procesar ','svg': 'Gráficos vectoriales escalables ', 'svgz': 'Gráficos vectoriales escalables ', 'tif': 'Formato de archivo de imagen etiquetado ', 'tiff': 'Formato de archivo de imagen etiquetado ', 'webp': 'Formato de imagen WebP '} #
fixed_dpi = Ninguno #
flush_events ( ) [fuente] #

Vacíe los eventos de la GUI para la figura.

Los backends interactivos necesitan volver a implementar este método.

get_default_filename ( ) [fuente] #

Devuelve una cadena, que incluye la extensión, adecuada para usar como nombre de archivo predeterminado.

classmethod get_default_filetype ( ) [fuente] #

Devuelve el formato de archivo savefig predeterminado como se especifica en rcParams["savefig.format"](predeterminado: 'png').

La cadena devuelta no incluye un punto. Este método se anula en los backends que solo admiten un único tipo de archivo.

classmethod get_supported_filetypes ( ) [fuente] #

Devuelve el dictado de los formatos de archivo savefig admitidos por este backend.

classmethod get_supported_filetypes_grouped ( ) [fuente] #

Devuelve un dictado de los formatos de archivo savefig admitidos por este backend, donde las claves son un nombre de tipo de archivo, como 'Grupo conjunto de expertos en fotografía', y los valores son una lista de extensiones de nombre de archivo utilizadas para ese tipo de archivo, como ['jpg' , 'jpeg'].

get_width_height ( * , físico = Falso ) [fuente] #

Devuelve el ancho y la altura de la figura en puntos enteros o píxeles.

Cuando la figura se usa en pantallas de alto DPI (y el backend lo admite), el truncamiento a números enteros se produce después de escalar según la proporción de píxeles del dispositivo.

Parámetros :
bool físico , predeterminado: falso

Si devolver píxeles físicos verdaderos o píxeles lógicos. Los backends que admiten HiDPI pueden usar píxeles físicos, pero aun así configurar el lienzo usando su tamaño real.

Devoluciones :
ancho, alto int

El tamaño de la figura, en puntos o píxeles, según el backend.

grab_mouse ( hacha ) [fuente] #

Establezca el niño Axesque está agarrando los eventos del mouse.

Por lo general, lo llaman los propios widgets. Es un error llamar a esto si el mouse ya está agarrado por otros ejes.

inaxes ( xy ) [fuente] #

Devuelve el visible superior Axesque contiene el punto xy .

Parámetros :
xy (flotante, flotante)

(x, y) posiciones de píxeles desde la izquierda/parte inferior del lienzo.

Devoluciones :
Axeso Ninguno

Los ejes visibles superiores que contienen el punto, o Ninguno si no hay ejes en el punto.

es_ahorro ( ) [fuente] #

Muestra si el renderizador está en proceso de guardar en un archivo, en lugar de renderizar para un búfer en pantalla.

key_press_event ( clave , guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Pase KeyEventa todas las funciones conectadas a key_press_event.

notas

En desuso desde la versión 3.6: utilice callbacks.process('key_press_event', KeyEvent(...)) en su lugar.

key_release_event ( clave , guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Pase KeyEventa todas las funciones conectadas a key_release_event.

notas

En desuso desde la versión 3.6: utilice callbacks.process('key_release_event', KeyEvent(...)) en su lugar.

Leave_notify_event ( guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para el cursor del mouse que abandona el lienzo.

Las clases derivadas de back-end deben llamar a esta función al salir del lienzo.

Parámetros :
guiEvent

El evento de interfaz de usuario nativo que generó el evento Matplotlib.

notas

En desuso desde la versión 3.6: utilice callbacks.process('leave_notify_event', LocationEvent(...)) en su lugar.

manager_class [fuente] #

alias deFigureManagerBase

motion_notify_event ( x , y , guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para eventos de movimiento del mouse.

Las clases derivadas de back-end deben llamar a esta función en cualquier evento de notificación de movimiento.

Este método llamará a todas las funciones conectadas al 'motion_notify_event' con una MouseEventinstancia.

Parámetros :
x flotador

Las coordenadas del lienzo donde 0=izquierda.

flotas _

Las coordenadas del lienzo donde 0=abajo.

guiEvent

El evento de interfaz de usuario nativo que generó el evento Matplotlib.

notas

En desuso desde la versión 3.6: Use callbacks.process('motion_notify_event', MouseEvent(...)) en su lugar.

mpl_connect ( s , func ) [fuente] #

Enlace la función func al evento s .

Parámetros :
calle s

Uno de los siguientes identificadores de eventos:

  • 'button_press_event'

  • 'button_release_event'

  • 'draw_event'

  • 'key_press_event'

  • 'key_release_event'

  • 'movimiento_notificar_evento'

  • 'pick_event'

  • 'redimensionar_evento'

  • 'scroll_event'

  • 'figura_ingresar_evento',

  • 'figure_leave_event',

  • 'ejes_enter_event',

  • 'ejes_leave_event'

  • 'cerrar_evento'.

función invocable

La función de devolución de llamada que se ejecutará, que debe tener la firma:

def func(event: Event) -> Any

Para los eventos de ubicación (presionar/liberar botón y tecla), si el mouse está sobre los ejes, el inaxesatributo del evento se establecerá en Axesel evento en el que ocurre, y adicionalmente, las variables xdatay los ydataatributos se establecerán en el mouse. ubicación en coordenadas de datos. Ver KeyEvent y MouseEventpara más información.

Devoluciones :
cid

Una identificación de conexión que se puede usar con FigureCanvasBase.mpl_disconnect.

Ejemplos

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = canvas.mpl_connect('button_press_event', on_press)
mpl_disconnect ( cid ) [fuente] #

Desconecte la devolución de llamada con id cid .

Ejemplos

cid = canvas.mpl_connect('button_press_event', on_press)
# ... later
canvas.mpl_disconnect(cid)
classmethod new_manager ( figura , número ) [fuente] #

Cree un nuevo administrador de figuras para figure , usando esta clase de lienzo.

notas

Este método no debe volver a implementarse en las subclases. Si se necesita una lógica de creación de administrador personalizada, vuelva a implementarla FigureManager.create_with_canvas.

new_timer ( intervalo = Ninguno , devoluciones de llamada = Ninguno ) [fuente] #

Cree una nueva subclase específica de back-end de Timer.

Esto es útil para obtener eventos periódicos a través del bucle de eventos nativo del backend. Implementado solo para backends con GUI.

Parámetros :
intervalo int

Intervalo del temporizador en milisegundos.

lista de devoluciones de llamada [tupla [llamable, tupla, dict]]

Secuencia de (func, args, kwargs) donde será ejecutado por el temporizador cada intervalo .func(*args, **kwargs)

Devoluciones de llamada que regresan Falseo 0serán eliminadas del temporizador.

Ejemplos

>>> timer = fig.canvas.new_timer(callbacks=[(f1, (1,), {'a': 3})])
elegir ( mouseevent ) [fuente] #

[ Obsoleto ]

notas

En desuso desde la versión 3.6: use canvas.figure.pick en su lugar.

pick_event ( mouseevent , artista , ** kwargs ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para eventos de selección.

Este método será llamado por los artistas seleccionados y activará las PickEventdevoluciones de llamada de los oyentes registrados.

Tenga en cuenta que los artistas no se pueden elegir de forma predeterminada (consulte Artist.set_picker).

notas

En desuso desde la versión 3.6: utilice callbacks.process('pick_event', PickEvent(...)) en su lugar.

print_figure ( nombre de archivo , dpi = Ninguno , facecolor = Ninguno , edgecolor = Ninguno , orientación = 'retrato' , formato = Ninguno , * , bbox_inches = Ninguno , pad_inches = Ninguno , bbox_extra_artists = Ninguno , backend = Ninguno , ** kwargs ) [fuente ] #

Renderice la figura en una copia impresa. Establezca los colores de la cara y el borde del parche de la figura. Esto es útil porque algunas de las GUI tienen un fondo de color de cara de figura gris y probablemente desee anular esto en una copia impresa.

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

El archivo donde se guarda la figura.

dpi flotante, predeterminado: rcParams["savefig.dpi"](predeterminado: 'figure')

Los puntos por pulgada para guardar la figura.

color de cara o 'automático', predeterminado: rcParams["savefig.facecolor"](predeterminado: 'auto')

El color de la cara de la figura. Si es 'automático', use el color de cara de la figura actual.

edgecolor color o 'auto', predeterminado: rcParams["savefig.edgecolor"](predeterminado: 'auto')

El color del borde de la figura. Si es 'auto', use el color de borde de la figura actual.

orientación {'paisaje', 'retrato'}, por defecto: 'retrato'

Actualmente solo se aplica a la impresión PostScript.

formato str, opcional

Forzar un formato de archivo específico. Si no se proporciona, el formato se deduce de la extensión del nombre de archivo y, si falla, de rcParams["savefig.format"](predeterminado: 'png').

bbox_inches 'apretado' o Bbox, predeterminado: rcParams["savefig.bbox"](predeterminado None:)

Cuadro delimitador en pulgadas: solo se guarda la parte dada de la figura. Si está 'apretado', trate de averiguar el recuadro estrecho de la figura.

pad_inches float, predeterminado: rcParams["savefig.pad_inches"](predeterminado: 0.1)

Cantidad de relleno alrededor de la figura cuando bbox_inches es 'ajustado'.

bbox_extra_artists lista de Artist, opcional

Una lista de artistas adicionales que se considerarán cuando se calcule el bbox ajustado.

backend str, opcional

Utilice un backend no predeterminado para representar el archivo, por ejemplo, para representar un archivo png con el backend "cairo" en lugar del "agg" predeterminado, o un archivo pdf con el backend "pgf" en lugar del "pdf" predeterminado. Tenga en cuenta que el backend predeterminado normalmente es suficiente. Consulte Los backends integrados para obtener una lista de backends válidos para cada formato de archivo. Se puede hacer referencia a los backends personalizados como "módulo://...".

release_mouse ( hacha ) [fuente] #

Suelte el agarre del ratón sostenido por el hacha .Axes

Generalmente llamado por los widgets. Está bien llamar a esto incluso si ax no tiene el agarre del mouse actualmente.

required_interactive_framework = Ninguno #
cambiar el tamaño ( w , h ) [fuente] #

SIN UTILIZAR: establece el tamaño del lienzo en píxeles.

Ciertos backends pueden implementar un método similar internamente, pero esto no es un requisito de Matplotlib ni lo utiliza.

resize_event ( ) [fuente] #

[ Obsoleto ] Pase ResizeEventa todas las funciones conectadas a resize_event.

notas

En desuso desde la versión 3.6: utilice callbacks.process('resize_event', ResizeEvent(...)) en su lugar.

scroll_event ( x , y , paso , guiEvent = Ninguno ) [fuente] #

[ Obsoleto ] Procesamiento de devolución de llamada para eventos de desplazamiento.

Las clases derivadas de back-end deben llamar a esta función en cualquier evento de rueda de desplazamiento. ( x , y ) son las coordenadas del lienzo ((0, 0) está abajo a la izquierda). el botón y la tecla son como se definen en MouseEvent.

Este método llamará a todas las funciones conectadas al 'scroll_event' con una MouseEventinstancia.

notas

En desuso desde la versión 3.6: utilice callbacks.process('scroll_event', MouseEvent(...)) en su lugar.

propiedad scroll_pick_id #
set_cursor ( cursor ) [fuente] #

Establece el cursor actual.

Esto puede no tener efecto si el backend no muestra nada.

Si el backend lo requiere, este método debe desencadenar una actualización en el bucle de eventos del backend después de que se establezca el cursor, ya que este método puede llamarse, por ejemplo, antes de una tarea de ejecución prolongada durante la cual la GUI no se actualiza.

Parámetros :
cursorCursors

El cursor para mostrar sobre el lienzo. Nota: algunos backends pueden cambiar el cursor de toda la ventana.

start_event_loop ( tiempo de espera = 0 ) [fuente] #

Inicie un bucle de eventos de bloqueo.

Este bucle de eventos es utilizado por funciones interactivas, como ginputy waitforbuttonpress, para esperar eventos.

El bucle de eventos se bloquea hasta que se activa una función de devolución de llamada stop_event_loopo se alcanza el tiempo de espera.

Si el tiempo de espera es 0 o negativo, nunca se agota el tiempo.

Solo los backends interactivos necesitan volver a implementar este método y depende de flush_eventsque se implemente correctamente.

Los backends interactivos deberían implementar esto de una manera más nativa.

stop_event_loop ( ) [fuente] #

Detener el bucle de eventos de bloqueo actual.

Los backends interactivos necesitan volver a implementar esto para que coincida start_event_loop

support_blit = Falso #
switch_backends ( FigureCanvasClass ) [fuente] #

Crea una instancia de FigureCanvasClass

Esto se usa para la conmutación de back-end, por ejemplo, para instanciar un FigureCanvasPS desde un FigureCanvasGTK. Tenga en cuenta que la copia profunda no se realiza, por lo que cualquier cambio en una de las instancias (por ejemplo, establecer el tamaño de la figura o los accesorios de línea) se reflejará en la otra.

clase matplotlib.backend_bases. FigureManagerBase ( lienzo , número ) [fuente] #

Bases:object

Una abstracción independiente del back-end de un controlador y contenedor de figuras.

Pyplot utiliza el administrador de figuras para interactuar con la ventana de forma independiente al backend. Es un adaptador para el marco real (GUI) que representa la figura visual en la pantalla.

Los backends de la GUI se definen a partir de esta clase para traducir operaciones comunes, como mostrar o cambiar el tamaño , al código específico de la GUI. Los backends que no son GUI no admiten estas operaciones y solo pueden usar la clase base.

Se puede acceder a las siguientes operaciones básicas:

Operaciones de ventana

Manejo de pulsaciones de teclas y botones del ratón

El administrador de figuras configura el manejo predeterminado de pulsaciones de teclas y botones del mouse conectando el key_press_handlersistema de eventos matplotlib. Esto garantiza los mismos accesos directos y acciones del mouse en todos los backends.

Otras operaciones

Las subclases tendrán atributos y funciones adicionales para acceder a funciones adicionales. Por supuesto, esto es específico del backend. Por ejemplo, la mayoría de los backends de GUI tienen atributos windowque toolbardan acceso a los widgets de GUI nativos del marco respectivo.

Atributos :
lienzoFigureCanvasBase

La instancia de lienzo específica del backend.

número int o str

El número de figura.

key_press_handler_id int

El controlador de claves predeterminado cid, cuando se utiliza el administrador de herramientas. Para deshabilitar el uso predeterminado de manejo de pulsaciones de teclas:

figure.canvas.mpl_disconnect(
    figure.canvas.manager.key_press_handler_id)
button_press_handler_id int

El controlador de botón del mouse predeterminado cid, cuando se usa el administrador de herramientas. Para deshabilitar el botón predeterminado presione el uso de manejo:

figure.canvas.mpl_disconnect(
    figure.canvas.manager.button_press_handler_id)
classmethod create_with_canvas ( canvas_class , figure , num ) [fuente] #

Cree un administrador para una figura dada usando un canvas_class específico .

Los backends deben anular este método si tienen necesidades específicas para configurar el lienzo o el administrador.

destruir ( ) [fuente] #
full_screen_toggle ( ) [fuente] #
get_window_title ( ) [fuente] #

Devuelve el texto del título de la ventana que contiene la figura, o Ninguno si no hay ventana (p. ej., un servidor PS).

cambiar el tamaño ( w , h ) [fuente] #

Para backends de GUI, cambie el tamaño de la ventana (en píxeles físicos).

set_window_title ( título ) [fuente] #

Establece el texto del título de la ventana que contiene la figura.

Esto no tiene efecto para backends que no son GUI (por ejemplo, PS).

mostrar ( ) [fuente] #

Para backends de GUI, muestre la ventana de la figura y vuelva a dibujar. Para backends que no sean GUI, genere una excepción, a menos que se ejecute sin interfaz gráfica (es decir, en Linux con una PANTALLA no configurada); esta excepción se convierte en una advertencia en Figure.show.

clase matplotlib.backend_bases. GraphicsContextBase [fuente] #

Bases:object

Una clase base abstracta que proporciona color, estilos de línea, etc.

copy_properties ( gc ) [fuente] #

Copie las propiedades de gc a self.

get_alpha ( ) [fuente] #

Devuelve el valor alfa utilizado para la combinación; no se admite en todos los backends.

get_antialiased ( ) [fuente] #

Devuelve si el objeto debe intentar realizar una representación suavizada.

get_capstyle ( ) [fuente] #

Devuelve el CapStyle.

get_clip_path ( ) [fuente] #

Devuelve la ruta del clip en el formulario (ruta, transformación), donde la ruta es una Pathinstancia y la transformación es una transformación afín para aplicar a la ruta antes del recorte.

get_clip_rectangle ( ) [fuente] #

Devuelve el rectángulo de recorte como una Bboxinstancia.

get_dashes ( ) [fuente] #

Devuelve el estilo de guión como un par (desplazamiento, lista de guiones).

Ver set_dashespara más detalles.

El valor predeterminado es (Ninguno, Ninguno).

get_forced_alpha ( ) [fuente] #

Devuelve si el valor dado por get_alpha() debe usarse para anular cualquier otro valor de canal alfa.

get_gid ( ) [fuente] #

Devuelve el identificador de objeto si se establece uno, ninguno de lo contrario.

get_hatch ( ) [fuente] #

Obtenga el estilo de sombreado actual.

get_hatch_color ( ) [fuente] #

Consigue el color de la escotilla.

get_hatch_linewidth ( ) [fuente] #

Obtenga el ancho de línea de la escotilla.

get_hatch_path ( densidad = 6.0 ) [fuente] #

Devuelve a Pathpara la escotilla actual.

get_joinstyle ( ) [fuente] #

Devuelve el JoinStyle.

get_linewidth ( ) [fuente] #

Devuelve el ancho de línea en puntos.

get_rgb ( ) [fuente] #

Devuelve una tupla de tres o cuatro flotantes de 0-1.

get_sketch_params ( ) [fuente] #

Devuelve los parámetros del boceto para el artista.

Devoluciones :
tupla oNone

Una tupla de 3 con los siguientes elementos:

  • scale: La amplitud de la ondulación perpendicular a la línea fuente.

  • length: La longitud de la ondulación a lo largo de la línea.

  • randomness: El factor de escala por el cual la longitud se contrae o se expande.

Puede regresar Nonesi no se establecieron parámetros de boceto.

get_snap ( ) [fuente] #

Devuelve la configuración de ajuste, que puede ser:

  • Verdadero: ajuste los vértices al centro de píxeles más cercano

  • Falso: deja los vértices como están

  • Ninguno: (automático) si la ruta contiene solo segmentos de línea rectilíneos, redondea al centro de píxel más cercano

get_url ( ) [fuente] #

Devuelve una url si se establece una, ninguna de lo contrario.

restaurar ( ) [fuente] #

Restaure el contexto de gráficos de la pila: solo se necesita para backends que guardan contextos de gráficos en una pila.

set_alpha ( alfa ) [fuente] #

Establezca el valor alfa utilizado para la combinación; no se admite en todos los backends.

Si alpha=None(predeterminado), los componentes alfa de los colores de primer plano y de relleno se utilizarán para establecer sus transparencias respectivas (cuando corresponda); de lo contrario, alphalos anulará.

set_antialiased ( b ) [fuente] #

Establezca si el objeto debe dibujarse con representación suavizada.

set_capstyle ( cs ) [fuente] #

Establezca cómo dibujar los puntos finales de las líneas.

Parámetros :
cs CapStyleo {'trasero', 'proyectando', 'redondo'}
set_clip_path ( ruta ) [fuente] #

Establezca la ruta del clip en a TransformedPatho en Ninguno.

set_clip_rectangle ( rectángulo ) [fuente] #

Establezca el rectángulo de recorte en a Bboxo en Ninguno.

set_dashes ( dash_offset , dash_list ) [fuente] #

Establezca el estilo de guión para el gc.

Parámetros :
flotador dash_offset

Distancia, en puntos, en el patrón de guiones en el que se inicia el patrón. Por lo general, se establece en 0.

dash_list similar a una matriz o Ninguno

La secuencia de encendido y apagado como puntos. Ninguno especifica una línea sólida. De lo contrario, todos los valores deben ser no negativos (\(\ge 0\)).

notas

Ver pág. 666 de la Referencia del lenguaje PostScript para obtener más información.

set_foreground ( fg , isRGBA = False ) [fuente] #

Establezca el color de primer plano.

Parámetros :
color _
esRGBA booleano

Si se sabe que fg es una tupla, isRGBA se puede establecer en True para mejorar el rendimiento.(r, g, b, a)

set_gid ( id ) [fuente] #

Establezca la identificación.

set_hatch ( escotilla ) [fuente] #

Configure el estilo de sombreado (para rellenos).

set_hatch_color ( hatch_color ) [fuente] #

Establece el color del sombreado.

set_joinstyle ( js ) [fuente] #

Establezca cómo dibujar conexiones entre segmentos de línea.

Parámetros :
js JoinStyleo {'inglete', 'redondo', 'bisel'}
set_linewidth ( w ) [fuente] #

Establezca el ancho de línea en puntos.

set_sketch_params ( escala = Ninguno , longitud = Ninguno , aleatoriedad = Ninguno ) [fuente] #

Establezca los parámetros del boceto.

Parámetros :
flotador de escala , opcional

La amplitud de la ondulación perpendicular a la línea de origen, en píxeles. Si la escala es None, o no se proporciona, no se proporcionará ningún filtro de croquis.

longitud flotante, por defecto: 128

La longitud de la ondulación a lo largo de la línea, en píxeles.

flotante de aleatoriedad , predeterminado: 16

El factor de escala por el cual la longitud se contrae o se expande.

set_snap ( complemento ) [fuente] #

Establezca la configuración de complemento que puede ser:

  • Verdadero: ajuste los vértices al centro de píxeles más cercano

  • Falso: deja los vértices como están

  • Ninguno: (automático) si la ruta contiene solo segmentos de línea rectilíneos, redondea al centro de píxel más cercano

set_url ( url ) [fuente] #

Establezca la URL para enlaces en backends compatibles.

clase matplotlib.backend_bases. KeyEvent ( nombre , lienzo , clave , x = 0 , y = 0 , guiEvent = Ninguno ) [fuente] #

Bases:LocationEvent

Un evento clave (pulsación de tecla, liberación de tecla).

Un KeyEvent tiene una serie de atributos especiales además de los definidos por el padre Eventy las LocationEventclases.

notas

Las teclas modificadoras se antepondrán a la tecla presionada y estarán en el orden "ctrl", "alt", "super". La excepción a esta regla es cuando la tecla presionada es en sí misma una tecla modificadora, por lo tanto, "ctrl+alt" y "alt+control" pueden ser valores de tecla válidos.

Ejemplos

def on_key(event):
    print('you pressed', event.key, event.xdata, event.ydata)

cid = fig.canvas.mpl_connect('key_press_event', on_key)
Atributos :
clave Ninguno o str

La(s) tecla(s) presionada(s). Podría ser None , un solo carácter Unicode sensible a mayúsculas y minúsculas ("g", "G", "#", etc.), una tecla especial ("control", "shift", "f1", "up", etc.) o una combinación de las anteriores (p. ej., "ctrl+alt+g", "ctrl+alt+G").

clase matplotlib.backend_bases. LocationEvent ( nombre , lienzo , x , y , guiEvent = Ninguno ) [fuente] #

Bases:Event

Un evento que tiene una ubicación en la pantalla.

Un LocationEvent tiene una serie de atributos especiales además de los definidos por la Eventclase principal.

Atributos :
x, y int o Ninguno

Ubicación del evento en píxeles desde la parte inferior izquierda del lienzo.

inaxes Axeso ninguno

La Axesinstancia sobre la que se encuentra el mouse, si corresponde.

xdata, ydata flotante o Ninguno

Coordenadas de datos del mouse dentro de inaxes , o None si el mouse no está sobre un Axes.

último evento = Ninguno #
clase matplotlib.backend_bases. MouseButton ( valor ) [fuente] #

Bases:IntEnum

Una enumeración.

VOLVER = 8 [fuente] #
ADELANTE = 9 [fuente] #
IZQUIERDA = 1 [fuente] #
MEDIO = 2 [fuente] #
DERECHO = 3 [fuente] #
clase matplotlib.backend_bases. MouseEvent ( name , canvas , x , y , button = None , key = None , step = 0 , dblclick = False , guiEvent = None ) [fuente] #

Bases:LocationEvent

Un evento del mouse ('button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event').

Un MouseEvent tiene una serie de atributos especiales además de los definidos por el padre Eventy las LocationEventclases.

Ejemplos

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = fig.canvas.mpl_connect('button_press_event', on_press)
Atributos :
botón Ninguno o MouseButtono {'arriba', 'abajo'}

El botón presionado. 'arriba' y 'abajo' se utilizan para eventos de desplazamiento.

Tenga en cuenta que IZQUIERDO y DERECHO en realidad se refieren a los botones "primario" y "secundario", es decir, si el usuario invierte los botones izquierdo y derecho ("configuración para zurdos"), el botón IZQUIERDO será el que está físicamente a la derecha.

Si no está configurado, el nombre es "scroll_event" y el paso es distinto de cero, entonces se configurará como "arriba" o "abajo" según el signo del paso .

clave Ninguno o str

La tecla presionada cuando se activó el evento del mouse, por ejemplo, 'shift'. ver KeyEvent_

Advertencia

Esta clave se obtiene actualmente del último 'key_press_event' o 'key_release_event' que ocurrió dentro del lienzo. Por lo tanto, si el último cambio de estado del teclado ocurrió mientras el lienzo no tenía foco, este atributo será incorrecto.

paso flotador

El número de pasos de desplazamiento (positivo para 'arriba', negativo para 'abajo'). Esto se aplica solo a 'scroll_event' y, de lo contrario, el valor predeterminado es 0.

dblclick booleano

Si el evento es un doble clic. Esto se aplica solo a 'button_press_event' y es falso en caso contrario. En particular, no se usa en 'button_release_event'.

clase matplotlib.backend_bases. NavigationToolbar2 ( lienzo ) [fuente] #

Bases:object

Clase base para el cursor de navegación, versión 2.

Los backends deben implementar un lienzo que maneje las conexiones para 'button_press_event' y 'button_release_event'. Consulte FigureCanvasBase.mpl_connect()para obtener más información.

También deben definir

save_figure()

guardar la figura actual

draw_rubberband()(opcional)

dibuja el zoom para rectificar el rectángulo de "banda elástica"

set_message()(opcional)

mostrar mensaje

set_history_buttons()(opcional)

puede cambiar los botones de avance/retroceso del historial para indicar el estado deshabilitado/habilitado.

y anular __init__para configurar la barra de herramientas, sin olvidar llamar a la clase base init. Por lo general, __init__necesita configurar los botones de la barra de herramientas conectados a los métodos home, back, forward, pan, zoomy save_figurey usar íconos estándar en el subdirectorio "imágenes" de la ruta de datos.

¡Eso es todo, nosotros haremos el resto!

atrás ( * argumentos ) [fuente] #

Vuelva a subir en la pila de límites de vista.

Para la conveniencia de estar conectado directamente como una devolución de llamada de GUI, que a menudo pasa parámetros adicionales, este método acepta parámetros arbitrarios, pero no los usa.

configure_subplots ( * argumentos ) [fuente] #
drag_pan ( evento ) [fuente] #

Devolución de llamada para arrastrar en modo pan/zoom.

drag_zoom ( evento ) [fuente] #

Devolución de llamada para arrastrar en modo zoom.

draw_rubberband ( evento , x0 , y0 , x1 , y1 ) [fuente] #

Dibuje una banda elástica rectangular para indicar los límites de zoom.

Tenga en cuenta que no se garantiza que y .x0 <= x1y0 <= y1

adelante ( * argumentos ) [fuente] #

Avanzar en la vista de la pila de límites.

Para la conveniencia de estar conectado directamente como una devolución de llamada de GUI, que a menudo pasa parámetros adicionales, este método acepta parámetros arbitrarios, pero no los usa.

inicio ( * argumentos ) [fuente] #

Restaurar la vista original.

Para la conveniencia de estar conectado directamente como una devolución de llamada de GUI, que a menudo pasa parámetros adicionales, este método acepta parámetros arbitrarios, pero no los usa.

mouse_move ( evento ) [fuente] #
pan ( * argumentos ) [fuente] #

Alterne la herramienta de panorámica/zoom.

Panorámica con el botón izquierdo, zoom con el derecho.

press_pan ( evento ) [fuente] #

Devolución de llamada para presionar el botón del mouse en el modo de panorámica/zoom.

press_zoom ( evento ) [fuente] #

Devolución de llamada para presionar el botón del mouse en modo zoom para rect.

push_current ( ) [fuente] #

Empuje los límites de vista actuales y la posición en la pila.

release_pan ( evento ) [fuente] #

Devolución de llamada para soltar el botón del mouse en modo pan/zoom.

release_zoom ( evento ) [fuente] #

Devolución de llamada para soltar el botón del mouse en el modo zoom to rect.

remove_rubberband ( ) [fuente] #

Retire la banda de goma.

save_figure ( * argumentos ) [fuente] #

Guarda la figura actual.

set_cursor ( cursor ) [fuente] #

[ Obsoleto ] Establece el cursor actual en uno de los Cursorsvalores enumerados.

Si el backend lo requiere, este método debe desencadenar una actualización en el bucle de eventos del backend después de que se establezca el cursor, ya que este método puede llamarse, por ejemplo, antes de una tarea de ejecución prolongada durante la cual la GUI no se actualiza.

notas

En desuso desde la versión 3.5: Usar FigureCanvasBase.set_cursoren su lugar.

set_history_buttons ( ) [fuente] #

Habilite o deshabilite el botón de avance/retroceso.

set_message ( s ) [fuente] #

Muestra un mensaje en la barra de herramientas o en la barra de estado.

toolitems = (('Inicio', 'Restablecer vista original ', 'inicio', 'inicio'), ('Atrás', 'Volver a la vista anterior ', 'atrás', 'atrás'), ('Adelante', ' Avanzar a la siguiente vista', 'adelante', 'adelante'), (Ninguno, Ninguno, Ninguno, Ninguno), ('Panorámica', 'El botón izquierdo se desplaza, el botón derecho hace zoom\nx/y fija el eje, CTRL fija el aspecto', 'mover', 'panear'),('Zoom', 'Zoom al rectángulo\nx/y corrige el eje', 'zoom_to_rect', 'zoom'), ('Subplots', 'Configure subplots ', 'subplots' , 'configure_subplots'), (Ninguno, Ninguno, Ninguno, Ninguno), ('Guardar', 'Guardar el figura', 'archivo guardado', 'guardar_figura')) #
actualizar ( ) [fuente] #

Reinicie la pila de ejes.

zoom ( * argumentos ) [fuente] #
excepción matplotlib.backend_bases. NonGuiException [fuente] #

Bases:Exception

Se genera al intentar mostrar una figura en un backend que no es GUI.

clase matplotlib.backend_bases. PickEvent ( name , canvas , mouseevent , artist , guiEvent = None , ** kwargs ) [fuente] #

Bases:Event

Un evento de elección.

Este evento se activa cuando el usuario elige una ubicación en el lienzo lo suficientemente cerca de un artista que se ha hecho seleccionable con Artist.set_picker.

Un PickEvent tiene una serie de atributos especiales además de los definidos por la Eventclase principal.

Ejemplos

Vincule una función on_pick()para seleccionar eventos, que imprima las coordenadas del punto de datos seleccionado:

ax.plot(np.rand(100), 'o', picker=5)  # 5 points tolerance

def on_pick(event):
    line = event.artist
    xdata, ydata = line.get_data()
    ind = event.ind
    print('on pick line:', np.array([xdata[ind], ydata[ind]]).T)

cid = fig.canvas.mpl_connect('pick_event', on_pick)
Atributos :
evento del ratónMouseEvent

El evento del mouse que generó la elección.

artistamatplotlib.artist.Artist

El artista elegido. Tenga en cuenta que los artistas no se pueden elegir de forma predeterminada (consulte Artist.set_picker).

otro

Pueden estar presentes atributos adicionales según el tipo de objeto elegido; por ejemplo, una Line2Dselección puede definir diferentes atributos adicionales que una PatchCollectionselección.

clase matplotlib.backend_bases. RendererBase [fuente] #

Bases:object

Una clase base abstracta para manejar operaciones de dibujo/renderizado.

Los siguientes métodos deben implementarse en el backend para obtener una funcionalidad completa (aunque solo implementarlo draw_pathdaría un backend altamente capaz):

Los siguientes métodos deben implementarse en el backend por razones de optimización:

close_group ( s ) [fuente] #

Cierre un elemento de agrupación con la etiqueta s .

Solo lo utiliza el renderizador SVG.

draw_gouraud_triangle ( gc , puntos , colores , transformar ) [fuente] #

Dibuja un triángulo sombreado de Gouraud.

Parámetros :
gcGraphicsContextBase

El contexto gráfico.

puntos (3, 2) en forma de matriz

Matriz de (x, y) puntos para el triángulo.

colores (3, 4) en forma de matriz

Colores RGBA para cada punto del triángulo.

transformarmatplotlib.transforms.Transform

Una transformación afín para aplicar a los puntos.

draw_gouraud_triangles ( gc , Triangles_array , colors_array , transform ) [fuente] #

Dibuja una serie de triángulos de Gouraud.

Parámetros :
puntos (N, 3, 2) en forma de matriz

Matriz de N (x, y) puntos para los triángulos.

colores (N, 3, 4) en forma de matriz

Matriz de N colores RGBA para cada punto de los triángulos.

transformarmatplotlib.transforms.Transform

Una transformación afín para aplicar a los puntos.

draw_image ( gc , x , y , im , transform = None ) [fuente] #

Dibujar una imagen RGBA.

Parámetros :
gcGraphicsContextBase

Un contexto gráfico con información de recorte.

x escalar

La distancia en unidades físicas (es decir, puntos o píxeles) desde el lado izquierdo del lienzo.

y escalar

La distancia en unidades físicas (es decir, puntos o píxeles) desde la parte inferior del lienzo.

im (N, M, 4) como una matriz de np.uint8

Una matriz de píxeles RGBA.

transformarmatplotlib.transforms.Affine2DBase

Si y solo si el backend concreto se escribe de tal forma que option_scale_imagedevuelve , se puede pasar Trueuna transformación afín (es decir, an Affine2DBase) a . El vector de traducción de la transformación se da en unidades físicas (es decir, puntos o píxeles). Tenga en cuenta que la transformación no anula x e y , y debe aplicarse antes de traducir el resultado por x e y (esto se puede lograr agregando x e y al vector de traducción definido por transform ).draw_image

dibujar_marcadores ( gc , marcador_ruta , marcador_trans , ruta , trans , rgbFace = Ninguno ) [fuente] #

Dibuja un marcador en cada uno de los vértices de la ruta (excluyendo los puntos de control).

La implementación base (alternativa) realiza varias llamadas a draw_path. Es posible que los backends deseen anular este método para dibujar el marcador solo una vez y reutilizarlo varias veces.

Parámetros :
gcGraphicsContextBase

El contexto gráfico.

marcador_transmatplotlib.transforms.Transform

Una transformación afín aplicada al marcador.

transmatplotlib.transforms.Transform

Una transformación afín aplicada a la ruta.

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

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

draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiased , urls , offset_position ) [fuente] #

Dibuja una colección de caminos .

Cada ruta se transforma primero por la entrada correspondiente en all_transforms (una lista de (3, 3) matrices) y luego por master_transform . Luego se traducen por la entrada correspondiente en compensaciones , que primero ha sido transformada por compensaciones_trans .

facecolors , edgecolors , linewidths , linestyles y antialiased son listas que establecen las propiedades correspondientes.

offset_position no se usa ahora, pero el argumento se mantiene por compatibilidad con versiones anteriores.

La implementación base (alternativa) realiza varias llamadas a draw_path. Es posible que los backends deseen anular esto para representar cada conjunto de datos de ruta solo una vez y luego hacer referencia a esa ruta varias veces con los diferentes desplazamientos, colores, estilos, etc. Los métodos del generador _iter_collection_raw_pathsse _iter_collectionproporcionan para ayudar con (y estandarizar) la implementación a través de backends. Se recomienda encarecidamente usar esos generadores, para que los cambios en el comportamiento draw_path_collectionse puedan realizar globalmente.

draw_quad_mesh ( gc , master_transform , meshWidth , meshHeight , coordenadas , compensaciones , offsetTrans , facecolors , antialiased , edgecolors ) [fuente] #

Dibuja una malla cuádruple.

La implementación base (alternativa) convierte el quadmesh en rutas y luego llama a draw_path_collection.

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.

flipy ( ) [fuente] #

Devuelve si los valores de y aumentan de arriba hacia abajo.

Tenga en cuenta que esto solo afecta el dibujo de textos.

get_canvas_width_height ( ) [fuente] #

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

get_image_magnification ( ) [fuente] #

Obtener el factor por el cual ampliar las imágenes pasadas a draw_image. Permite que un backend tenga imágenes a una resolución diferente a la de otros artistas.

get_texmanager ( ) [fuente] #

Devolver la TexManagerinstancia.

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

new_gc ( ) [fuente] #

Devolver una instancia de un GraphicsContextBase.

grupo_abierto ( s , gid = Ninguno ) [fuente] #

Abra un elemento de agrupación con etiquetas y gid ( si está configurado) como id.

Solo lo utiliza el renderizador SVG.

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

Cambie a un renderizador temporal para efectos de filtrado de imágenes.

Actualmente solo es compatible con el renderizador agregado.

start_rasterizing ( ) [fuente] #

Cambie al renderizador ráster.

Usado por MixedModeRenderer.

stop_filter ( filter_func ) [fuente] #

Vuelva al renderizador original. El contenido del renderizador temporal se procesa con filter_func y se dibuja en el renderizador original como una imagen.

Actualmente solo es compatible con el renderizador agregado.

stop_rasterizing ( ) [fuente] #

Vuelva al renderizador vectorial y dibuje el contenido del renderizador ráster como una imagen en el renderizador vectorial.

Usado por MixedModeRenderer.

clase matplotlib.backend_bases. ResizeEvent ( nombre , lienzo ) [fuente] #

Bases:Event

Un evento desencadenado por un cambio de tamaño del lienzo.

Un ResizeEvent tiene una serie de atributos especiales además de los definidos por la Eventclase principal.

Atributos :
ancho int

Ancho del lienzo en píxeles.

altura interna

Altura del lienzo en píxeles.

clase matplotlib.backend_bases. ShowBase [fuente] #

Bases:_Backend

Clase base simple para generar una show()función en backends.

La subclase debe anular el mainloop()método.

clase matplotlib.backend_bases. TimerBase ( intervalo = Ninguno , devoluciones de llamada = Ninguno ) [fuente] #

Bases:object

Una clase base para proporcionar eventos de temporizador, útil para animaciones de cosas. Los backends deben implementar algunos métodos específicos para usar sus propios mecanismos de temporización para que los eventos del temporizador se integren en sus bucles de eventos.

Las subclases deben anular los siguientes métodos:

  • _timer_start: código específico de backend para iniciar el temporizador.

  • _timer_stop: código específico del servidor para detener el temporizador.

Las subclases también pueden anular los siguientes métodos:

  • _timer_set_single_shot: Código para configurar el temporizador en el modo de operación de un solo disparo, si el objeto del temporizador lo admite. De lo contrario, la Timer clase misma almacenará el indicador y el _on_timermétodo debe anularse para admitir dicho comportamiento.

  • _timer_set_interval: código para establecer el intervalo en el temporizador, si existe un método para hacerlo en el objeto del temporizador.

  • _on_timer: la función interna a la que debe llamar cualquier objeto de temporizador, que se encargará de la tarea de ejecutar todas las devoluciones de llamada que se hayan establecido.

Parámetros :
intervalo int, por defecto: 1000ms

El tiempo entre los eventos del temporizador en milisegundos. Se almacenará como timer.interval.

lista de devoluciones de llamada [tupla [llamable, tupla, dict]]

Lista de tuplas (func, args, kwargs) a las que se llamará en los eventos del temporizador. Esta lista es accesible como timer.callbacksy se puede manipular directamente, o se pueden utilizar las funciones add_callbacky .remove_callback

add_callback ( función , * argumentos , ** kwargs ) [fuente] #

Registre la función para que la llame el temporizador cuando se active el evento. Cualquier argumento adicional proporcionado se pasará a func .

Esta función devuelve func , lo que hace posible usarla como decorador.

intervalo de propiedad #

El tiempo entre los eventos del temporizador, en milisegundos.

remove_callback ( función , * argumentos , ** kwargs ) [fuente] #

Eliminar función de la lista de devoluciones de llamada.

args y kwargs son opcionales y se usan para distinguir entre copias de la misma función registradas para ser llamadas con diferentes argumentos. Este comportamiento está en desuso. En el futuro, ya no se considerará; para mantener una devolución de llamada específica removible por sí misma, pásela a como un objeto.*args, **kwargsadd_callbackfunctools.partial

propiedad single_shot #

Si este temporizador debe detenerse después de una sola ejecución.

inicio ( intervalo = Ninguno ) [fuente] #

Inicie el objeto temporizador.

Parámetros :
intervalo int, opcional

Intervalo del temporizador en milisegundos; anula un intervalo establecido previamente, si se proporciona.

detener ( ) [fuente] #

Detener el temporizador.

clase matplotlib.backend_bases. ToolContainerBase ( administrador de herramientas ) [fuente] #

Bases:object

Clase base para todos los contenedores de herramientas, por ejemplo, barras de herramientas.

Atributos :
administrador de herramientasToolManager

Las herramientas con las que este ToolContainerquiere comunicarse.

add_tool ( herramienta , grupo , posición = -1 ) [fuente] #

Agregue una herramienta a este contenedor.

Parámetros :
herramienta similar a una herramienta

La herramienta para agregar, consulte ToolManager.get_tool.

calle de grupo

El nombre del grupo al que se agregará esta herramienta.

posición int, por defecto: -1

La posición dentro del grupo para colocar esta herramienta.

add_toolitem ( nombre , grupo , posición , imagen , descripción , alternar ) [fuente] #

Agregue un elemento de herramienta al contenedor.

Este método debe implementarse por backend.

La devolución de llamada asociada con el evento de clic de botón debe ser exactamente self.trigger_tool(name) .

Parámetros :
nombre str

Nombre de la herramienta a agregar, esto se usa como ID de la herramienta y como etiqueta predeterminada de los botones.

calle de grupo

Nombre del grupo al que pertenece esta herramienta.

posición interna

Posición de la herramienta dentro de su grupo, si -1 va al final.

cadena de imagen

Nombre de archivo de la imagen para el botón o None.

descripción str

Descripción de la herramienta, utilizada para la información sobre herramientas.

alternar bool
  • True: El botón es un conmutador (cambia el estado presionado/no presionado entre clics consecutivos).

  • False: El botón es un botón normal (vuelve al estado no presionado después de soltarlo).

remove_toolitem ( nombre ) [fuente] #

Eliminar un elemento de herramienta del archivo ToolContainer.

Este método debe implementarse por backend.

Llamado cuando ToolManageremite un tool_removed_event.

Parámetros :
nombre str

Nombre de la herramienta a eliminar.

set_message ( s ) [fuente] #

Muestra un mensaje en la barra de herramientas.

Parámetros :
calle s

Mensaje de texto.

toggle_toolitem ( nombre , alternado ) [fuente] #

Alterne el elemento de herramienta sin evento de disparo.

Parámetros :
nombre str

ID de la herramienta para alternar.

booleano alternado

Si configurar esta herramienta como alternada o no.

trigger_tool ( nombre ) [fuente] #

Activar la herramienta.

Parámetros :
nombre str

Nombre (id) de la herramienta activada desde dentro del contenedor.

matplotlib.backend_bases. button_press_handler ( evento , lienzo = Ninguno , barra de herramientas = Ninguno ) [fuente] #

Las acciones de botón predeterminadas de Matplotlib para botones de mouse adicionales.

Los parámetros son como para key_press_handler, excepto que el evento es un MouseEvent.

matplotlib.backend_bases. get_registered_canvas_class ( formato ) [fuente] #

Devuelve el lienzo predeterminado registrado para el formato de archivo dado. Maneja la importación diferida del backend requerido.

matplotlib.backend_bases. key_press_handler ( evento , lienzo = Ninguno , barra de herramientas = Ninguno ) [fuente] #

Implemente los enlaces de teclas predeterminados de Matplotlib para el lienzo y la barra de herramientas descritos en Métodos abreviados de teclado de navegación .

Parámetros :
eventoKeyEvent

Un evento de pulsación/liberación de tecla.

lienzo FigureCanvasBase, por defecto:event.canvas

La instancia de lienzo específica del backend. Este parámetro se mantiene por compatibilidad con versiones anteriores, pero, si se establece, siempre debe ser igual a event.canvas.

barra de herramientas NavigationToolbar2, por defecto:event.canvas.toolbar

La barra de herramientas del cursor de navegación. Este parámetro se mantiene por compatibilidad con versiones anteriores, pero, si se establece, siempre debe ser igual a event.canvas.toolbar.

matplotlib.backend_bases. register_backend ( formato , backend , descripción = Ninguno ) [fuente] #

Registre un backend para guardar en un formato de archivo dado.

Parámetros :
cadena de formato

Extensión de archivo

cadena de módulo backend o clase de lienzo

Backend para manejar la salida de archivos

cadena de descripción , por defecto: ""

Descripción del tipo de archivo.