Ensamblador Z80: domina el debugger de WinAPE

Curso: https://bit.ly/Z80GameDev-2022-Curso
==== Sesión 6.1 - 4/oct/22 ====
En esta sesión te aprenderemos a usar el depurador de nuestro emulador de Amstrad CPC: el WinAPE. Empezamos con un programa sencillo que utiliza funciones esenciales como cpct_drawSprite, cpct_setPalette, cpct_setVideoMode y cpct_disableFirmware. Trazaremos el programa con el depurador, embarcándonos en una aventura para rastrear y corregir problemas en el código.

Nuestra exploración comienza con una explicación de cómo seguir la ejecución paso a paso utilizando las teclas F7 y F8, lo que te permitirá observar cómo se desarrolla tu programa y detectar cualquier anomalía. Aprendemos a usar la tecla F4 para saltar a puntos específicos en el código, una herramienta vital cuando quieres centrarte en secciones particulares de tu código.

A continuación, introducimos el concepto de "hide on run", una función que puede ocultar el depurador durante la ejecución, manteniendo tu pantalla despejada hasta que se alcance un breakpoint. Esta es una herramienta útil para concentrarte en el código sin distracciones, pero con la seguridad de que el depurador volverá a aparecer cuando lo necesites.

Luego, te mostramos cómo establecer breakpoints para detener la ejecución en una línea de código específica. Este truco esencial puede ayudarte a localizar exactamente dónde ocurren los problemas, permitiéndote analizar y modificar el estado del programa en ese punto.

Además, examinamos cómo un breakpoint puede ayudarte a entender cómo una función como Draw Sprite afecta al estado del programa. Observamos cómo las operaciones de copia de bytes cambian el estado de la memoria y aprendemos cómo verificar que estas operaciones se están realizando correctamente.

En el inspector de breakpoints, introducimos la idea de configurar contadores para que un breakpoint no se active inmediatamente, sino después de un número específico de ciclos. Este truco avanzado te permite afinar aún más tu proceso de depuración y centrarte en los aspectos más críticos de tu código.

Para terminar, te enseñamos cómo puedes ahorrar tiempo y evitar la repetición innecesaria al guardar y cargar configuraciones de breakpoints. Explicamos cómo usar la opción "breakinstructions" para detener el programa en instrucciones específicas y cómo las macros pueden facilitarte la depuración. Después de esta sesión tendrás un conjunto de técnicas y herramientas prácticas que te ayudarán a ser más eficiente en la depuración de videojuegos en el ensamblador Z80. ¡Vamos a por ello!

==== Contenidos ====
00:00 Introducción a depurar con WinAPE
01:22 Cómo lanzar el depurador de WinAPE
02:30 Ejecutar hasta una instrucción (F4)
04:21 Cómo añadir y usar Breakpoints
08:03 Ejemplo: depurar el código de 'cpct_drawSprite'
13:41 Maneja los Breakpoints: inspeccionar, salvar, cargar y deshabilitar
18:22 Break Instructions: qué son y cómo usarlas
20:55 Macros para crear breakpoints en el código fuente

==== Enlaces ====
Debugger Challenge: https://profesorretroman.com/mod/quiz... (Requiere cuenta)
Máquina Virtual CPCtelera: https://archive.org/details/CPCtelera...
Curso Z80-GameDev 2022: https://bit.ly/Z80GameDev-2022-Curso
Más Cursos: https://profesorretroman.com

==== Agradecimientos Especiales ====
Al equipo de https://profesorretroman.com :
- Iván Fernández (@spdizzy)
- Raúl García (@Kalandras)
- Alfonso Carmona (@hatHus)
Por postprocesar y editar los vídeos, elaborar descripciones y portadas.

#GameDev #assembler #Amstrad #programming

==== Créditos ====
Retoques por Ribbet AI
Sugerencias de mejora por ChatGPT 4

====================
Clase de Videojuegos 1 2022/23
Grado en Ingeniería Multimedia
Universidad de Alicante