SheIsRaissa

Un programa que detecta movimientos del ratón, acciones del teclado e intensidad de la entrada del micrófono para generar una animación de un gato que se mueve de acuerdo a estas.

El código fuente puede ser encontrado en la siguiente página de gitlab.

Instrucciones de uso

Antes de la ejecución

En la carpeta res se encuentra el archivo config.properties en el cual se pueden establecer distintos parámetros para el programa, que no pueden ser cambiados durante el tiempo de ejecución, los cuales son:

• window_height: Indica el alto de la ventana en píxeles. Debe ser un número natural.
• window_width: Indica el ancho de la ventana en píxeles. Debe ser un número natural.
• window_location: Indica donde se va a iniciar la ventana. Puede ser ne para noreste, nw para noroeste, se para sureste o sw para suroeste.
• windows_taskbar_height: Indica que tan grande es la altura en píxeles la barra de tareas para poder colocar inicialmente la ventana del programa sin que se solape con esta. Debe ser un número natural.
• mouse_detection: Indica si se va a registrar el movimiento del ratón o no. Deber ser true o false.
• keyboard_detection: Indica si se va a registrar las acciones del teclado o no. Deber ser true o false.
• microphone_detection: Indica si se va a registrar la intensidad del sonido proveniente del micrófono. Deber ser true o false.
• microphone_channels: Indica cuantos canales tiene el micrófono, o sea, si es mono, estereo, quad, etc. Es ignorado si `microphone_detection=false`. Debe ser un número natural.
• microphone_ups: Indica cuantas veces por segundo se comprueba el micrófono, principalmente para ahorrar recursos de la computadora. Es ignorado si `microphone_detection=false`. Debe ser un número natural.
• microphone_threshold: Indica La intensidad de los sonidos provenientes del micrófono para ser considerados por la detección de sonido. Es ignorado si `microphone_detection=false`. Debe ser un número natural.
• frames_per_second: Indica cuantos fotogramas son pintados por segundo, principalmente para ahorrar recursos de la computadora. Debe ser un número natural.

Durante la ejecución

Mientras el programa esté activo puede registrar el teclado, ratón y micrófono del usuario si lo indicó en el `config` (ver más adelante), y si además su ventana tiene el foco principal, tiene 2 atajos del teclado:

•  Terminar el programa: Pulsar la secuencia de botones CTRL-SHIFT-C en ese orden, ya sea manteniéndolos presionados o cada uno por separado para terminar el programa.
• Activar decoración: Pulsar la secuencia de botones CTRL-SHIFT-D en ese orden, ya sea manteniéndolos presionados o cada uno por separado para activar los bordes de la ventana, permitiendo el movimiento de esta a la ubicación deseada, además de colocar un fondo color verde RGB(0, 255, 0)

Librerías externas

Se usa la versión más actual de JNativeHook hasta la fecha de Marzo 02 del 2024. Este proyecto tiene un directorio /libs con jnativehook-2.2.2.jar dentro de él.

Más información u otras versiones pueden ser encontradas en la página de GitHubde JNativeHook. Esta librería tiene la Licencia Pública General Reducida de GNU (LGPL).