matplotlib.animation.Animation #

classe matplotlib.animation. Animazione ( Fig , event_source = nessuno , blit = false ) [sorgente] #

Una classe base per le animazioni.

Questa classe non è utilizzabile così com'è e dovrebbe essere sottoclassata per fornire comportamenti necessari.

Nota

È necessario archiviare l'animazione creata in una variabile che vive fintanto che l'animazione dovrebbe funzionare. In caso contrario, l'oggetto Animation verrà sottoposto a Garbage Collection e l'animazione si interromperà.

Parametri :
FiguraFigure

L'oggetto figura utilizzato per ottenere eventi necessari, come disegnare o ridimensionare.

oggetto event_source , facoltativo

Una classe che può eseguire un callback quando vengono generati eventi desiderati, oltre a essere fermato e avviato.

Gli esempi includono TimedAnimationnotifiche di timer (vedi) e file system.

blit bool, predefinito: falso

Indica se il blitting viene utilizzato per ottimizzare il disegno.

__init__ ( fig , event_source = none , blit = false ) [sorgente] #

Metodi

__init__(fig[, event_source, blit])

new_frame_seq()

Restituisce una nuova sequenza di informazioni sul frame.

new_saved_frame_seq()

Restituisce una nuova sequenza di informazioni sul frame salvate/memorizzate nella cache.

pause()

Metti in pausa l'animazione.

resume()

Riprendi l'animazione.

save(nome file[, scrittore, fps, dpi, codec, ...])

Salva l'animazione come file filmato disegnando ogni fotogramma.

to_html5_video([incorpora_limite])

Converti l'animazione in un tag HTML5 <video>.

to_jshtml([fps, embed_frames, default_mode])

Genera una rappresentazione HTML dell'animazione.

new_frame_seq ( ) [fonte] #

Restituisce una nuova sequenza di informazioni sul frame.

new_saved_frame_seq ( ) [fonte] #

Restituisce una nuova sequenza di informazioni sul frame salvate/memorizzate nella cache.

pausa ( ) [fonte] #

Metti in pausa l'animazione.

riprendere ( ) [fonte] #

Riprendi l'animazione.

Salva ( fileName , writer = nessuno , fps = nessuno , dpi = nessuno , codec = nessuno , bitrate = none , extra_args = nessuno , metadata = nessuno , extra_anim = nessuno , savefig_kwargs = nessuno , * , progress_callback = nessuno ) [fonte] #

Salva l'animazione come file filmato disegnando ogni fotogramma.

Parametri :
nome file str

Il nome file di output, ad esempio , mymovie.mp4.

Writer MovieWritero STR, impostazione predefinita: rcParams["animation.writer"](impostazione predefinita 'ffmpeg':)

Un'istanza MovieWriterda utilizzare o una chiave che identifica una classe da utilizzare, come "FFMPEG".

fps int, facoltativo

Rate fotogramma del film (al secondo). Se non impostato, la velocità del frame dall'intervallo del frame dell'animazione.

dpi float, predefinito: rcParams["savefig.dpi"](predefinito: 'figure')

Controlla i punti per pollice per le cornici del film. Insieme alle dimensioni della figura in pollici, questo controlla le dimensioni del film.

Codec STR, impostazione predefinita: rcParams["animation.codec"](impostazione predefinita :) 'h264'.

Il codec video da utilizzare. Non tutti i codec sono supportati da un dato MovieWriter.

bitrate int, impostazione predefinita: rcParams["animation.bitrate"](predefinito -1:)

Il bitrate del film, in kilobit al secondo. Valori più alti significano film di qualità superiore, ma aumenta la dimensione del file. Un valore di -1 consente all'encoder del film sottostante di selezionare il bitrate.

extra_args elenco di str o None, facoltativo

Argomenti di linea di comando extra passati all'encoder del film sottostante. L'impostazione predefinita, nessuno, significa utilizzare rcParams["animation.[name-of-encoder]_args"]per gli scrittori incorporati.

metadati dict[str, str], default: {}

Dizionario delle chiavi e dei valori da includere i metadati nel file di output. Alcune chiavi che possono essere utili includono: titolo, artista, genere, soggetto, copyright, srcform, commento.

elenco extra_anim , predefinito: []

Ulteriori Animationoggetti che dovrebbero essere inclusi nel file del film salvato. Questi devono provenire dalla stessa matplotlib.figure.Figureistanza. Inoltre, i telai di animazione saranno semplicemente combinati, quindi dovrebbe esserci una corrispondenza 1: 1 tra i frame dalle diverse animazioni.

savefig_kwargs dict, predefinito: {}

Argomenti di parole chiave passate a ciascuna savefigchiamata utilizzata per salvare i singoli frame.

funzione progress_callback , opzionale

Una funzione di callback che verrà chiamata per ogni frame per avvisare il progresso salvificatore. Deve avere la firma

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

dove current_frame è il numero di frame corrente e total_frames è il numero totale di frame da salvare. total_frames è impostato su None, se non è possibile determinare il numero totale di frame. I valori restituiti possono esistere ma vengono ignorati.

Esempio di codice per scrivere lo stato di avanzamento su stdout:

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

Appunti

FPS , codec , bitrate , extra_args e metadati vengono utilizzati per costruire un'istanza e possono essere passati solo se lo scrittore è una stringa. Se vengono passati come non nessuno e lo scrittore è un , verrà sollevato a.MovieWriterMovieWriterRuntimeError

to_html5_video ( embed_limit = Nessuno ) [fonte] #

Converti l'animazione in un tag HTML5 <video>.

Ciò salva l'animazione come video h264, codificato in base64 direttamente nel tag video HTML5. Questo rispetta rcParams["animation.writer"](default: 'ffmpeg') e rcParams["animation.bitrate"](default: -1). Questo utilizza anche intervalper controllare la velocità e utilizza il repeat parametro per decidere se eseguire il loop.

Parametri :
embed_limit float, facoltativo

Limite, in MB, dell'animazione restituita. Non viene creata alcuna animazione se il limite viene superato. Il valore predefinito è rcParams["animation.embed_limit"](predefinito: 20.0) = 20.0.

Resi :
str

Un tag video HTML5 con l'animazione incorporata come video h264 con codifica Base64. Se embed_limit viene superato, viene restituita la stringa "Video troppo grande per essere incorporato".

to_jshtml ( fps = None , embed_frames = True , default_mode = None ) [fonte] #

Genera una rappresentazione HTML dell'animazione.

Parametri :
fps int, facoltativo

Frame rate del filmato (al secondo). Se non impostato, la velocità del frame dall'intervallo del frame dell'animazione.

embed_frames bool, facoltativo
default_mode str, facoltativo

Cosa fare al termine dell'animazione. Deve essere uno di . L'impostazione predefinita è if è True, altrimenti .{'loop', 'once', 'reflect'}'loop'self.repeat'once'