`matplotlib.backend_bases`#

As classes base abstratas definem as primitivas que os renderizadores e os contextos gráficos devem implementar para servir como um back-end do Matplotlib.

RendererBase: Uma classe base abstrata para lidar com operações de desenho/renderização.
FigureCanvasBase: A camada de abstração que separa os Figuredetalhes específicos do back-end, como uma área de desenho da interface do usuário.
GraphicsContextBase: Uma classe base abstrata que fornece cores, estilos de linha, etc.
Event: A classe base para toda a manipulação de eventos Matplotlib. Classes derivadas como KeyEvente MouseEventarmazenam os metadados como teclas e botões pressionados, localizações x e y em pixels e Axescoordenadas.
ShowBase: A classe base para a Showclasse de cada back-end interativo; o 'show' callable é então definido como Show.__call__.
ToolContainerBase: A classe base para a classe Toolbar de cada back-end interativo.

classe matplotlib.backend_bases. CloseEvent ( name , canvas , guiEvent = None ) [source] #

Bases:Event

Um evento desencadeado por uma figura sendo fechada.

classe matplotlib.backend_bases. DrawEvent ( nome , tela , renderizador ) [fonte] #

Bases:Event

Um evento acionado por uma operação de desenho na tela.

Na maioria dos back-ends, os callbacks inscritos neste evento serão acionados após a conclusão da renderização, mas antes da atualização da tela. Qualquer artista extra desenhado para o renderizador da tela será refletido sem uma chamada explícita para blit.

Aviso

Chamar canvas.drawe canvas.blitnesses retornos de chamada pode não ser seguro com todos os back-ends e pode causar recursão infinita.

Um DrawEvent possui vários atributos especiais além daqueles definidos pela Eventclasse pai.

Atributos :

renderizadorRendererBase: O renderizador para o evento de desenho.

classe matplotlib.backend_bases. Evento ( nome , tela , guiEvent = Nenhum ) [fonte] #

Bases:object

Um evento Matplotlib.

Os seguintes atributos são definidos e mostrados com seus valores padrão. As subclasses podem definir atributos adicionais.

Atributos :

nome str: O nome do evento.
telaFigureCanvasBase: A instância de tela específica de back-end que gera o evento.
guiEvent: O evento da GUI que acionou o evento Matplotlib.

classe matplotlib.backend_bases. FigureCanvasBase ( figure = None ) [source] #

Bases:object

A tela na qual a figura é renderizada.

Atributos :

figuramatplotlib.figure.Figure: Uma instância de figura de alto nível.

blit ( bbox = None ) [fonte] #: Blit a tela em bbox (tela inteira padrão).

propriedade button_pick_id #

button_press_event ( x , y , botão , dblclick = False , guiEvent = None ) [fonte] #

[ Descontinuado ] Processamento de retorno de chamada para eventos de pressionamento do botão do mouse.

As classes derivadas de back-end devem chamar essa função ao pressionar o botão do mouse. ( x , y ) são as coordenadas da tela ((0, 0) é o canto inferior esquerdo). o botão e a tecla são conforme definidos em MouseEvent.

Este método chamará todas as funções conectadas ao 'button_press_event' com uma MouseEventinstância.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('button_press_event', MouseEvent(...)) em seu lugar.

button_release_event ( x , y , botão , guiEvent = Nenhum ) [fonte] #

[ Obsoleto ] Processamento de retorno de chamada para eventos de liberação do botão do mouse.

Classes derivadas de back-end devem chamar essa função em qualquer liberação de botão do mouse.

Este método chamará todas as funções conectadas ao 'button_release_event' com uma MouseEventinstância.

Parâmetros :

x flutuar: A tela coordena onde 0=esquerda.
você flutua: As coordenadas da tela onde 0=inferior.
guiEvent: O evento de interface do usuário nativo que gerou o evento Matplotlib.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('button_release_event', MouseEvent(...)) em seu lugar.

retornos de chamada de propriedade #

close_event ( guiEvent = None ) [source] #

[ Descontinuado ] Passe a CloseEventpara todas as funções conectadas a close_event.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('close_event', CloseEvent(...)) em seu lugar.

propriedade device_pixel_ratio #

A proporção de pixels físicos para lógicos usados para a tela na tela.

Por padrão, é 1, o que significa que os pixels físicos e lógicos têm o mesmo tamanho. As subclasses que suportam telas de alto DPI podem definir esta propriedade para indicar que a referida proporção é diferente. Toda a interação do Matplotlib, a menos que trabalhe diretamente com a tela, permanece em pixels lógicos.

draw ( * args , ** kwargs ) [fonte] #

Renderize o Figure.

Esse método deve percorrer a árvore do artista, mesmo que nenhuma saída seja produzida, porque aciona o trabalho adiado que os usuários podem querer acessar antes de salvar a saída no disco. Por exemplo, calcular limites, limites automáticos e valores de escala.

draw_event ( renderizador ) [fonte] #

[ Descontinuado ] Passe a DrawEventpara todas as funções conectadas a draw_event.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('draw_event', DrawEvent(...)) em seu lugar.

draw_idle ( * args , ** kwargs ) [fonte] #

Solicite um redesenho do widget assim que o controle retornar ao loop de eventos da GUI.

Mesmo que várias chamadas draw_idleocorram antes que o controle retorne ao loop de eventos da GUI, a figura será renderizada apenas uma vez.

Notas

Os back-ends podem optar por substituir o método e implementar sua própria estratégia para evitar várias renderizações.

enter_notify_event ( guiEvent = Nenhum , xy = Nenhum ) [fonte] #

[ Obsoleto ] Processamento de retorno de chamada para o cursor do mouse entrando na tela.

As classes derivadas de back-end devem chamar essa função ao entrar na tela.

Parâmetros :

guiEvent: O evento de interface do usuário nativo que gerou o evento Matplotlib.
xy (flutuar, flutuar): A localização da coordenada do ponteiro quando a tela é inserida.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('enter_notify_event', LocationEvent(...)) em seu 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 de especialistas em fotografia conjunta ', 'jpg': 'Grupo de especialistas em fotografia conjunta ', 'pdf': ' Formato de documento portátil ', 'pgf': 'PGF code for LaTeX', 'png': 'Portable Network Graphics', 'ps': 'Postscript', 'raw': ' bitmap RGBA bruto ', 'rgba': ' bitmap RGBA bruto ','svg': 'Gráficos vetoriais escaláveis ', 'svgz': 'Scalable Vector Graphics', 'tif': 'Tagged Image File Format', 'tiff': 'Tagged Image File Format', 'webp': 'WebP Image Format'} #

