anim.create(ruta)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de un GIF animado, se extraen los frames y la duración de cada uno... al ser un objeto de animlib, se pueden usar sobre este objeto todas las funciones de la librería.
--
-- Parámetros:
--     ruta: String con la ruta del GIF animado.
 
 
anim.create(imgs, tiempo)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de los frames imgs, las entradas de esta tabla, deberán ser numéricas y su contenido, puede ser una ruta con una imagen a cargar o una imagen previamente cargada.
--
-- Parámetros:
--     imgs: Tabla con rutas o imágenes, o entrelazados (es decir que pueden ser strings e imágenes).
--     tiempo: Un número con el tiempo en milisegundos que durará cada frame.
 
 
anim.create(imgs, tiempos)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de los frames imgs, las entradas de esta tabla, deberán ser numéricas y su contenido, puede ser una ruta con una imagen a cargar o una imagen previamente cargada. Cada cuadro de la animación, tendrá su propio tiempo de duración, que será una entrada de la tabla tiempos.
--
-- Parámetros:
--     imgs: Tabla con rutas o imágenes, o entrelazados (es decir que pueden ser strings e imágenes).
--     tiempos: Tabla con la duración de cada frame en milisegundos (se espera que la longitud de esta tabla, sea la misma que la de imgs).
 
 
anim.create(spritesheet, ancho, alto, tiempo)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de una hoja de sprites, los cuadros, se obtendrán de la imagen spritesheet (debe ser previamente cargada con image.load), y serán dividos de izquierda a derecha y de arriba hacia abajo. Los cuadros se dividen en partes iguales según el ancho y alto especificado.
--
-- Parámetros:
--     spritesheet: Una imagen con todos los frames en ella.
--     ancho: Un número con el ancho de cada frame recortado.
--     alto: Un número con el alto de cada frame recortado.
--     tiempo: Un número con el tiempo en milisegundos que durará cada frame.
 
 
 
anim.create(spritesheet, ancho, alto, tiempos)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de una hoja de sprites, los cuadros, se obtendrán de la imagen spritesheet (debe ser previamente cargada con image.load), y serán dividos de izquierda a derecha y de arriba hacia abajo. Los cuadros se dividen en partes iguales según el ancho y alto especificado.
--
-- Parámetros:
--     spritesheet: Una imagen con todos los frames en ella.
--     ancho: Un número con el ancho de cada frame recortado.
--     alto: Un número con el alto de cada frame recortado.
--     tiempos: Tabla con la duración de cada frame en milisegundos (se espera que la longitud de esta tabla, sea la misma que la de imgs).
 
 
anim.create(ruta, ancho, alto, tiempo)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de una hoja de sprites, los cuadros, se obtendrán de la imagen localizada en la ruta especificada, y serán dividos de izquierda a derecha y de arriba hacia abajo. Los cuadros se dividen en partes iguales según el ancho y alto especificado.
--
-- Parámetros:
--     spritesheet: Una ruta a una imagen que tenga todos los frames en ella.
--     ancho: Un número con el ancho de cada frame recortado.
--     alto: Un número con el alto de cada frame recortado.
--     tiempo: Un número con el tiempo en milisegundos que durará cada frame.
 
 
 
anim.create(ruta, ancho, alto, tiempos)
--
-- Descripción:
--     Crea y devuelve un objeto de animación a partir de una hoja de sprites, los cuadros, se obtendrán de la imagen localizada en la ruta especificada, y serán dividos de izquierda a derecha y de arriba hacia abajo. Los cuadros se dividen en partes iguales según el ancho y alto especificado.
--
-- Parámetros:
--     spritesheet: Una ruta a una imagen que tenga todos los frames en ella.
--     ancho: Un número con el ancho de cada frame recortado.
--     alto: Un número con el alto de cada frame recortado.
--     tiempos: Tabla con la duración de cada frame en milisegundos (se espera que la longitud de esta tabla, sea la misma que la de imgs).

anim.blit(animacion,x,y) o animacion:blit(x,y)
-- blitea la animación en dichas coordenadas
 
anim.fxtint(animacion,x,y,color) o animacion:fxtint(x,y,color)
-- igual que el blit, pero con un efecto de tintado
 
anim.blend(animacion,x,y,alfa) o animacion:blend(x,y,alfa)
-- igual que el blit, pero con un efecto de transparentado
 
anim.rotate(animacion,angulo) o animacion:rotate(angulo)
-- como el image.rotate, rota la animación
 
anim.start(animacion) o animacion:start()
-- empieza o reanuda la animación
 
anim.pause(animacion) o animacion:pause()
-- pausa la animación
 
anim.reset(animacion) o animacion:reset()
-- reinicia una animación, dejándola en el primer frame
-- si la animación estaba pausada, seguirá pausada
-- si la animación estaba corriendo, seguirá corriendo
 
anim.free(animacion) o animacion:free()
-- libera las imágenes de la animación y también se liberan las de la tabla que recibió al crearlas, ya que en si, es la misma tabla la que se libera
 
anim.setframe(animacion,frame) o animacion:setframe(frame)
-- cambia el cuadro actual que se está mostrando de la animación por el que se ponga, además, si el frame está fuera de límites (frame mayor a la cantidad de cuadros), se setea al último frame
 
anim.fxadd(animacion,x,y,color) o animacion:fxadd(x,y,color)
-- igual que el blit, pero con un efecto de suma de colores
 
anim.fxsub(animacion,x,y,color) o animacion:fxsub(x,y,color)
-- igual que el blit, pero con un efecto de resta de colores
 
anim.currentframe(animacion) o animacion:currentframe()
-- devuelve el número del frame actual

anim.createloadtable(ruta, inicio, fin, extension, cifras)
--
-- Descripción:
--     Genera una tabla con rutas de imágenes secuenciales, a partir de los parámetros dados. Está pensada para ser usada en conjunto con las funciones de creación de imágenes que permitan recibir tablas con rutas para la carga de imágenes.
--
-- Parámetros:
--     ruta: String con la ruta inicial (Ej: "frame")
--     inicio: Número con el frame inicial (Ej: 0)
--     fin: Número con el frame final (Ej: 10)
--     extension: String con la extensión de todos los frames (Ej: "png")
--     cifras: Este parámetro es opcional, sirve para que cada índice del frame (en el rango de inicio y fin), sea autoformateado a esta cantidad de cifras (Ej: 2)
--
-- Ejemplos:
--     Con los parámetros de ejemplo anteriores:
--     anim.createloadtable("frame", 0, 10, "png", 2)
--     Se obtendrían los nombres "frame00.png" "frame01.png" "frame02.png" ..... "frame10.png"
--
--     Si no se especificaran la cantidad de cifras:
--     anim.createloadtable("frame", 0, 10, "png")
--     Se obtendrían los nombres "frame0.png" "frame1.png" "frame2.png" ..... "frame10.png"

dofile("animlib.lua") -- cargamos la librería de animaciones
migif = anim.create("migif.gif") -- cargamos el gif y creamos la animación
migif:start() -- que empiece a reproducir la animación
 
while true do
	migif:blit(0,0) -- mostramos el gif
	screen.flip() -- actualizamos pantalla
end

dofile("animlib.lua") -- cargamos la librería de animaciones
 
rutas = anim.createloadtable("cuadros/cuadro", 1, 20, "png")
mianim = anim.create(rutas, 7) -- creamos la animación a partir de las rutas creadas, con un tiempo de 7 milisegundos entre cuadro y cuadro
mianim:start() -- que empiece a reproducir la animación
 
while true do
	mianim:blit(0,0) -- mostramos el gif
	screen.flip() -- actualizamos pantalla
end