BiblioJAM‎ > ‎

JAMCron

Un Cronómetro. Es un grupo de Sprite con un solo Sprite del tipo JAMButton.

VERSION 2 (24/05/2011)

Para poder utilizar este control, debes:
  • Copiar la carpeta BiblioJAM dentro del directorio de tu juego o actividad.
  • Luego importar el paquete mediante:       import BiblioJAM
  • Luego, para crear un JAMCron, debes importar su clase mediante:         from BiblioJAM.JAMCron import JAMCron

Para construir un JAMCron debes hacer:
         JAMCron ()

Puedes setear un sonido para el segundero mediante:
         JAMCron.set_sound(sound)
         El sonido debe pasarse cargado. Por defecto JAMCron carga su sonido utilizando la función get_sound_clock_tick1() de JAMGlobals.
        
Puedes desactivar este sonido pasando None en esta función en el parámetro sound.

Puedes setear una alarma mediante:
         JAMCron.set_alarma(tiempo= False, sound= False, duracion= False)
         tiempo debe ser una tupla de enteros = (minutos, segundos), que representará al tiempo transcurrido desde que se activa el cronómetro.
         duracion debe ser un entero que representa la cantidad de veces que se repetirá el sonido de la alarma al activarse.
         sonido debe ser un sonido cargado previamente. En JAMGlobals encontrarás dos funciones (get_alarma_reloj1() y get_alarma_reloj2()),
         que cargan 2 sonidos de alarma que se encuentran en el directorio "Recursos" de la librería (alarma-reloj1.ogg y alarma-reloj2.ogg).

         Puedes desactivar el sonido de la alarma pasando None en esta función en el parámetro sonido.

Para activar el cronómetro debes hacer:
         JAMCron.play()

Para pausar o detener el cronómetro debes hacer:
         JAMCron.pause()

Para devolver el cronómetro a 0:0 debes hacer:
        JAMCron.reset()

Para setear la posición en pantalla de JAMCron debes hacer:
        JAMCron.set_posicion(punto=(x,y))

Para setear colores, tamaños y tipos de letra, bordes, etc, debes referirte al Sprite contenido en JAMCron mediante:
        JAMCron.cron . . . . . (Ver JAMButton)

Puedes setear una función para que se ejecute cuando llega al tiempo seteado en la alarma mediante:
        JAMCron.set_callback(callback)
        Pasando None en el parámetro callback desactivas esta opción.
        La función que conectes debe tener un parámetro para recibir a JAMCron ya que se devuelve a si mismo para
        que puedas obtener datos de él.

Puedes obtener la cantidad de segundos que faltan para que se cumpla el tiempo seteado en alarma mediante:
        JAMCron.get_tiempo_restante()

Puedes obtener la cantidad de segundos transcurridos en el cronómetro mediante:
        JAMCron.get_tiempo_transcurrido()


Nota:
Puedes ejecutar: python JAMCron.py para ver un ejemplo.
Comments