matplotlib.animation.FuncAnimation

clase matplotlib.animación. FuncAnimation ( fig , func , frames = Ninguno , init_func = Ninguno , fargs = Ninguno , save_count = Ninguno , * , cache_frame_data = True , ** kwargs )

Realiza una animación llamando repetidamente a una función func .

Nota

Debe almacenar la Animación creada en una variable que viva mientras la animación deba ejecutarse. De lo contrario, el objeto Animation se recolectará como basura y la animación se detendrá.

Parámetros :

higoFigure

El objeto de figura se utiliza para obtener los eventos necesarios, como dibujar o cambiar el tamaño.

función invocable

La función a llamar en cada fotograma. El primer argumento será el siguiente valor en fotogramas . Cualquier argumento posicional adicional se puede proporcionar a través del parámetro fargs .

La firma requerida es:

def func(frame, *fargs) -> iterable_of_artists

Si , func debe devolver una iteración de todos los artistas que se modificaron o crearon. El algoritmo de borrado utiliza esta información para determinar qué partes de la figura deben actualizarse. El valor de retorno no se usa si y se puede omitir en ese caso.blit == Trueblit == False

marcos iterables, int, función de generador o Ninguno, opcional

Fuente de datos para pasar func y cada cuadro de la animación .

• Si es iterable, simplemente use los valores proporcionados. Si el iterable tiene una longitud, anulará el kwarg save_count.

• Si es un número entero, entonces equivalente a pasarrange(frames)

• Si una función de generador, entonces debe tener la firma:

  def gen_function() -> obj
  

• Si Ninguno , entonces equivalente a aprobar itertools.count.

En todos estos casos, los valores en los marcos simplemente se pasan a la función proporcionada por el usuario y , por lo tanto, pueden ser de cualquier tipo.

init_func invocable, opcional

Una función utilizada para dibujar un marco claro. Si no se proporciona, se utilizarán los resultados del dibujo del primer elemento de la secuencia de fotogramas. Esta función se llamará una vez antes del primer cuadro.

La firma requerida es:

def init_func() -> iterable_of_artists

Si , init_func debe devolver una iteración de artistas para volver a dibujar. El algoritmo de borrado utiliza esta información para determinar qué partes de la figura deben actualizarse. El valor de retorno no se usa si y se puede omitir en ese caso.blit == Trueblit == False

tupla fargs o Ninguno, opcional

Argumentos adicionales para pasar a cada llamada a func .

save_count int, predeterminado: 100

Reserva para el número de valores de los marcos a la memoria caché. Esto solo se usa si el número de cuadros no se puede deducir de los cuadros , es decir, cuando es un iterador sin longitud o un generador.

intervalo int, predeterminado: 200

Retardo entre fotogramas en milisegundos.

repetir_retardo int, predeterminado: 0

El retraso en milisegundos entre ejecuciones de animación consecutivas, si repetir es Verdadero.

repetir bool, por defecto: Verdadero

Si la animación se repite cuando se completa la secuencia de fotogramas.

blit bool, predeterminado: Falso

Si se usa blitting para optimizar el dibujo. Nota: al usar blitting, los artistas animados se dibujarán de acuerdo con su zorder; sin embargo, se dibujarán sobre cualquier artista anterior, independientemente de su zorder.

cache_frame_data bool, predeterminado: Verdadero

Si los datos del marco se almacenan en caché. Deshabilitar el caché puede ser útil cuando los marcos contienen objetos grandes.

__init__ ( fig , func , frames = Ninguno , init_func = Ninguno , fargs = Ninguno , save_count = Ninguno , * , cache_frame_data = True , ** kwargs )

Métodos

__init__(fig, func[, marcos, init_func, ...])
new_frame_seq()	Devuelve una nueva secuencia de información de cuadro.
new_saved_frame_seq()	Devuelve una nueva secuencia de información de fotogramas guardados/almacenados.
pause()	Pausa la animación.
resume()	Reanuda la animación.
save(nombre de archivo [, escritor, fps, dpi, códec, ...])	Guarde la animación como un archivo de película dibujando cada cuadro.
to_html5_video([incrustar_límite])	Convierta la animación en una etiqueta HTML5 <video>.
to_jshtml([fps, incrustar_fotogramas, modo_predeterminado])	Genere una representación HTML de la animación.

new_frame_seq ( )

Devuelve una nueva secuencia de información de cuadro.

new_saved_frame_seq ( )

Devuelve una nueva secuencia de información de fotogramas guardados/almacenados.