fixed_dpi = Nenhum #

flush_events ( ) [fonte] #

Descarregue os eventos da GUI para a figura.

Os back-ends interativos precisam reimplementar esse método.

get_default_filename ( ) [fonte] #: Retorna uma string, que inclui extensão, adequada para uso como um nome de arquivo padrão.

classmethod get_default_filetype ( ) [fonte] #

Retorna o formato de arquivo savefig padrão conforme especificado em rcParams["savefig.format"](padrão: 'png').

A string retornada não inclui um ponto. Este método é substituído em back-ends que suportam apenas um único tipo de arquivo.

classmethod get_supported_filetypes ( ) [fonte] #: Dito de retorno dos formatos de arquivo savefig suportados por este back-end.

classmethod get_supported_filetypes_grouped ( ) [fonte] #: Retorna um ditado de formatos de arquivo savefig suportados por este back-end, onde as chaves são um nome de tipo de arquivo, como 'Joint Photographic Experts Group', e os valores são uma lista de extensões de nome de arquivo usadas para esse tipo de arquivo, como ['jpg' , 'jpeg'].

get_width_height ( * , physical = False ) [fonte] #

Retorna a largura e a altura da figura em pontos inteiros ou pixels.

Quando a figura é usada em telas de alto DPI (e o back-end suporta isso), o truncamento para números inteiros ocorre após o dimensionamento pela proporção de pixels do dispositivo.

Parâmetros :

bool físico , padrão: Falso: Se deve retornar pixels físicos verdadeiros ou pixels lógicos. Os pixels físicos podem ser usados por back-ends que suportam HiDPI, mas ainda configuram a tela usando seu tamanho real.

Devoluções :

largura, altura int: O tamanho da figura, em pontos ou pixels, dependendo do backend.

grab_mouse ( machado ) [fonte] #

Defina o filho Axesque está pegando os eventos do mouse.

Geralmente chamado pelos próprios widgets. É um erro chamar isso se o mouse já estiver agarrado por outro Axes.

inaxes ( xy ) [fonte] #

Retorna o visível mais alto Axescontendo o ponto xy .

Parâmetros :

xy (flutuar, flutuar): (x, y) posições de pixel da esquerda/parte inferior da tela.

Devoluções :

Axesou nenhum: Os Eixos visíveis mais acima contendo o ponto, ou Nenhum se não houver Eixos no ponto.

is_saving ( ) [fonte] #: Retorna se o renderizador está no processo de salvar em um arquivo, em vez de renderizar para um buffer na tela.

key_press_event ( chave , guiEvent = Nenhum ) [fonte] #

[ Descontinuado ] Passe a KeyEventpara todas as funções conectadas a key_press_event.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('key_press_event', KeyEvent(...)) em seu lugar.

key_release_event ( chave , guiEvent = Nenhum ) [fonte] #

[ Descontinuado ] Passe a KeyEventpara todas as funções conectadas a key_release_event.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('key_release_event', KeyEvent(...)) em vez disso.

leave_notify_event ( guiEvent = None ) [source] #

[ Obsoleto ] Processamento de retorno de chamada para o cursor do mouse saindo da tela.

Classes derivadas de back-end devem chamar essa função ao sair da tela.

Parâmetros :

guiEvent: O evento de interface do usuário nativo que gerou o evento Matplotlib.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('leave_notify_event', LocationEvent(...)) em seu lugar.

manager_class [fonte] #: pseudônimo deFigureManagerBase

motion_notify_event ( x , y , guiEvent = Nenhum ) [fonte] #

[ Descontinuado ] Processamento de retorno de chamada para eventos de movimento do mouse.

As classes derivadas de back-end devem chamar essa função em qualquer evento de notificação de movimento.

Este método chamará todas as funções conectadas ao 'motion_notify_event' com uma MouseEventinstância.

Parâmetros :

x flutuar: A tela coordena onde 0=esquerda.
você flutua: As coordenadas da tela onde 0=inferior.
guiEvent: O evento de interface do usuário nativo que gerou o evento Matplotlib.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('motion_notify_event', MouseEvent(...)) em seu lugar.

mpl_connect ( s , func ) [fonte] #

Vincule a função func ao evento s .

Parâmetros :

s str

Um dos seguintes IDs de eventos:

'button_press_event'
'button_release_event'
'desenhar_evento'
'key_press_event'
'key_release_event'
'motion_notify_event'
'escolher_evento'
'resize_event'
'scroll_event'
'figura_enter_event',
'figura_leave_event',
'axes_enter_event',
'axes_leave_event'
'fechar_evento'.

func callable

A função callback a ser executada, que deve ter a assinatura:

def func(event: Event) -> Any

Para os eventos de localização (pressionar/soltar botão e tecla), se o mouse estiver sobre os Eixos, o inaxesatributo do evento será definido como Axeso evento ocorrido acabou e, adicionalmente, as variáveis xdatae ydataatributos serão definidos para o mouse localização em coordenadas de dados. Veja KeyEvent e MouseEventpara mais informações.

Devoluções :

cid: Um ID de conexão que pode ser usado com FigureCanvasBase.mpl_disconnect.

Exemplos

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

Desconecte o retorno de chamada com id cid .

Exemplos

cid = canvas.mpl_connect('button_press_event', on_press)
# ... later
canvas.mpl_disconnect(cid)

classmethod new_manager ( figure , num ) [source] #

Crie um novo gerenciador de figuras para figure , usando esta classe de tela.

Notas

Este método não deve ser reimplementado em subclasses. Se for necessária uma lógica de criação de gerenciador personalizada, reimplemente FigureManager.create_with_canvas.

new_timer ( intervalo = Nenhum , retornos de chamada = Nenhum ) [fonte] #

Crie uma nova subclasse específica de back-end de Timer.

Isso é útil para obter eventos periódicos por meio do loop de eventos nativo do back-end. Implementado apenas para back-ends com GUIs.

Parâmetros :

intervalo int

Intervalo do temporizador em milissegundos.

lista de callbacks [tuple[callable, tuple, dict]]

Sequência de (func, args, kwargs) onde será executado pelo cronômetro a cada intervalo .func(*args, **kwargs)

Callbacks que retornam Falseou 0serão removidos do timer.

Exemplos

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

escolha ( mouseevent ) [fonte] #

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.6: Use canvas.figure.pick em vez disso.

pick_event ( mouseevent , artist , ** kwargs ) [fonte] #

[ Descontinuado ] Processamento de retorno de chamada para eventos de seleção.

