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
Figure
detalles 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
KeyEvent
yMouseEvent
almacenan metadatos como teclas y botones presionados, ubicaciones x e y en píxeles yAxes
coordenadas.ShowBase
La clase base para la
Show
clase de cada backend interactivo; el invocable 'show' se establece enShow.__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.draw
ycanvas.blit
estas 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
Event
clase principal.- Atributos :
- renderizador
RendererBase
El renderizador para el evento de sorteo.
- renderizador
- 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.
- lienzo
FigureCanvasBase
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 :
- figura
matplotlib.figure.Figure
Una instancia de figura de alto nivel.
- figura
- 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
MouseEvent
instancia.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
MouseEvent
instancia.- 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
CloseEvent
a todas las funciones conectadas aclose_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
DrawEvent
a todas las funciones conectadas adraw_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_idle
producen 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
Axes
que 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
Axes
que contiene el punto xy .- Parámetros :
- xy (flotante, flotante)
(x, y) posiciones de píxeles desde la izquierda/parte inferior del lienzo.
- Devoluciones :
Axes
o NingunoLos 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
KeyEvent
a todas las funciones conectadas akey_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
KeyEvent
a todas las funciones conectadas akey_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 de
FigureManagerBase
- 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
MouseEvent
instancia.- 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
inaxes
atributo del evento se establecerá enAxes
el evento en el que ocurre, y adicionalmente, las variablesxdata
y losydata
atributos se establecerán en el mouse. ubicación en coordenadas de datos. VerKeyEvent
yMouseEvent
para 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
False
o0
será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
PickEvent
devoluciones 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"]
(predeterminadoNone
:) 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
ResizeEvent
a todas las funciones conectadas aresize_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
MouseEvent
instancia.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 :
- cursor
Cursors
El cursor para mostrar sobre el lienzo. Nota: algunos backends pueden cambiar el cursor de toda la ventana.
- cursor
- 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
ginput
ywaitforbuttonpress
, para esperar eventos.El bucle de eventos se bloquea hasta que se activa una función de devolución de llamada
stop_event_loop
o 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_events
que 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_handler
sistema 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
window
quetoolbar
dan acceso a los widgets de GUI nativos del marco respectivo.- Atributos :
- lienzo
FigureCanvasBase
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)
- lienzo
- 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.
- 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.
- 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_clip_path ( ) [fuente] #
Devuelve la ruta del clip en el formulario (ruta, transformación), donde la ruta es una
Path
instancia y la transformación es una transformación afín para aplicar a la ruta antes del recorte.
- get_dashes ( ) [fuente] #
Devuelve el estilo de guión como un par (desplazamiento, lista de guiones).
Ver
set_dashes
para 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_sketch_params ( ) [fuente] #
Devuelve los parámetros del boceto para el artista.
- Devoluciones :
- tupla o
None
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
None
si no se establecieron parámetros de boceto.
- tupla o
- 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
- 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,alpha
los 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
CapStyle
o {'trasero', 'proyectando', 'redondo'}
- cs
- set_clip_path ( ruta ) [fuente] #
Establezca la ruta del clip en a
TransformedPath
o en Ninguno.
- set_clip_rectangle ( rectángulo ) [fuente] #
Establezca el rectángulo de recorte en a
Bbox
o 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_joinstyle ( js ) [fuente] #
Establezca cómo dibujar conexiones entre segmentos de línea.
- Parámetros :
- js
JoinStyle
o {'inglete', 'redondo', 'bisel'}
- js
- 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
- 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
Event
y lasLocationEvent
clases.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
Event
clase principal.- Atributos :
- x, y int o Ninguno
Ubicación del evento en píxeles desde la parte inferior izquierda del lienzo.
- inaxes
Axes
o ninguno La
Axes
instancia 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. 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
Event
y lasLocationEvent
clases.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
MouseButton
o {'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'.
- botón Ninguno o
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étodoshome
,back
,forward
,pan
,zoom
ysave_figure
y usar íconos estándar en el subdirectorio "imágenes" de la ruta de datos.¡Eso es todo, nosotros haremos el resto!
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.
Devolución de llamada para arrastrar en modo pan/zoom.
Devolución de llamada para arrastrar en modo zoom.
Dibuje una banda elástica rectangular para indicar los límites de zoom.
Tenga en cuenta que no se garantiza que y .
x0 <= x1
y0 <= y1
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.
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.
Alterne la herramienta de panorámica/zoom.
Panorámica con el botón izquierdo, zoom con el derecho.
Devolución de llamada para presionar el botón del mouse en el modo de panorámica/zoom.
Devolución de llamada para presionar el botón del mouse en modo zoom para rect.
Empuje los límites de vista actuales y la posición en la pila.
Devolución de llamada para soltar el botón del mouse en modo pan/zoom.
Devolución de llamada para soltar el botón del mouse en el modo zoom to rect.
Retire la banda de goma.
Guarda la figura actual.
[ Obsoleto ] Establece el cursor actual en uno de los
Cursors
valores 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_cursor
en su lugar.
Habilite o deshabilite el botón de avance/retroceso.
Muestra un mensaje en la barra de herramientas o en la barra de estado.
Reinicie la pila de ejes.
- 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
Event
clase 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ón
MouseEvent
El evento del mouse que generó la elección.
- artista
matplotlib.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
Line2D
selección puede definir diferentes atributos adicionales que unaPatchCollection
selección.
- evento del rató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_path
darí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 :
- gc
GraphicsContextBase
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.
- transformar
matplotlib.transforms.Transform
Una transformación afín para aplicar a los puntos.
- gc
- 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.
- transformar
matplotlib.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 :
- gc
GraphicsContextBase
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.
- transformar
matplotlib.transforms.Affine2DBase
Si y solo si el backend concreto se escribe de tal forma que
option_scale_image
devuelve , se puede pasarTrue
una transformación afín (es decir, anAffine2DBase
) 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
- gc
- 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 :
- gc
GraphicsContextBase
El contexto gráfico.
- marcador_trans
matplotlib.transforms.Transform
Una transformación afín aplicada al marcador.
- trans
matplotlib.transforms.Transform
Una transformación afín aplicada a la ruta.
- gc
- dibujar_ruta ( gc , ruta , transformar , rgbFace = Ninguno ) [fuente] #
Dibuja una
Path
instancia 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_paths
se_iter_collection
proporcionan 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 comportamientodraw_path_collection
se 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
.
- 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.
- 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
TexManager
instancia.
- 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
Event
clase 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, laTimer
clase misma almacenará el indicador y el_on_timer
mé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.callbacks
y se puede manipular directamente, o se pueden utilizar las funcionesadd_callback
y .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, **kwargs
add_callback
functools.partial
- propiedad single_shot #
Si este temporizador debe detenerse después de una sola ejecución.
- 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 herramientas
ToolManager
Las herramientas con las que este
ToolContainer
quiere comunicarse.
- administrador de herramientas
- 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
- remove_toolitem ( nombre ) [fuente] #
Eliminar un elemento de herramienta del archivo
ToolContainer
.Este método debe implementarse por backend.
Llamado cuando
ToolManager
emite untool_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.
- 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 unMouseEvent
.
- 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 :
- evento
KeyEvent
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
.
- evento
- 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.