FOSFENO/docs
hacklab 61543e1987 MOTORES: pastillas configurables y destino (salida o capa)
Las pestanas de capa de la barra superior no valian: mezclaban navegar por el
panel con elegir sobre que se trabaja, y sacaban del panel de directo. Se
quitan y todo pasa a MOTORES, con dos decisiones separadas:

  DONDE  -> fila 'Donde se ve': SALIDA o una capa del mapping (+ crea una).
  QUE    -> las pastillas: combinaciones guardadas por el usuario.

Pinchar una pastilla la manda al destino elegido: con SALIDA cambia el motor
global, con una capa cambia SOLO esa capa y el resto sigue igual. Con una capa
elegida sus ajustes salen en MOTORES (la tarjeta de propiedades se mueve, no
se duplica: dos formularios para lo mismo se desincronizan a la primera).

Las pastillas son configurables: motor + preset + ajustes y su nombre, con
'Configurar pastillas'. Persisten en data/slots.json (gitignorado, es de cada
instalacion). De fabrica vienen los cinco motores de siempre, asi que quien
actualice se encuentra lo mismo que tenia. Hydra, Mezcla y projectM nativo
solo pueden ir a la salida, y al intentar mandarlos a una capa se dice.

Comprobado en Chromium por CDP, no con --dump-dom: ese fotografia el DOM al
cargar, antes de que llegue el estado por socket, y daba falsos "esta vacio".
Verificado que disparar sobre una capa deja el motor global intacto, que la
tarjeta de propiedades va y vuelve de su sitio, y que las pastillas nuevas se
guardan en disco.

De paso, dos fallos que aparecieron al probarlo:
- Restaurar la vista guardada corria al principio del fichero y llamaba a
  codigo que usa variables declaradas con let mas abajo: ReferenceError que
  se llevaba por delante el resto del script (socket incluido) y dejaba el
  panel en blanco. Ahora se restaura al final.
- #card-destino no estaba en la lista de 'order' del CSS, asi que caia a 0 y
  se colaba encima de las pastillas pese a ir despues en el HTML.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-02 16:47:01 +02:00
..
assets Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
arquitectura.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
conexion.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
instalacion.md FOSFENO: motor de visuales audio-reactivas para Raspberry Pi 2026-05-22 14:18:19 +02:00
mapping.md MOTORES: pastillas configurables y destino (salida o capa) 2026-08-02 16:47:01 +02:00
mezclador.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
pendiente.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
portatil.md Soporte multi-distro en portatil, titulos mas grandes, panel mas ancho y refresco de microfono 2026-05-22 18:11:01 +02:00
problemas.md Mapping in-browser (Fase 1) + trabajo en curso 2026-07-27 00:19:30 +02:00
README.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
requisitos.md Documentacion: imagenes de Raspberry Pi 5, MilkDrop y Hydra 2026-05-22 18:27:38 +02:00
seguridad.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00
uso.md MOTORES: pastillas configurables y destino (salida o capa) 2026-08-02 16:47:01 +02:00
visuales.md Capas independientes, projectM en el mapping y catalogo de la galeria 2026-08-02 14:56:01 +02:00

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 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 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 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 Cómo correr FOSFENO en un portátil Debian, Ubuntu o Mint, sin Raspberry Pi.

  • Uso del panel Cómo se maneja desde el móvil, las dos pestañas (MOTORES y MAPPING), qué hace cada motor de visuales y cómo se configura cada opción.

  • El Mezclador VJ Las mezclas a fondo: las dos capas, cómo poner visuales de MilkDrop de fondo, los modos de mezcla y los efectos de color.

  • La galería de visuales El catálogo de clips: cómo se generan las fichas, cómo distingue una silueta de un trozo de película y por qué unos clips salen marcados como flojos.

  • Projection mapping Cómo deformar las visuales para encajarlas en superficies físicas, y cómo poner un visual distinto en cada zona: capas, fuentes, malla y máscaras.

  • Solución de problemas 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.

  • Seguridad Qué asume el diseño, qué pasa si pinchas en una wifi pública y cómo cerrar el panel con una clave compartida (el QR ya la lleva dentro).

  • Arquitectura Para quien vaya a tocar el código: las tres piezas, el estado, los eventos de WebSocket, cómo se añade un motor y los criterios que sigue el proyecto.

Si solo quieres empezar rápido, el archivo README.md de la raíz del proyecto tiene la versión resumida.