Este método será chamado pelos artistas escolhidos e disparará PickEventcallbacks dos ouvintes registrados.

Observe que os artistas não podem ser escolhidos por padrão (consulte Recursos Artist.set_picker).

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('pick_event', PickEvent(...)) em seu lugar.

print_figure ( arquivo , dpi = Nenhum , facecolor = Nenhum , edgecolor = Nenhum , orientação = 'retrato' , formato = Nenhum , * , bbox_inches = Nenhum , pad_inches = Nenhum , bbox_extra_artists = Nenhum , backend = Nenhum , ** kwargs ) [fonte ] #

Renderize a figura para cópia impressa. Defina a face do patch da figura e as cores das bordas. Isso é útil porque algumas das GUIs têm um fundo de cor de rosto de figura cinza e você provavelmente desejará substituir isso na cópia impressa.

Parâmetros :

filename str ou path-like ou file-like: O arquivo onde a figura é salva.
dpi flutuante, padrão: rcParams["savefig.dpi"](padrão: 'figure'): Os pontos por polegada para salvar a figura.
facecolor color ou 'auto', padrão: rcParams["savefig.facecolor"](padrão: 'auto'): A cor da face da figura. Se for 'auto', use a cor do rosto da figura atual.
cor da cor da borda ou 'auto', padrão: rcParams["savefig.edgecolor"](padrão: 'auto'): A cor da borda da figura. Se for 'auto', use a cor de borda da figura atual.
orientação {'paisagem', 'retrato'}, padrão: 'retrato': No momento, aplica-se apenas à impressão PostScript.
formato str, opcional: Força um formato de arquivo específico. Se não for fornecido, o formato é inferido a partir da extensão do nome do arquivo e, se falhar, a partir de rcParams["savefig.format"](padrão: 'png').
bbox_inches 'apertado' ou Bbox, padrão: rcParams["savefig.bbox"](padrão: None): Caixa delimitadora em polegadas: apenas a parte especificada da figura é salva. Se for 'apertado', tente descobrir o bbox apertado da figura.
pad_inches float, padrão: rcParams["savefig.pad_inches"](padrão: 0.1): Quantidade de preenchimento ao redor da figura quando bbox_inches é 'apertado'.
bbox_extra_artists lista de Artist, opcional: Uma lista de artistas extras que serão considerados quando o bbox for calculado.
back- end str, opcional: Use um backend não padrão para renderizar o arquivo, por exemplo, para renderizar um arquivo png com o backend "cairo" em vez do padrão "agg" ou um arquivo pdf com o backend "pgf" em vez do "pdf" padrão. Observe que o back-end padrão normalmente é suficiente. Consulte Os back-ends integrados para obter uma lista de back-ends válidos para cada formato de arquivo. Os back-ends personalizados podem ser referenciados como "module://...".

release_mouse ( machado ) [fonte] #

Solte a garra do mouse segurada pelo machado .Axes

Geralmente chamado pelos widgets. Não há problema em chamar isso mesmo se ax não tiver a captura do mouse no momento.

required_interactive_framework = Nenhum #

redimensionar ( w , h ) [fonte] #

NÃO USADO: Defina o tamanho da tela em pixels.

Certos back-ends podem implementar um método semelhante internamente, mas isso não é um requisito nem é usado pelo próprio Matplotlib.

resize_event ( ) [fonte] #

[ Descontinuado ] Passe a ResizeEventpara todas as funções conectadas a resize_event.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('resize_event', ResizeEvent(...)) em seu lugar.

scroll_event ( x , y , passo , guiEvent = Nenhum ) [fonte] #

[ Descontinuado ] Processamento de retorno de chamada para eventos de rolagem.

Classes derivadas de back-end devem chamar essa função em qualquer evento de roda de rolagem. ( x , y ) são as coordenadas da tela ((0, 0) é o canto inferior esquerdo). o botão e a tecla são conforme definidos em MouseEvent.

Este método chamará todas as funções conectadas ao 'scroll_event' com uma MouseEventinstância.

Notas

Obsoleto desde a versão 3.6: Use callbacks.process('scroll_event', MouseEvent(...)) em seu lugar.

propriedade scroll_pick_id #

set_cursor ( cursor ) [fonte] #

Defina o cursor atual.

Isso pode não ter efeito se o back-end não exibir nada.

Se exigido pelo back-end, este método deve acionar uma atualização no loop de eventos do back-end após o cursor ser definido, pois esse método pode ser chamado, por exemplo, antes de uma tarefa de execução longa durante a qual a GUI não é atualizada.

Parâmetros :

cursorCursors: O cursor a ser exibido sobre a tela. Observação: alguns back-ends podem alterar o cursor da janela inteira.

start_event_loop ( timeout = 0 ) [fonte] #

Inicie um loop de evento de bloqueio.

Esse loop de eventos é usado por funções interativas, como ginpute waitforbuttonpress, para aguardar eventos.

O loop de eventos é bloqueado até que uma função de retorno de chamada seja acionada stop_event_loopou o tempo limite seja atingido.

Se o tempo limite for 0 ou negativo, nunca o tempo limite.

Somente back-ends interativos precisam reimplementar esse método e ele depende de flush_eventsser implementado corretamente.

Os back-ends interativos devem implementar isso de uma maneira mais nativa.

stop_event_loop ( ) [fonte] #

Pare o loop de evento de bloqueio atual.

Os back-ends interativos precisam reimplementar isso para corresponder start_event_loop

support_blit = Falso #

switch_backends ( FigureCanvasClass ) [fonte] #

Instanciar uma instância de FigureCanvasClass

Isso é usado para comutação de back-end, por exemplo, para instanciar um FigureCanvasPS de um FigureCanvasGTK. Observe que a cópia profunda não é feita, portanto, quaisquer alterações em uma das instâncias (por exemplo, definir o tamanho da figura ou adereços de linha) serão refletidas na outra

classe matplotlib.backend_bases. FigureManagerBase ( canvas , num ) [source] #

Bases:object

Uma abstração independente de back-end de um contêiner de figura e controlador.

O gerenciador de figuras é usado pelo pyplot para interagir com a janela de forma independente do back-end. É um adaptador para o framework real (GUI) que representa a figura visual na tela.

Os back-ends da GUI definem a partir dessa classe para traduzir operações comuns, como mostrar ou redimensionar , para o código específico da GUI. Os back-ends não GUI não suportam essas operações e podem apenas usar a classe base.

As seguintes operações básicas estão acessíveis:

Operações da janela

show
destroy
full_screen_toggle
resize
get_window_title
set_window_title

Manipulação de pressionamento de tecla e botão do mouse

