Lecciones y el juego de aprendizaje

Computer graphics from scratch

Dibuja todo a mano en una pantalla de ESP32-C3: un framebuffer, líneas de Bresenham, círculos rellenos, matrices y perspectiva, y luego una estación giratoria.

Cómo funciona

Computer graphics from scratch uses no graphics library. Every lesson keeps a framebuffer in RAM, 160 by 160 bytes with a color number in each, draws into it with code you can read, and sends the whole buffer to a 2.4 inch ILI9341 color screen in one window.

El circuito es con el que empieza el curso de la consola portátil: un ESP32-C3 y la pantalla en cuatro cables SPI (GPIO 18 a 21). El jefe final añade el game pad. Cada lección abre un sketch que funciona. Lo ejecutas, lees lo que imprime el monitor serie (conteos de píxeles, coordenadas, tiempos y una suma de verificación del framebuffer), luego cambias una constante y vuelves a ejecutar. Las verificaciones leen esas líneas, así que cada número que cita una lección es uno que la placa imprimió de verdad.

Las lecciones

  1. Framebuffers: una imagen como un arreglo de bytes, color indexado, recorte, conteo de píxeles, una suma de verificación que prueba una imagen exacta, y por qué un volcado de 25,600 píxeles tarda 36 ms por un cable bit-banged.
  2. Rectas de Bresenham: un píxel por paso del lado más largo, el término de error rastreado píxel a píxel, una carrera contra una recta en float (27 ms contra 2 ms en un chip sin FPU), líneas empinadas y un estallido de rayos.
  3. Círculos y rellenos: el círculo de punto medio con simetría de ocho vías, discos a partir de tramos horizontales, y un relleno por inundación con una cola de búfer circular que pinta diez mil píxeles reteniendo 119.
  4. Transforms: 2D matrices that turn, move and scale, why the order of multiplication matters, and a satellite outline spinning on the screen.
  5. 3D projection: divide by depth, a cube's corners projected by hand, near faces bigger than far ones, moving the camera and changing the lens.
  6. Modelos de alambre: puntos y aristas, el ciclo girar, proyectar, limpiar, dibujar, volcar a 26 cuadros por segundo, un perfil de cada cuadro, y tu propio modelo.

El jefe final: una estación espacial giratoria

La última lección construye una estación espacial en código a partir de unos números (un eje, un anillo, cuatro radios y dos paneles solares en mástiles) y la vuela con el game pad. LEFT y RIGHT ajustan el giro, UP y DOWN la inclinan hacia ti, y A activa el sombreado por profundidad para que el lado lejano se vea más tenue. Terminas cambiando un número para reconstruir el anillo con más segmentos, y cierra con ideas: una nave que acopla, un segundo anillo, un mástil más largo.

Lo que el ESP32-C3 hace distinto

  • No tiene unidad de punto flotante. Cada float es una rutina de software, y por eso el curso dibuja con enteros y usa floats solo para los pocos números por cuadro que los necesitan.
  • La pantalla se maneja con SPI bit-banged: cada bit es un cambio de pin hecho por el programa. Un volcado completo de 160 por 160 son 409,600 bits y domina cada cuadro, así que la lección de perfilado descubre que el límite es el cable, no las matemáticas.
  • Tiene 400 KB de SRAM, así que un framebuffer de 25,600 bytes cabe fácil. Una pantalla completa de 240 por 320 a 16 bits por píxel necesitaría 153,600 bytes, y por eso el búfer guarda números de color.
  • Los sketches corren en el propio runtime C3 de Mokxi, con cosf, sinf, atanf y lroundf de su biblioteca matemática y micros() para medir tiempos.

Después de este curso

Escribe un motor de física usa la misma pantalla y framebuffer para hacer que las cosas se muevan: vectores, pasos de tiempo, colisiones y resortes, terminando con canicas que inclinas con un sensor de movimiento.