matplotlib.animation.Animation

classe matplotlib.animation. Animação ( fig , event_source = None , blit = False )

Uma classe base para animações.

Essa classe não pode ser usada como está e deve ser uma subclasse para fornecer o comportamento necessário.

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 :

FIGFigure

O objeto de figura usado para obter os eventos necessários, como desenhar ou redimensionar.

objeto event_source , opcional

Uma classe que pode executar um retorno de chamada quando os eventos desejados são gerados, bem como ser interrompido e iniciado.

Os exemplos incluem cronômetros (consulte Recursos TimedAnimation) e notificações do sistema de arquivos.

blit bool, padrão: Falso

Se o blitting é usado para otimizar o desenho.

Veja também

FuncAnimation,ArtistAnimation

__init__ ( fig , event_source = None , blit = False )

Métodos

__init__(fig[, event_source, blit])
new_frame_seq()	Retorna uma nova sequência de informações de quadro.
new_saved_frame_seq()	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.

new_frame_seq ( )

Retorna uma nova sequência de informações de quadro.

new_saved_frame_seq ( )

Retorna uma nova sequência de informações de quadro salvas/em cache.

pausa ( )

Pause a animação.

resumir ( )

Retome a animação.

save ( filename , writer = None , fps = None , dpi = None , codec = None , bitrate = None , extra_args = None , metadata = None , extra_anim = None , savefig_kwargs = None , * , progress_callback = None )

Salve a animação como um arquivo de filme desenhando cada quadro.

Parâmetros :

nome do arquivo str

O nome do arquivo de saída, por exemplo, mymovie.mp4.

Writer MovieWriterou str, padrão: rcParams["animation.writer"](padrão: 'ffmpeg')

Uma MovieWriterinstância a ser usada ou uma chave que identifica uma classe a ser usada, como 'ffmpeg'.

fps int, opcional

Taxa de quadros do filme (por segundo). Se não for definido, a taxa de quadros do intervalo de quadros da animação.

dpi flutuante, padrão: rcParams["savefig.dpi"](padrão: 'figure')

Controla os pontos por polegada para os quadros do filme. Juntamente com o tamanho da figura em polegadas, isso controla o tamanho do filme.

codec str, padrão: rcParams["animation.codec"](padrão: 'h264').

O codec de vídeo a ser usado. Nem todos os codecs são suportados por um determinado arquivo MovieWriter.

taxa de bits int, padrão: rcParams["animation.bitrate"](padrão: -1)

A taxa de bits do filme, em kilobits por segundo. Valores mais altos significam filmes de maior qualidade, mas aumentam o tamanho do arquivo. Um valor de -1 permite que o codificador de filme subjacente selecione a taxa de bits.

extra_args lista de str ou None, opcional

Argumentos de linha de comando extras passados ​​para o codificador de filme subjacente. O padrão, Nenhum, significa usar rcParams["animation.[name-of-encoder]_args"]para os gravadores integrados.

metadata dict[str, str], padrão: {}

Dicionário de chaves e valores para metadados a serem incluídos no arquivo de saída. Algumas chaves que podem ser úteis incluem: título, artista, gênero, assunto, copyright, srcform, comentário.

lista extra_anim , padrão: []

Objetos adicionais Animationque devem ser incluídos no arquivo de filme salvo. Eles precisam ser da mesma matplotlib.figure.Figureinstância. Além disso, os quadros de animação serão simplesmente combinados, portanto, deve haver uma correspondência 1:1 entre os quadros das diferentes animações.

ditado savefig_kwargs , padrão: {}

Argumentos de palavra-chave passados ​​para cada savefigchamada usada para salvar os quadros individuais.

função progress_callback , opcional

Uma função de retorno de chamada que será chamada para cada quadro para notificar o progresso do salvamento. Deve ter a assinatura

def func(current_frame: int, total_frames: int) -> Any

onde current_frame é o número do quadro atual e total_frames é o número total de quadros a serem salvos. total_frames é definido como Nenhum, se o número total de quadros não puder ser determinado. Os valores de retorno podem existir, mas são ignorados.

Código de exemplo para gravar o progresso no stdout:

progress_callback =                    lambda i, n: print(f'Saving frame {i} of {n}')

Notas

fps , codec , bitrate , extra_args e metadata são usados ​​para construir uma MovieWriterinstância e só podem ser passados ​​se o gravador for uma string. Se eles forem passados ​​como não - None e o escritor for a MovieWriter, a RuntimeErrorserá levantado.

to_html5_video ( embed_limit = None )

Converta a animação em uma <video>tag HTML5.

Isso salva a animação como um vídeo h264, codificado em base64 diretamente na tag de vídeo HTML5. Isso respeita rcParams["animation.writer"](padrão: 'ffmpeg') e rcParams["animation.bitrate"](padrão: -1). Isso também usa o intervalpara controlar a velocidade e usa o repeat parâmetro para decidir se deve fazer um loop.

Parâmetros :

embed_limit flutuante, opcional

Limite, em MB, da animação retornada. Nenhuma animação é criada se o limite for excedido. O padrão é rcParams["animation.embed_limit"](padrão: 20.0) = 20,0.

Devoluções :

str

Uma tag de vídeo HTML5 com a animação incorporada como vídeo h264 codificado em base64. Se o embed_limit for excedido, isso retornará a string "Vídeo muito grande para incorporar".

to_jshtml ( fps = None , embed_frames = True , default_mode = None )

Gere a representação HTML da animação.

Parâmetros :

fps int, opcional

Taxa de quadros do filme (por segundo). Se não for definido, a taxa de quadros do intervalo de quadros da animação.

embed_frames bool, opcional

default_mode str, opcional

O que fazer quando a animação terminar. Deve ser um dos . O padrão é if é True, caso contrário .{'loop', 'once', 'reflect'}'loop'self.repeat'once'