Docs del mapping (Fase 1+2) + gitignore de runtime

- docs/mapping.md: guia del projection mapping (activar, superficies con malla
  para curvar, mascaras, editar arrastrando desde el panel, dónde se guarda,
  limitaciones). Enlazada desde docs/README.md y el README principal.
- .gitignore: ignora data/pm-fijado/ (runtime de projectM).

El mapper funcional (esquinas + malla + mascaras, para Butterchurn/Hydra/
Shaders/Mezclador) ya estaba en main (Fase 1 y 2). La via de captura para
projectM nativo se retira por ahora; se retoma mas adelante.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

README.md

@@ -40,6 +40,8 @@ La carpeta [`docs/`](docs/) tiene la guía completa:
 - [Conectarse al panel](docs/conexion.md) — el código QR, `fosfeno.local` y
   el router.
 - [Uso del panel](docs/uso.md) — cómo se maneja y qué hace cada motor.
+- [Projection mapping](docs/mapping.md) — deformar las visuales para encajarlas
+  en superficies físicas (malla, máscaras) desde el panel.
 - [Solución de problemas](docs/problemas.md) — qué hacer cuando algo falla.
 
 El panel además lleva un botón de información en cada apartado: explica qué
@@ -63,6 +65,13 @@ Visuales de ejemplo — el motor Hydra con su editor de código en vivo:
   <img src="docs/assets/hydra.png" alt="Hydra" width="940">
 </div>
 
+## Projection mapping
+
+Las visuales web (Butterchurn, Hydra, Shaders y Mezclador) se pueden **deformar
+para encajarlas en superficies físicas** desde el panel: superficies con malla
+(curvas), varias a la vez y máscaras para tapar zonas, arrastrando con el ratón
+o el dedo. Se guarda solo en `data/mapping.json`. Guía: [docs/mapping.md](docs/mapping.md).
+
 ## Hardware necesario
 
 - Raspberry Pi 5 o Pi 4 + fuente oficial + microSD/SSD