O gerenciador de figuras configura o manuseio padrão de pressionamento de tecla e botão do mouse, conectando-o key_press_handlerao sistema de eventos matplotlib. Isso garante os mesmos atalhos e ações do mouse nos back-ends.

Outras operações

As subclasses terão atributos e funções adicionais para acessar funcionalidades adicionais. É claro que isso é específico do back-end. Por exemplo, a maioria dos back-ends de GUI possui windowatributos toolbarque dão acesso aos widgets de GUI nativos da respectiva estrutura.

Atributos :

telaFigureCanvasBase

A instância de tela específica de back-end.

num int ou str

O número da figura.

key_press_handler_id int

O manipulador de chave padrão cid, ao usar o toolmanager. Para desabilitar o uso de manuseio de pressionamento de tecla padrão:

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

button_press_handler_id int

O manipulador de botão do mouse padrão cid, ao usar o toolmanager. Para desabilitar o uso padrão de manuseio de pressionamento de botão:

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

classmethod create_with_canvas ( canvas_class , figure , num ) [source] #

Crie um gerenciador para uma determinada figura usando uma canvas_class específica .

Os back-ends devem substituir esse método se tiverem necessidades específicas para configurar a tela ou o gerenciador.

destruir ( ) [fonte] #

full_screen_toggle ( ) [fonte] #

get_window_title ( ) [fonte] #: Retorna o texto do título da janela que contém a figura, ou None se não houver janela (por exemplo, um back-end PS).

redimensionar ( w , h ) [fonte] #: Para back-ends de GUI, redimensione a janela (em pixels físicos).

set_window_title ( título ) [fonte] #

Defina o texto do título da janela que contém a figura.

Isso não tem efeito para back-ends não GUI (por exemplo, PS).

mostre ( ) [fonte] #: Para back-ends de GUI, mostre a janela da figura e redesenhe. Para back-ends não GUI, gere uma exceção, a menos que esteja executando sem comando (ou seja, no Linux com um DISPLAY não definido); esta exceção é convertida em um aviso em Figure.show.

classe matplotlib.backend_bases. GraphicsContextBase [fonte] #

Bases:object

Uma classe base abstrata que fornece cores, estilos de linha, etc.

copy_properties ( gc ) [fonte] #: Copie as propriedades de gc para self.

get_alpha ( ) [fonte] #: Retorne o valor alfa usado para mesclagem - não suportado em todos os back-ends.

get_antialiased ( ) [fonte] #: Retorna se o objeto deve tentar renderização antialiased.

get_capstyle ( ) [fonte] #: Devolva o CapStyle.

get_clip_path ( ) [fonte] #: Retorne o caminho do recorte no formato (path, transform), onde path é uma Pathinstância e transform é uma transformação afim a ser aplicada ao caminho antes do recorte.

get_clip_rectangle ( ) [fonte] #: Retorne o retângulo do clipe como uma Bboxinstância.

get_dashes ( ) [fonte] #

Retorna o estilo de traço como um par (deslocamento, lista de traços).

Consulte set_dashespara obter detalhes.

O valor padrão é (Nenhum, Nenhum).

get_forced_alpha ( ) [fonte] #: Retorna se o valor fornecido por get_alpha() deve ser usado para substituir qualquer outro valor de canal alfa.

get_gid ( ) [fonte] #: Retorna o identificador de objeto se houver um definido, nenhum caso contrário.

get_hatch ( ) [fonte] #: Obtenha o estilo de hachura atual.

get_hatch_color ( ) [fonte] #: Obtenha a cor da hachura.

get_hatch_linewidth ( ) [fonte] #: Obtenha a largura da linha da hachura.

get_hatch_path ( densidade = 6.0 ) [fonte] #: Retorna um Pathpara a hachura atual.

get_joinstyle ( ) [fonte] #: Devolva o JoinStyle.

get_linewidth ( ) [fonte] #: Retorna a largura da linha em pontos.

get_rgb ( ) [fonte] #: Retorna uma tupla de três ou quatro floats de 0-1.

get_sketch_params ( ) [fonte] #

Retorne os parâmetros do esboço para o artista.

Devoluções :

tupla ouNone

Uma 3-tupla com os seguintes elementos:

scale: A amplitude da oscilação perpendicular à linha de origem.
length: o comprimento do movimento ao longo da linha.
randomness: O fator de escala pelo qual o comprimento é reduzido ou expandido.

Pode retornar Nonese nenhum parâmetro de esboço foi definido.

get_snap ( ) [fonte] #

Retorne a configuração do snap, que pode ser:

Verdadeiro: ajusta os vértices ao centro de pixel mais próximo
Falso: deixe os vértices como estão
Nenhum: (automático) Se o caminho contiver apenas segmentos de linha retilínea, arredonde para o centro de pixel mais próximo

get_url ( ) [fonte] #: Retorna um url se um estiver definido, nenhum caso contrário.

restaurar ( ) [fonte] #: Restaurar o contexto gráfico da pilha - necessário apenas para back-ends que salvam contextos gráficos em uma pilha.

set_alpha ( alpha ) [fonte] #

Defina o valor alfa usado para mesclagem - não suportado em todos os back-ends.

Se alpha=None(o padrão), os componentes alfa do primeiro plano e cores de preenchimento serão usados para definir suas respectivas transparências (quando aplicável); caso contrário, alphairá substituí-los.

set_antialiased ( b ) [fonte] #: Defina se o objeto deve ser desenhado com renderização suavizada.

set_capstyle ( cs ) [fonte] #

Defina como desenhar pontos finais de linhas.

Parâmetros :

cs CapStyleou {'butt', 'projecting', 'round'}

set_clip_path ( caminho ) [fonte] #: Defina o caminho do clipe como a TransformedPathou Nenhum.

set_clip_rectangle ( retângulo ) [fonte] #: Defina o retângulo do clipe como a Bboxou Nenhum.

set_dashes ( dash_offset , dash_list ) [fonte] #

Defina o estilo do traço para o gc.

Parâmetros :

traço_deslocamento flutuante: Distância, em pontos, no padrão de traço no qual iniciar o padrão. Geralmente é definido como 0.
dash_list array-like ou None: A sequência on-off como pontos. Nenhum especifica uma linha sólida. Caso contrário, todos os valores devem ser não negativos (\(\ge 0\)).

Notas

Consulte a pág. 666 do PostScript Language Reference para obter mais informações.

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

Defina a cor do primeiro plano.

Parâmetros :

fg cor
isRGBA booleano: Se fg for uma tupla, isRGBA pode ser definido como True para melhorar o desempenho.(r, g, b, a)

