matplotlib.animation.funcanimation #
- classe matplotlib.animation. FuncAnimation ( fig , func , frames = None , init_func = None , fargs = None , save_count = None , * , cache_frame_data = True , ** kwargs ) [fonte] #
Crea un'animazione chiamando ripetutamente una funzione func .
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 :
- Figura
Figure L'oggetto figura utilizzato per ottenere eventi necessari, come disegnare o ridimensionare.
- funzione richiamabile
La funzione da chiamare su ogni frame. Il primo argomento sarà il prossimo valore in frame . Eventuali argomenti posizionali aggiuntivi possono essere forniti tramite il parametro FARGS .
La firma richiesta è:
def func(frame, *fargs) -> iterable_of_artists
Se , Func deve restituire un iterabile di tutti gli artisti che sono stati modificati o creati. Queste informazioni vengono utilizzate dall'algoritmo blitting per determinare quali parti della figura devono essere aggiornate. Il valore di ritorno non è utilizzato se e può essere omesso in quel caso.
blit == Trueblit == False- frame iteble, int, funzionalità del generatore o nessuno, opzionale
Fonte di dati per passare func e ogni frame dell'animazione
Se un iterabile, quindi usa semplicemente i valori forniti. Se l'iterabile ha una lunghezza, sovrascriverà il salva_count kwarg.
Se un numero intero, allora equivalente al passaggio
range(frames)Se una funzione del generatore, deve avere la firma:
def gen_function() -> obj
Se nessuno , allora equivalente al passaggio
itertools.count.
In tutti questi casi, i valori in frame vengono semplicemente passati alla func fornita dall'utente e quindi possono essere di qualsiasi tipo.
- init_func richiamabile, facoltativo
Una funzione utilizzata per disegnare una cornice chiara. Se non fornito, verranno utilizzati i risultati del disegno dal primo elemento nella sequenza dei fotogrammi. Questa funzione verrà chiamata una volta prima del primo frame.
La firma richiesta è:
def init_func() -> iterable_of_artists
If , init_func deve restituire un iterabile di artisti da ridisegnare. Queste informazioni vengono utilizzate dall'algoritmo blitting per determinare quali parti della figura devono essere aggiornate. Il valore restituito è inutilizzato se e può essere omesso in tal caso.
blit == Trueblit == False- tupla fargs o None, facoltativo
Argomenti aggiuntivi da passare a ciascuna chiamata a func .
- salve_count int, impostazione predefinita: 100
Fallback per il numero di valori dai frame alla cache. Viene utilizzato solo se il numero di frame non può essere dedotto da frames , ovvero quando è un iteratore senza lunghezza o un generatore.
- intervallo int, predefinito: 200
Ritardo tra frame in millisecondi.
- ripetizione_delay int, predefinito: 0
Il ritardo in millisecondi tra le esecuzioni consecutive dell'animazione, se repeat è True.
- Ripeti bool, impostazione predefinita: true
Se l'animazione si ripete al termine della sequenza di fotogrammi.
- blit bool, predefinito: falso
Indica se il blitting viene utilizzato per ottimizzare il disegno. Nota: quando si utilizzano blitting, qualsiasi artisti animati verrà disegnato in base al loro Zorder; tuttavia, verranno sorteggiati sopra tutti gli artisti precedenti, indipendentemente dal loro ordine z.
- cache_frame_data booleano, predefinito: vero
Se i dati del frame sono memorizzati nella cache. La disabilitazione della cache potrebbe essere utile quando i frame contengono oggetti di grandi dimensioni.
- Figura
- __init__ ( fig , func , frame = nessuno , init_func = none , fargs = nessuno , save_count = nessuno , * , cache_frame_data = true , ** kwargs ) [ sorgente] #
Metodi
__init__(fig, func[, frame, init_func, ...])Restituisce una nuova sequenza di informazioni sul frame.
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.