FOSFENO/docs/README.md
hacklab 5d5223db9f 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>
2026-07-27 01:16:37 +02:00

35 lines
1.4 KiB
Markdown

# Documentación de FOSFENO
Esta carpeta reúne todo lo necesario para montar, instalar y usar FOSFENO sin
tener que adivinar nada. Está pensada para leerse en orden la primera vez y
para consultarse a saltos después.
- [Requisitos y hardware](requisitos.md)
Qué Raspberry Pi necesitas, qué cable va al proyector y, sobre todo, qué
micrófonos USB y qué cámaras funcionan sin instalar drivers.
- [Instalación](instalacion.md)
Cómo se instala paso a paso y, con detalle, qué descarga y compila el
script de instalación en tu Raspberry.
- [Conectarse al panel](conexion.md)
Cómo encuentra el usuario el panel de control: el código QR del proyector,
la dirección `fosfeno.local` y qué hacer con el router.
- [FOSFENO en un portátil Linux](portatil.md)
Cómo correr FOSFENO en un portátil Debian, Ubuntu o Mint, sin Raspberry Pi.
- [Uso del panel](uso.md)
Cómo se maneja desde el móvil, qué hace cada motor de visuales y cómo se
configura cada opción.
- [Projection mapping](mapping.md)
Cómo deformar las visuales para encajarlas en superficies físicas: malla,
máscaras y edición desde el panel arrastrando con el ratón o el dedo.
- [Solución de problemas](problemas.md)
Qué hacer cuando algo no arranca, no se ve o no suena. Incluye cómo leer
los mensajes de error que aparecen en el propio panel.
Si solo quieres empezar rápido, el archivo `README.md` de la raíz del
proyecto tiene la versión resumida.