set_gid ( id ) [fonte] #: Defina a identificação.

set_hatch ( hatch ) [fonte] #: Defina o estilo de hachura (para preenchimentos).

set_hatch_color ( hatch_color ) [fonte] #: Defina a cor da hachura.

set_joinstyle ( js ) [fonte] #

Defina como desenhar conexões entre segmentos de linha.

Parâmetros :

js JoinStyleou {'miter', 'redondo', 'chanfrado'}

set_linewidth ( w ) [fonte] #: Defina a largura da linha em pontos.

set_sketch_params ( scale = None , length = None , randomness = None ) [source] #

Defina os parâmetros do esboço.

Parâmetros :

flutuador de escala , opcional: A amplitude da oscilação perpendicular à linha de origem, em pixels. Se a escala for None, ou não for fornecida, nenhum filtro de esboço será fornecido.
flutuação de comprimento , padrão: 128: O comprimento da oscilação ao longo da linha, em pixels.
flutuação de aleatoriedade , padrão: 16: O fator de escala pelo qual o comprimento é reduzido ou expandido.

set_snap ( snap ) [fonte] #

Defina a configuração de encaixe, que pode ser:

Verdadeiro: ajusta os vértices ao centro de pixel mais próximo
Falso: deixe os vértices como estão
Nenhum: (automático) Se o caminho contiver apenas segmentos de linha retilínea, arredonde para o centro de pixel mais próximo

set_url ( url ) [fonte] #: Defina o URL para links em back-ends compatíveis.

classe matplotlib.backend_bases. KeyEvent ( nome , tela , chave , x = 0 , y = 0 , guiEvent = Nenhum ) [fonte] #

Bases:LocationEvent

Um evento de tecla (tecla pressionada, tecla liberada).

Um KeyEvent possui vários atributos especiais além daqueles definidos pelo pai Evente pelas LocationEventclasses.

Notas

As teclas modificadoras serão prefixadas à tecla pressionada e estarão na ordem "ctrl", "alt", "super". A exceção a esta regra é quando a tecla pressionada é uma tecla modificadora, portanto "ctrl+alt" e "alt+control" podem ser valores de tecla válidos.

Exemplos

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

cid = fig.canvas.mpl_connect('key_press_event', on_key)

Atributos :

chave Nenhum ou str: A(s) tecla(s) pressionada(s). Pode ser None , um único caractere Unicode com distinção entre maiúsculas e minúsculas ("g", "G", "#" etc.), uma tecla especial ("control", "shift", "f1", "up" etc.) ou uma combinação dos anteriores (por exemplo, "ctrl+alt+g", "ctrl+alt+G").

classe matplotlib.backend_bases. LocationEvent ( name , canvas , x , y , guiEvent = None ) [source] #

Bases:Event

Um evento que tem uma localização na tela.

Um LocationEvent possui vários atributos especiais além daqueles definidos pela Eventclasse pai.

Atributos :

x, y int ou Nenhum: Localização do evento em pixels da parte inferior esquerda da tela.
inaxes Axesou nenhum: A Axesinstância sobre a qual o mouse está, se houver.
xdata, ydata float ou None: Coordenadas de dados do mouse dentro de inaxes , ou None se o mouse não estiver sobre um Axes.

último evento = Nenhum #

classe matplotlib.backend_bases. MouseButton ( valor ) [fonte] #

Bases:IntEnum

Uma enumeração.

VOLTAR = 8 [fonte] #

AVANÇAR = 9 [fonte] #

ESQUERDA = 1 [fonte] #

MEIO = 2 [fonte] #

DIREITA = 3 [fonte] #

classe matplotlib.backend_bases. MouseEvent ( name , canvas , x , y , button = None , key = None , step = 0 , dblclick = False , guiEvent = None ) [source] #

Bases:LocationEvent

Um evento de mouse ('button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event').

Um MouseEvent possui vários atributos especiais além daqueles definidos pelo pai Evente pelas LocationEventclasses.

Exemplos

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ão Nenhum ou MouseButtonou {'para cima', 'para baixo'}

O botão pressionado. 'up' e 'down' são usados para eventos de rolagem.

Observe que ESQUERDA e DIREITA na verdade referem-se aos botões "primário" e "secundário", ou seja, se o usuário inverter os botões esquerdo e direito ("configuração para canhotos"), o botão ESQUERDO será aquele fisicamente à direita.

Se isso não for definido, o nome for "scroll_event" e o passo for diferente de zero, então isso será definido como "up" ou "down" dependendo do sinal do passo .

chave Nenhum ou str

A tecla pressionada quando o evento do mouse foi acionado, por exemplo, 'shift'. Veja KeyEvent.

Aviso

Esta chave é atualmente obtida do último 'key_press_event' ou 'key_release_event' que ocorreu dentro da tela. Assim, se a última mudança de estado do teclado ocorreu enquanto o canvas não estava com o foco, este atributo estará errado.

passo flutuante

O número de passos de rolagem (positivo para 'para cima', negativo para 'para baixo'). Isso se aplica apenas a 'scroll_event' e o padrão é 0 caso contrário.

dblclick bool

Se o evento é um clique duplo. Isso se aplica apenas a 'button_press_event' e é falso caso contrário. Em particular, não é usado em 'button_release_event'.

classe matplotlib.backend_bases. NavigationToolbar2 ( canvas ) [fonte] #

Bases:object

Classe base para o cursor de navegação, versão 2.

Os back-ends devem implementar uma tela que lide com conexões para 'button_press_event' e 'button_release_event'. Consulte FigureCanvasBase.mpl_connect()para mais informações.

Eles também devem definir

save_figure()
salvar a figura atual

draw_rubberband()(opcional)
desenhe o zoom para rectângulo "elástico"

set_message()(opcional)
mensagem de exibição

set_history_buttons()(opcional)
você pode alterar os botões voltar/avançar do histórico para indicar o estado desabilitado/habilitado.

e substitua __init__para configurar a barra de ferramentas -- sem esquecer de chamar o init da classe base. Normalmente, __init__precisa configurar os botões da barra de ferramentas conectados aos métodos home, back, forward, pan, zoome save_figureusando ícones padrão no subdiretório "imagens" do caminho de dados.

É isso, nós fazemos o resto!

voltar ( * args ) [fonte] #

Mova de volta para cima a pilha de lim de exibição.

Por conveniência de ser conectado diretamente como um retorno de chamada da GUI, que geralmente recebe parâmetros adicionais, esse método aceita parâmetros arbitrários, mas não os utiliza.

configure_subplots ( * args ) [fonte] #

