matplotlib.animation.FuncAnimation #
- classe matplotlib.animation. FuncAnimation ( fig , func , frames = None , init_func = None , fargs = None , save_count = None , * , cache_frame_data = True , ** kwargs ) [source] #
Faz uma animação chamando repetidamente uma função func .
Observação
Você deve armazenar a Animação criada em uma variável que viva enquanto a animação for executada. Caso contrário, o objeto Animation será coletado como lixo e a animação será interrompida.
- Parâmetros :
- FIG
Figure
O objeto de figura usado para obter os eventos necessários, como desenhar ou redimensionar.
- func callable
A função a ser chamada em cada quadro. O primeiro argumento será o próximo valor em quadros . Quaisquer argumentos posicionais adicionais podem ser fornecidos por meio do parâmetro fargs .
A assinatura necessária é:
def func(frame, *fargs) -> iterable_of_artists
Se , func deve retornar um iterável de todos os artistas que foram modificados ou criados. Esta informação é usada pelo algoritmo blitting para determinar quais partes da figura devem ser atualizadas. O valor de retorno não é usado se e pode ser omitido nesse caso.
blit == True
blit == False
- quadros iteráveis, int, função geradora ou Nenhum, opcional
Fonte de dados para passar func e cada quadro da animação
Se for iterável, basta usar os valores fornecidos. Se o iterável tiver um comprimento, ele substituirá o save_count kwarg.
Se for um número inteiro, então equivalente a passar
range(frames)
Se for uma função de gerador, então deve ter a assinatura:
def gen_function() -> obj
Se None , então equivalente a passagem
itertools.count
.
Em todos esses casos, os valores em quadros são simplesmente passados para a função fornecida pelo usuário e, portanto, podem ser de qualquer tipo.
- init_func chamável, opcional
Uma função usada para desenhar um quadro claro. Se não for fornecido, serão usados os resultados do sorteio do primeiro item na sequência de quadros. Esta função será chamada uma vez antes do primeiro quadro.
A assinatura necessária é:
def init_func() -> iterable_of_artists
Se , init_func deve retornar um iterável de artistas a serem redesenhados. Esta informação é usada pelo algoritmo blitting para determinar quais partes da figura devem ser atualizadas. O valor de retorno não é usado se e pode ser omitido nesse caso.
blit == True
blit == False
- tupla fargs ou None, opcional
Argumentos adicionais a serem passados para cada chamada para func .
- save_count int, padrão: 100
Fallback para o número de valores de quadros para cache. Isso só é usado se o número de quadros não puder ser inferido a partir de quadros , ou seja, quando for um iterador sem comprimento ou um gerador.
- intervalo int, padrão: 200
Atraso entre quadros em milissegundos.
- repeat_delay int, padrão: 0
O atraso em milissegundos entre execuções consecutivas de animações, se repeat for True.
- repetir bool, padrão: True
Se a animação se repete quando a sequência de quadros é concluída.
- blit bool, padrão: Falso
Se o blitting é usado para otimizar o desenho. Nota: ao usar blitting, qualquer artista animado será desenhado de acordo com sua zorder; no entanto, eles serão desenhados em cima de qualquer artista anterior, independentemente de sua zorder.
- cache_frame_data bool, padrão: True
Se os dados do quadro são armazenados em cache. Desativar o cache pode ser útil quando os quadros contêm objetos grandes.
- FIG
- __init__ ( fig , func , frames = Nenhum , init_func = Nenhum , fargs = Nenhum , save_count = Nenhum , * , cache_frame_data = True , ** kwargs ) [source] #
Métodos
__init__
(fig, func[, frames, init_func, ...])Retorna uma nova sequência de informações de quadro.
Retorna uma nova sequência de informações de quadro salvas/em cache.
pause
()Pause a animação.
resume
()Retome a animação.
save
(nome do arquivo [, gravador, fps, dpi, codec, ...])Salve a animação como um arquivo de filme desenhando cada quadro.
to_html5_video
([embed_limit])Converta a animação em uma
<video>
tag HTML5.to_jshtml
([fps, embed_frames, default_mode])Gere a representação HTML da animação.