taimy
v1.0.1
Published
Taimy es una clase que ejecuta funciones dentro de un período de tiempo específico de manera más simple.
Downloads
6
Maintainers
Readme
Taimy
Taimy es una clase que ejecuta funciones dentro de un período de tiempo específico de manera más sencilla.
ver demo
instalacion:
npm i taimy
¿Qué soluciona Taimy?
Si bien setInterval y setTimeOut hacen lo mismo que Taimy, algunas diferencias son:
- La comodidad de destruir el hilo de ejecución ya sea de manera automática:
especificando una duración
, de forma manual usando los métodosdetener()
y/odestructor()
, incluso al iniciar un nuevo hilo. - La habilidad de detener y reanudar el hilo de ejecución a placer.
- La posibilidad de cambiar los parámetros de
duracion
,intervalo
,tiempo de espera
y lafunción
en tiempo de ejecución. - La seguridad de evitar interval memory leak en la mayor parte de lo posible, reejecuciones y uso indiscriminado de múltiples hilos.
Documentación
Constructor
-- (opcional) --
const instanciaTaimy = new Taimy(fn, dataTiempo);
- fn: (opcional) Función a ejecutarse, puede aceptar un cronometro como parámetro:
cronometro => { código }
- dataTiempo: (opcional) Objeto
{espera, duracion, intervalo}
debe contener como mínimo la propiedad: intervalo o espera todas estas variables aceptan valores numéricos expresados en milisegundos.
Nuevo
const instanciaTaimy = new Taimy;
instanciaTaimy.nuevo(fn,dataTiempo);
Exactamente lo mismo que el constructor solo que aquí es de forma obligatoria.
tener en cuenta que si existe un hilo de ejecución corriendo este será eliminado.
Configuración
const instanciaTaimy = new Taimy;
instanciaTaimy.funcion = function(cronometro){
/*código*/
};
instanciaTaimy.duracion = 50000; // milisegundos
instanciaTaimy.cambiarDuracion(50000); // milisegundos
instanciaTaimy.intervalo = 3000; // milisegundos
instanciaTaimy.cambiarIntervalo(3000); // milisegundos
instanciaTaimy.espera = 100; // milisegundos
instanciaTaimy.cambiarEspera(100); // milisegundos
Si se encuentra en ejecución los cambios se verán reflejados al instante sin nesecidad de volver a
arrancar
Taimy.
funcion
: La función que se pretende ejecutar, esta puede recibir un parámetro cronómetro que contiene el tiempo transcurrido en milisegundos.duracion / cambiarDuracion
: la duración puede serfinita
al darle un valor numérico oinfinita
al signarle undefined.intervalo / cambiarIntervalo
: Lapso de tiempo en que se estará ejecutando la función repetidamente.espera / cambiarEspera
: Tiempo que esperará para comenzar a ejecutarse.
Arranque y Pausa/Detener
instanciaTaimy.arrancar(); // comienza la ejecución
instanciaTaimy.detener(); // detiene/pausa la ejecución
document.addEventListener('click',instanciaTaimy.interruptor); // detiene/pausa o reanuda la ejecución
arrancar
: Da la orden de comenzar o reanudar la ejecución.detener
: Detiene o pausa "segun como desee verlo" la ejecución para despues ser reanudado.interruptor
: alterna entrearrancar
ydetener
dependiendo de el estado de ejecución en que se encuentre.
Reinicio y Destrucción
instanciaTaimy.reiniciar();
instanciaTaimy.reinicioTotal();
instanciaTaimy.destructor();
reiniciar
: Reinicia la ejecución desde el comienzoreinicioTotal
: Reinicia la ejecución apartir desde el tiempo de esperadestructor
: Detiene la ejecución en curso y formatea el contenido interno de la instanacia para dejarla vacía.
Cabe mencionar que los métodos de
reiniciar
yreinicioTotal
reinician el propio hilo de ejecución no la funcion otorgada por lo que si desea que su funcion también sea reiniciada puede usar el valor de inicio del cronómetro como referencia ya que este siempre al inicio es 0
// ejemplo
instanciaTaimy.funcion = function (cronometro){
if(!cronometro)
{/*código de reinicio*/}
/*código*/}
instanciaTaimy.reiniciar();
Funciones extras
const objetoTiempo = TaimyForm(123456789); //milisegundos
const reloj = TaimyReloj(objetoTiempo) //objeto {d,h,m,s,ms}
console.log(objetoTiempo);
console.log(reloj);
terminal:
> Object { d: 1, h: 11, m: 36, s: 23, ms: 573 }
d: 1
h: 11
m: 36
ms: 573
s: 23
> <prototype>: Object { … }
01:11:36:23:57
TaimyForm( ms )
:
- Función que admite
milisegundos
- Retorna un objeto
{d,h,m,s,ms}
d = días, h = horas, m = minutos, s = segundos, ms = milisegundos.
TaimyReloj( objetoTiempo , formato , limite)
:
objetoTiempo
->{d,h,m,s,ms}
formato
-> {string} (opcional) que indica la forma y orden en que se va mostrar el reloj como mínimo debe espesificar 2 elementos válidos y máximo 5.
< ejemplo > :
Si solo se quiere mostrar la hora, minuto y segundo"h/m/s"
el resultado sería11:36:23
Para mostrar los milisegundos,minutos,días"sm/m/d"
, resultado:57:36:01
.limite
-> {number} (si formato no está definido este automáticamente se ignora) define los límites de como se muestra el string reloj:limite = 0
: El reloj irá creciendo como sea necesario ejemplo:59:59
+ (1s) =01:00:00
.limite = 1
: El reloj será fijo y al llegar al límite del parámetro máximo todos volverán a su estado inicial ejemplo:23:59:59
+ (1s) =00:00:00
.limite = 2
: El reloj será fijo y el parámetro maximo no tendrá limites ejemplo:23:59:59 + (1s) = 24:00:00
.
DEMO
import {Taimy, TaimyForm,TaimyReloj} from "taimy.js";
const img = document.getElementById('fotograma-clave');
const span = document.getElementById('cronometro');
const btn_x = document.getElementById('eliminar');
const btn_pausar = document.getElementById('pausar');
const btn_reiniciar = document.getElementById('reiniciar');
const input_fps = document.getElementById('fps');
let fps = 12;
input_fps.value = fps;
//secuencia de imágenes con nombres del 0 al 11 en formato PNG
const fotogramas = {
frame : 0,
siguiente(){
if(this.frame > 11)
this.frame = 0;
return `./${this.frame++}.png`;}}
//sección del cronómetro
const cronometro = new Taimy;
cronometro.funcion = function (ms){
const formatoTiempo = TaimyForm(ms);
span.innerText = TaimyReloj(formatoTiempo);
}
cronometro.intervalo = 100;
//sección de la animación
const instanciaTaimy = new Taimy(
cronometro=>{
if(!cronometro){
fotogramas.frame = 0;
}
img.src = fotogramas.siguiente();
},
{intervalo:1000/fps});
//comenzar la ejecución
instanciaTaimy.arrancar();
cronometro.arrancar();
// introducir los fps de la animación
input_fps.addEventListener('keydown',e =>{
if(e.keyCode != 13 || !input_fps.value)
return;
fps = input_fps.value;
instanciaTaimy.intervalo = 1000/fps;
});
//lógica de los botones
btn_x.addEventListener('click',()=>{
cronometro.destructor();
instanciaTaimy.destructor();
});
btn_pausar.addEventListener('click',instanciaTaimy.interruptor);
btn_reiniciar.addEventListener('click',()=>{
cronometro.reiniciar();
instanciaTaimy.reiniciar();
});