drag_pan ( evento ) [fonte] #: Retorno de chamada para arrastar no modo panorâmico/zoom.

drag_zoom ( evento ) [fonte] #: Callback para arrastar no modo de zoom.

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

Desenhe um elástico retangular para indicar os limites de zoom.

Observe que não é garantido que e .x0 <= x1y0 <= y1

encaminhar ( * args ) [fonte] #

Avance na pilha de lim de visualização.

Por conveniência de ser conectado diretamente como um retorno de chamada da GUI, que geralmente recebe parâmetros adicionais, esse método aceita parâmetros arbitrários, mas não os utiliza.

home ( * args ) [fonte] #

Restaure a visualização original.

Por conveniência de ser conectado diretamente como um retorno de chamada da GUI, que geralmente recebe parâmetros adicionais, esse método aceita parâmetros arbitrários, mas não os utiliza.

mouse_move ( evento ) [fonte] #

pan ( * args ) [fonte] #

Alternar a ferramenta panorâmica/zoom.

Panorâmica com o botão esquerdo, zoom com o botão direito.

press_pan ( evento ) [fonte] #: Retorno de chamada para pressionar o botão do mouse no modo panorâmico/zoom.

press_zoom ( evento ) [fonte] #: Retorno de chamada para pressionar o botão do mouse no zoom para o modo reto.

push_current ( ) [fonte] #: Empurre os limites de visualização atuais e posicione-os na pilha.

release_pan ( evento ) [fonte] #: Retorno de chamada para liberação do botão do mouse no modo panorâmico/zoom.

release_zoom ( evento ) [fonte] #: Retorno de chamada para liberação do botão do mouse no modo zoom para reto.

remove_rubberband ( ) [fonte] #: Remova o elástico.

save_figure ( * args ) [fonte] #: Salve a figura atual.

set_cursor ( cursor ) [fonte] #

[ Obsoleto ] Defina o cursor atual para um dos Cursorsvalores de enums.

Notas

Obsoleto desde a versão 3.5: Use FigureCanvasBase.set_cursorem seu lugar.

set_history_buttons ( ) [fonte] #: Ative ou desative o botão Voltar/Avançar.

set_message ( s ) [fonte] #: Exibir uma mensagem na barra de ferramentas ou na barra de status.

toolitems = (('Home', 'Redefinir visualização original ', 'home', 'home'), ('Voltar', 'Voltar à visualização anterior ', 'voltar', 'voltar'), ('Avançar', ' Avançar para a próxima visualização', 'avançar', 'avançar'), (Nenhum, Nenhum, Nenhum, Nenhum), ('Pan', ' Botão esquerdo gira, Botão direito amplia\nx/y corrige eixo, CTRL corrige aspecto', 'mover', 'panoramizar'),('Zoom', 'Zoom para retângulo\nx/y fixes axis', 'zoom_to_rect', 'zoom'), ('Subplots', 'Configure subplots' , 'subplots' , 'configure_subplots'), (None, None, None, None), ('Save', 'Save the figure', 'filesave', 'save_figure')) #

atualização ( ) [fonte] #: Redefina a pilha de eixos.

zoom ( * args ) [fonte] #

exceção matplotlib.backend_bases. NonGuiException [fonte] #

Bases:Exception

Gerado ao tentar mostrar uma figura em um back-end não GUI.

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

Bases:Event

Um evento escolhido.

Este evento é acionado quando o usuário escolhe um local na tela suficientemente próximo a um artista que pode ser selecionado com Artist.set_picker.

Um PickEvent possui vários atributos especiais além daqueles definidos pela Eventclasse pai.

Exemplos

Vincule uma função on_pick()para selecionar eventos, que imprime as coordenadas do ponto de dados selecionado:

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 do mouseMouseEvent: O evento do mouse que gerou a seleção.
artistamatplotlib.artist.Artist: O artista escolhido. Observe que os artistas não podem ser escolhidos por padrão (consulte Recursos Artist.set_picker).
outro: Atributos adicionais podem estar presentes dependendo do tipo de objeto escolhido; por exemplo, uma Line2Descolha pode definir atributos extras diferentes de uma PatchCollectionescolha.

classe matplotlib.backend_bases. RendererBase [fonte] #

Bases:object

Uma classe base abstrata para lidar com operações de desenho/renderização.

Os seguintes métodos devem ser implementados no back-end para funcionalidade total (embora apenas a implementação draw_pathsozinha forneça um back-end altamente capaz):

draw_path
draw_image
draw_gouraud_triangle

Os seguintes métodos devem ser implementados no back-end por motivos de otimização:

draw_text
draw_markers
draw_path_collection
draw_quad_mesh

close_group ( s ) [fonte] #

Feche um elemento de agrupamento com label s .

Usado apenas pelo renderizador SVG.

draw_gouraud_triangle ( gc , pontos , cores , transformar ) [fonte] #

Desenhe um triângulo sombreado por Gouraud.

Parâmetros :

gcGraphicsContextBase: O contexto gráfico.
pontos (3, 2) tipo array: Matriz de (x, y) pontos para o triângulo.
cores (3, 4) tipo array: Cores RGBA para cada ponto do triângulo.
transformarmatplotlib.transforms.Transform: Uma transformação afim para aplicar aos pontos.

draw_gouraud_triangles ( gc , triângulos_array , colors_array , transform ) [fonte] #

Desenhe uma série de triângulos de Gouraud.

Parâmetros :

pontos (N, 3, 2) tipo matriz: Matriz de N (x, y) pontos para os triângulos.
cores (N, 3, 4) tipo matriz: Matriz de N cores RGBA para cada ponto dos triângulos.
transformarmatplotlib.transforms.Transform: Uma transformação afim para aplicar aos pontos.

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

Desenhe uma imagem RGBA.

Parâmetros :

gcGraphicsContextBase: Um contexto gráfico com informações de recorte.
x escalar: A distância em unidades físicas (ou seja, pontos ou pixels) do lado esquerdo da tela.
y escalar: A distância em unidades físicas (ou seja, pontos ou pixels) da parte inferior da tela.
im (N, M, 4) semelhante a uma matriz de np.uint8: Uma matriz de pixels RGBA.
transformarmatplotlib.transforms.Affine2DBase: Se e somente se o back-end concreto for escrito de forma que option_scale_imageretorne True, uma transformação afim (isto é, um Affine2DBase) poderá ser passada para draw_image. O vetor de translação da transformação é dado em unidades físicas (ou seja, pontos ou pixels). Observe que a transformação não substitui x e y , e deve ser aplicada antes de traduzir o resultado por x e y (isso pode ser feito adicionando x e y ao vetor de translação definido por transform ).

