Agregar Timer de Debug en Barra de Título

Resumen

Se implementó un timer de debug en la barra de título del emulador que muestra el tiempo transcurrido desde que se inicia el emulador y el tiempo hasta el primer evento (frame listo). El timer se inicializa al inicio de `run()`, detecta cuando ocurre el primer frame listo, y actualiza la barra de título cada 60 frames con el tiempo transcurrido y el tiempo hasta el primer evento (si ya ocurrió).

Concepto de Hardware

Timing y Eventos en Emulación:

En un emulador, es importante poder medir el tiempo transcurrido desde que se inicia la emulación hasta que ocurren eventos importantes. El primer evento crítico es cuando la PPU marca un frame como listo (`frame_ready_ = true`), lo que indica que el emulador ha completado su primer ciclo de renderizado.

El tiempo hasta el primer evento es útil para diagnosticar problemas de inicialización, ya que si el emulador tarda demasiado en generar el primer frame, puede indicar problemas en la inicialización de componentes o en la sincronización entre la CPU y la PPU.

El tiempo transcurrido total permite monitorear el rendimiento del emulador y verificar que está ejecutándose a la velocidad correcta (60 FPS).

Implementación

Se agregaron tres variables de instancia para el timer de debug:

• _start_time: Tiempo de inicio del emulador (cuando se llama a run())
• _first_event_time: Tiempo cuando ocurre el primer evento (None hasta que ocurra)
• _first_event_detected: Flag para indicar si ya se detectó el primer evento

Componentes creados/modificados

• src/viboy.py: Agregadas variables de instancia en __init__(), inicialización del timer en run(), detección del primer evento, y actualización del título con el timer

Decisiones de diseño

Inicialización en run(): El timer se inicializa al inicio de run() en lugar de en __init__() porque el emulador puede ser inicializado múltiples veces, pero solo queremos medir el tiempo desde que se inicia la ejecución.

Detección del primer evento: Se detecta cuando get_frame_ready_and_reset() retorna True por primera vez, lo que indica que la PPU ha completado su primer frame.

Actualización del título: El título se actualiza cada 60 frames (aproximadamente cada segundo) para evitar sobrecarga, y muestra tanto el tiempo transcurrido total como el tiempo hasta el primer evento (si ya ocurrió).

Archivos Afectados

• src/viboy.py - Agregadas variables de instancia para el timer, inicialización del timer en run(), detección del primer evento, y actualización del título con el timer

Tests y Verificación

La implementación se verificó mediante:

• Verificación visual: El timer aparece en la barra de título y se actualiza correctamente
• Logs: Los logs [Viboy-Timer] aparecen cuando se inicia el emulador y cuando se detecta el primer evento
• Formato del título: El título muestra el formato correcto: "Viboy Color v0.0.2 - [Nombre del Juego] - FPS: XX.X - Time: XX.XXXs | First Event: XX.XXXs"

Comando de prueba:

timeout 30 python3 main.py roms/tetris.gb

Resultado esperado:

• El timer aparece en la barra de título desde el inicio
• El tiempo se actualiza cada segundo aproximadamente
• Cuando ocurre el primer frame, se muestra también el tiempo hasta el primer evento
• Los logs [Viboy-Timer] aparecen en la consola

Fuentes Consultadas

• Implementación basada en conocimiento general de timing y eventos en emulación
• Documentación de Python time.time() para medición de tiempo

Integridad Educativa

Próximos Pasos

• [ ] Continuar con el análisis de logs del Step 0343
• [ ] Step 0345: Análisis detallado de correspondencia framebuffer-visualización basado en los logs del Step 0343
• [ ] Step 0346: Implementar corrección basada en los hallazgos