draw_markers ( gc , marcador_caminho , marcador_trans , caminho , trans , rgbFace = Nenhum ) [fonte] #

Desenhe um marcador em cada um dos vértices do caminho (excluindo os pontos de controle).

A implementação base (fallback) faz várias chamadas para draw_path. Os back-ends podem querer substituir esse método para desenhar o marcador apenas uma vez e reutilizá-lo várias vezes.

Parâmetros :

gcGraphicsContextBase: O contexto gráfico.
marcador_transmatplotlib.transforms.Transform: Uma transformação afim aplicada ao marcador.
transmatplotlib.transforms.Transform: Uma transformação afim aplicada ao caminho.

draw_path ( gc , path , transform , rgbFace = None ) [source] #: Desenhe uma Pathinstância usando a transformação afim fornecida.

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

Desenhe uma coleção de caminhos .

Cada caminho é primeiro transformado pela entrada correspondente em all_transforms (uma lista de (3, 3) matrizes) e depois por master_transform . Eles são então convertidos pela entrada correspondente em offsets , que foi primeiro transformada por offset_trans .

facecolors , edgecolors , linewidths , linestyles e antialiased são listas que definem as propriedades correspondentes.

offset_position não é usado agora, mas o argumento é mantido para compatibilidade com versões anteriores.

A implementação base (fallback) faz várias chamadas para draw_path. Os back-ends podem querer substituir isso para renderizar cada conjunto de dados de caminho apenas uma vez e, em seguida, referenciar esse caminho várias vezes com diferentes deslocamentos, cores, estilos, etc. Os métodos do gerador _iter_collection_raw_pathse _iter_collectionsão fornecidos para ajudar (e padronizar) a implementação através de back-ends. É altamente recomendável usar esses geradores, para que as alterações no comportamento de draw_path_collectionpossam ser feitas globalmente.

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

Desenhe uma malha quadriculada.

A implementação base (fallback) converte o quadmesh em caminhos e, em seguida, chama draw_path_collection.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None ) [fonte] #

draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [source] #

Desenhe uma instância de texto.

Parâmetros :

gcGraphicsContextBase: O contexto gráfico.
x flutuar: A localização x do texto nas coordenadas de exibição.
você flutua: A localização y da linha de base do texto nas coordenadas de exibição.
s str: A sequência de texto.
suportematplotlib.font_manager.FontProperties: As propriedades da fonte.
ângulo flutuante: O ângulo de rotação em graus no sentido anti-horário.
mtextmatplotlib.text.Text: O objeto de texto original a ser renderizado.

Notas

Observação para implementadores de back-end:

Quando você está tentando determinar se acertou sua caixa delimitadora (que é o que permite que o layout/alinhamento do texto funcione corretamente), é útil alterar a linha em text.py:

if 0: bbox_artist(self, renderer)

para se 1 e, em seguida, a caixa delimitadora real será plotada junto com seu texto.

flipy ( ) [fonte] #

Retorna se os valores de y aumentam de cima para baixo.

Observe que isso afeta apenas o desenho de textos.

get_canvas_width_height ( ) [fonte] #: Retorna a largura e a altura da tela nas coordenadas de exibição.

get_image_magnification ( ) [fonte] #: Obtenha o fator pelo qual ampliar as imagens passadas para draw_image. Permite que um back-end tenha imagens em uma resolução diferente de outros artistas.

get_texmanager ( ) [fonte] #: Retorne a TexManagerinstância.

get_text_width_height_descent ( s , prop , ismath ) [fonte] #: Obtenha a largura, altura e descida (deslocamento da parte inferior até a linha de base), em coordenadas de exibição, da string s com prop .FontProperties

new_gc ( ) [fonte] #: Retorne uma instância de um GraphicsContextBase.

open_group ( s , gid = Nenhum ) [fonte] #

Abra um elemento de agrupamento com label s e gid (se definido) como id.

Usado apenas pelo renderizador SVG.

option_image_nocomposite ( ) [fonte] #

Retorna se a composição da imagem pelo Matplotlib deve ser ignorada.

Os back-ends raster geralmente devem retornar False (deixando o rasterizador de nível C cuidar da composição da imagem); back-ends vetoriais geralmente devem retornar .not rcParams["image.composite_image"]

option_scale_image ( ) [fonte] #: Retorna se as transformações afins arbitrárias draw_imagesão suportadas (Verdadeiro para a maioria dos back-ends de vetor).

points_to_pixels ( pontos ) [fonte] #

Converta pontos em unidades de exibição.

Você precisa substituir esta função (a menos que seu back-end não tenha um dpi, por exemplo, postscript ou svg). Alguns sistemas de imagem assumem algum valor para pixels por polegada:

points to pixels = points * pixels_per_inch/72 * dpi/72

Parâmetros :

pontos float ou array-like: um float ou um array numpy de float

Devoluções :

Pontos convertidos em pixels

start_filter ( ) [fonte] #

Mude para um renderizador temporário para efeitos de filtragem de imagem.

Atualmente suportado apenas pelo renderizador de agregação.

start_rasterizing ( ) [fonte] #

Alterne para o renderizador raster.

Usado por MixedModeRenderer.

stop_filter ( filter_func ) [fonte] #

Volte para o renderizador original. O conteúdo do renderizador temporário é processado com o filter_func e é desenhado no renderizador original como uma imagem.

Atualmente suportado apenas pelo renderizador de agregação.

stop_rasterizing ( ) [fonte] #

Volte para o renderizador de vetor e desenhe o conteúdo do renderizador raster como uma imagem no renderizador de vetor.

Usado por MixedModeRenderer.

classe matplotlib.backend_bases. ResizeEvent ( nome , tela ) [fonte] #

Bases:Event

Um evento acionado por um redimensionamento da tela.

Um ResizeEvent possui vários atributos especiais além daqueles definidos pela Eventclasse pai.

Atributos :

largura int: Largura da tela em pixels.
altura int: Altura da tela em pixels.

classe matplotlib.backend_bases. ShowBase [fonte] #

Bases:_Backend

Classe base simples para gerar uma show()função em backends.

A subclasse deve substituir o mainloop()método.

classe matplotlib.backend_bases. TimerBase ( intervalo = Nenhum , retornos de chamada = Nenhum ) [fonte] #

Bases:object

Uma classe base para fornecer eventos de timer, útil para animações de coisas. Os back-ends precisam implementar alguns métodos específicos para usar seus próprios mecanismos de temporização para que os eventos do timer sejam integrados em seus loops de eventos.

As subclasses devem substituir os seguintes métodos:

_timer_start: código específico de back-end para iniciar o cronômetro.
_timer_stop: código específico de back-end para parar o cronômetro.

As subclasses também podem sobrescrever os seguintes métodos:

_timer_set_single_shot: Código para configurar o timer para o modo de operação de disparo único, se suportado pelo objeto timer. Caso contrário, a Timer própria classe armazenará o sinalizador e o _on_timermétodo deverá ser substituído para suportar tal comportamento.
_timer_set_interval: Código para definir o intervalo no timer, se houver um método para fazê-lo no objeto timer.
_on_timer: A função interna que qualquer objeto timer deve chamar, que irá lidar com a tarefa de executar todos os retornos de chamada que foram definidos.

Parâmetros :

intervalo int, padrão: 1000ms: O tempo entre os eventos do timer em milissegundos. Será armazenado como timer.interval.
lista de callbacks [tuple[callable, tuple, dict]]: Lista de tuplas (func, args, kwargs) que serão chamadas em eventos de timer. Esta lista é acessível timer.callbackse pode ser manipulada diretamente, ou as funções add_callbacke remove_callbackpodem ser usadas.

add_callback ( func , * args , ** kwargs ) [fonte] #

Registre a função a ser chamada pelo timer quando o evento for disparado. Quaisquer argumentos adicionais fornecidos serão passados para func .

Essa função retorna func , o que possibilita seu uso como decorador.

intervalo de propriedade #: O tempo entre os eventos do timer, em milissegundos.

remove_callback ( func , * args , ** kwargs ) [fonte] #

Remova func da lista de retornos de chamada.

args e kwargs são opcionais e usados para distinguir entre cópias da mesma função registrada para serem chamadas com argumentos diferentes. Esse comportamento é obsoleto. No futuro, não será mais considerado; para manter um retorno de chamada específico removível por si só, passe-o como um objeto.*args, **kwargsadd_callbackfunctools.partial

propriedade single_shot #: Se este cronômetro deve parar após uma única execução.

início ( intervalo = Nenhum ) [fonte] #

Inicie o objeto timer.

Parâmetros :

intervalo int, opcional: Intervalo do temporizador em milissegundos; substitui um intervalo definido anteriormente, se fornecido.

parar ( ) [fonte] #: Pare o cronômetro.

classe matplotlib.backend_bases. ToolContainerBase ( gerenciador de ferramentas ) [fonte] #

Bases:object

Classe base para todos os contêineres de ferramentas, por exemplo, barras de ferramentas.

Atributos :

gerente de ferramentasToolManager: As ferramentas com as quais este ToolContainerquer se comunicar.

add_tool ( ferramenta , grupo , posição = -1 ) [fonte] #

Adicione uma ferramenta a este contêiner.

Parâmetros :

ferramenta tool_like: A ferramenta a adicionar, consulte ToolManager.get_tool.
grupo str: O nome do grupo ao qual adicionar esta ferramenta.
posição int, padrão: -1: A posição dentro do grupo para colocar esta ferramenta.

add_toolitem ( nome , grupo , posição , imagem , descrição , alternar ) [fonte] #

Adicione um item de ferramenta ao contêiner.

Este método deve ser implementado por back-end.

O retorno de chamada associado ao evento de clique do botão deve ser exatamente self.trigger_tool(name) .

Parâmetros :

nome str

Nome da ferramenta a adicionar, é usado como ID da ferramenta e como rótulo padrão dos botões.

grupo str

Nome do grupo ao qual esta ferramenta pertence.

posição int

Posição da ferramenta dentro do seu grupo, se -1 vai no final.

imagem str

Nome do arquivo da imagem para o botão ou None.

descrição str

Descrição da ferramenta, usada para as dicas de ferramentas.

alternar bool

True: O botão é uma alternância (mude o estado pressionado/não pressionado entre cliques consecutivos).
False: O botão é um botão normal (retorna ao estado não pressionado após a liberação).

remove_toolitem ( nome ) [fonte] #

Remova um item de ferramenta do arquivo ToolContainer.

Este método deve ser implementado por back-end.

Chamado quando ToolManageremite um tool_removed_event.

Parâmetros :

nome str: Nome da ferramenta a ser removida.

set_message ( s ) [fonte] #

Exibir uma mensagem na barra de ferramentas.

Parâmetros :

s str: Mensagem de texto.

toggle_toolitem ( nome , alternado ) [fonte] #

Alternar o item de ferramenta sem disparar o evento.

Parâmetros :

nome str: Id da ferramenta para alternar.
bool alternado: Se deve definir esta ferramenta como alternada ou não.

trigger_tool ( nome ) [fonte] #

Acione a ferramenta.

Parâmetros :

nome str: Nome (id) da ferramenta acionada de dentro do contêiner.

matplotlib.backend_bases. button_press_handler ( evento , tela = Nenhum , barra de ferramentas = Nenhum ) [fonte] #

As ações padrão do botão Matplotlib para botões extras do mouse.

Os parâmetros são como para key_press_handler, exceto que o evento é um MouseEvent.

matplotlib.backend_bases. get_registered_canvas_class ( formato ) [fonte] #: Retorna a tela padrão registrada para o formato de arquivo fornecido. Lida com a importação adiada do back-end necessário.

matplotlib.backend_bases. key_press_handler ( evento , tela = Nenhum , barra de ferramentas = Nenhum ) [fonte] #

Implemente as ligações de teclas padrão do Matplotlib para a tela e a barra de ferramentas descritas em Atalhos de teclado de navegação .

Parâmetros :

eventoKeyEvent: Um evento de pressionamento/liberação de tecla.
tela FigureCanvasBase, padrão:event.canvas: A instância de tela específica de back-end. Este parâmetro é mantido para compatibilidade com versões anteriores, mas, se definido, deve ser sempre igual a event.canvas.
barra de ferramentas NavigationToolbar2, padrão:event.canvas.toolbar: A barra de ferramentas do cursor de navegação. Este parâmetro é mantido para compatibilidade com versões anteriores, mas, se definido, deve ser sempre igual a event.canvas.toolbar.

matplotlib.backend_bases. register_backend ( formato , backend , descrição = Nenhum ) [fonte] #

Registre um back-end para salvar em um determinado formato de arquivo.

Parâmetros :

formato str: Extensão de arquivo
string do módulo de back -end ou classe de tela: Back-end para lidar com a saída do arquivo
descrição str, padrão: "": Descrição do tipo de arquivo.

matplotlib.backend_bases#

`matplotlib.backend_bases`#