# Armonía Lab Manual del Usuario

## Dictado de Intervalos

Autor: Pablo Schvarzman

---

## 1. Propósito y Enfoque Pedagógico

El **Dictado de Intervalos** de Armonía Lab es una estación de entrenamiento auditivo dedicada al reconocimiento inmediato de distancias sonoras relativas dentro del ámbito de una octava, tanto en articulación melódica (ascendente y descendente) como armónica (simultánea).

### Objetivos Pedagógicos:
1. **Desarrollo del Oído Relativo:** Automatizar la identificación de saltos interválicos sin depender de referencias tonales absolutas, abstrayendo la relación interválica del registro en el que se presente.
2. **Transferencia Multi-instrumental Directa:** Cada ejercicio resuelto se proyecta instantáneamente sobre tres soportes visuales y táctiles: el pentagrama formal en clave de sol con tipografía vectorial SMuFL (Bravura), el teclado cromático lineal de piano y la topología por cuerdas y trastes del diapasón de la guitarra.
3. **Discriminación Tímbrica Versátil:** Dispone de cinco modelos sonoros (Piano acústico, Pluck de cuerda pulsada, Synth Brass, Synth Strings analógicas y Sinte V1 clásico) para habituar el oído a la percepción interválica con independencia de la envolvente de amplitud y el contenido armónico.
4. **Pedagogía del Error Constructivo:** La interfaz no sanciona el error cerrando el ejercicio; permite múltiples intentos de re-escucha analítica y ofrece la opción de revelar la solución cuando el alumno agota sus hipótesis.
5. **Resiliencia Operativa:** Arquitectura Web Audio protegida mediante detección de reposo en macOS e iOS, garantizando continuidad sonoro-educativa ininterrumpida.

---

## 2. Mapa de la Interfaz

### A. Cabecera y Métricas de Rendimiento
* **Marcador de Aciertos:** Muestra el recuento de aciertos respecto al total de ejercicios respondidos (`Aciertos / Intentos`).
* **Indicador de Precisión (%):** Calcula el porcentaje de efectividad de la sesión en tiempo real.
* **Botón Reiniciar:** Restablece las métricas de la sesión a cero.
* **Acceso al Manual y Modal Informativo (i):** Despliega el resumen técnico y teórico de la herramienta sin abandonar la vista activa.

---

### B. Selector de Timbre de Audio
Permite alternar en cualquier instante el generador sonoro Web Audio para contrastar texturas:
* **Piano:** Ataque percusivo con decaimiento de cuerda y armónico de martillo.
* **Pluck:** Ataque seco de 2 ms y filtrado resonante rápido; óptimo para saltos rápidos y articulación melódica precisa.
* **Synth Brass:** Doble diente de sierra con apertura envolvente sustractiva (*brass swell*).
* **Synth Strings:** Ensamble de cuerdas con desafinación coral ($\pm 6\text{ cents}$), ataque progresivo de arco y refuerzo de fundamental senoidal.
* **Sinte V1:** Onda triangular pura de la primera versión de la plataforma, limpia de filtros o desafinaciones, pensada para audición analítica fundamental.

---

### C. Filtros y Presets de Dificultad
* **Básicos (3ªs, 5ª, 8ª):** Acota el conjunto a 3ª menor, 3ª mayor, 5ª justa y octava justa.
* **Disonancias & 7ªs:** Enfoca la sesión en 2ª menor, 2ª mayor, tritono, 7ª menor y 7ª mayor.
* **Todos (12 Intervalos):** Activa el espectro cromático completo de 1 a 12 semitonos.
* **Selectores Individuales (Chips):** Permite encender o apagar intervalos específicos según el objetivo del estudio.

---

### D. Modo de Articulación y Controles de Reproducción
* **Selector de Articulación:**
  - *Ascendente (↑):* Reproduce la nota base y a continuación la nota objetivo hacia el agudo.
  - *Descendente (↓):* Reproduce la nota superior y a continuación el salto descendente.
  - *Armónico (Simultáneo):* Dispara ambas notas a la vez con una microdispersión de 15 ms para evaluar la consonancia o disonancia global.
* **Repetir Audio (Atajo: Barra Espaciadora):** Dispara de nuevo el intervalo generado.
* **Siguiente Ejercicio (Atajo: Tecla Enter):** Genera una nueva prueba sobre una fundamental aleatoria una vez completada la actual.
* **Rendirme y ver solución:** Muestra la respuesta correcta, desbloquea los visualizadores y no computa el ejercicio como acierto.

---

### E. Rejilla de Respuesta
Doce botones ergonómicos etiquetados con el nombre formal y los semitonos de distancia:
`2ª menor (1st)`, `2ª Mayor (2st)`, `3ª menor (3st)`, `3ª Mayor (4st)`, `4ª Justa (5st)`, `Tritono / 4ª aument. (6st)`, `5ª Justa (7st)`, `6ª menor (8st)`, `6ª Mayor (9st)`, `7ª menor (10st)`, `7ª Mayor (11st)`, `8ª Justa (12st)`.

---

### F. Triple Visualizador Pedagógico
Se activa al acertar o pulsar "Rendirme y ver solución":
1. **Pentagrama en Clave de Sol:** Dibuja las dos notas vectoriales con cabezas SMuFL Bravura, alteraciones accidentales correctas y líneas adicionales automáticas.
2. **Teclado de Piano SVG:** Resalta la nota raíz en color oro y la nota intervalo en azul cobalto sobre un teclado cromático de dos octavas con nomenclatura musical.
3. **Diapasón de Guitarra SVG:** Representa el salto sobre las seis cuerdas con marcas de traste estándar (3, 5, 7, 9, 12), indicando la relación geométrica en el mástil.

---

## 3. Teoría Explicada y Presets Canónicos

### Tabla Canónica de Clasificación Interválica

| Intervalo | Semitonos | Naturaleza Acústica | Relación de Frecuencias | Ejemplo de Referencia Auditiva |
| :--- | :--- | :--- | :--- | :--- |
| **Segunda Menor** | 1 | Disonancia Áspera | $16:15$ | *Tiburón* (John Williams) / Melodía Frigia |
| **Segunda Mayor** | 2 | Disonancia Suave | $9:8$ | *Frère Jacques* / Escala Mayor |
| **Tercera Menor** | 3 | Consonancia Imperfecta | $6:5$ | *Greensleeves* / Acorde Menor |
| **Tercera Mayor** | 4 | Consonancia Imperfecta | $5:4$ | *Oh When the Saints* / Acorde Mayor |
| **Cuarta Justa** | 5 | Consonancia Perfecta | $4:3$ | *Himno de la Alegría* / *La Marcha Nupcial* |
| **Tritono** | 6 | Disonancia Inestable | $45:32$ o $\sqrt{2}$ | *The Simpsons* / Acorde dominante 7 |
| **Quinta Justa** | 7 | Consonancia Perfecta | $3:2$ | *Star Wars* (Tema principal) / Afinación violín |
| **Sexta Menor** | 8 | Consonancia Imperfecta | $8:5$ | *Love Story* / *The Entertainer* (salto interno) |
| **Sexta Mayor** | 9 | Consonancia Imperfecta | $5:3$ | *My Bonnie Lies Over the Ocean* / *Aida* |
| **Séptima Menor** | 10 | Disonancia Suave | $16:9$ | *Somewhere* (*West Side Story*) / Arpegio m7 |
| **Séptima Mayor** | 11 | Disonancia Áspera | $15:8$ | *Take On Me* (salto a estribillo) / Acorde maj7 |
| **Octava Justa** | 12 | Consonancia Perfecta | $2:1$ | *Somewhere Over the Rainbow* |

---

## 4. Guía de Trabajo Paso a Paso

1. **Aislamiento Inicial:** Comience seleccionando el preset "Básicos (3ªs, 5ª, 8ª)" y el timbre **Piano**.
2. **Escucha y Proyección Interna:** Presione la barra espaciadora para escuchar el intervalo. Cante o entone internamente la distancia antes de mirar la pantalla.
3. **Discriminación Cualitativa:**
   - ¿Es un intervalo consonante y estable (4ª, 5ª, 8ª)?
   - ¿O aporta un color modal definido (3ª menor nostálgica vs. 3ª mayor luminosa)?
4. **Respuesta y Análisis:** Haga clic sobre el botón correspondiente.
   - Si acierta, el panel verde se abrirá mostrando el pentagrama, el piano y la guitarra.
   - Si falla, el botón pulsado se teñirá en rojo y el intervalo volverá a sonar para facilitar una segunda oportunidad analítica.
5. **Transición a Articulación Armónica:** Una vez superado el 90 % de precisión en modo ascendente, active el modo armónico (simultáneo) para reconocer los intervalos no como secuencias temporales, sino como colores de textura espectral.

---

## 5. Ejercicios Prácticos

### Ejercicio 1: Calibración de Consonancias Perfectas
- **Configuración:** Filtro activado únicamente con 4ª Justa, 5ª Justa y 8ª Justa. Articulación: Ascendente. Timbre: Piano.
- **Objetivo:** Alcanzar 15 aciertos consecutivos diferenciando la estabilidad abierta de la 5ª frente al carácter de preparación de la 4ª y la identidad tonal de la 8ª.

### Ejercicio 2: El Eje de las Terceras en Modo Armónico
- **Configuración:** Filtro activado con 3ª menor y 3ª Mayor. Articulación: Armónica (simultánea). Timbre: Synth Strings.
- **Objetivo:** Discriminar con rapidez la luz armónica de la tercera mayor frente a la sombra menor cuando ambas notas suenan superpuestas en un timbre cálido de cuerdas.

### Ejercicio 3: Disonancias Críticas
- **Configuración:** Preset "Disonancias & 7ªs" activado. Timbre: Pluck. Articulación: Descendente.
- **Objetivo:** Reconocer las segundas y séptimas en movimiento descendente. Anotar mentalmente si la disonancia es punzante de semitono (2ª menor y 7ª mayor) o amplia de tono entero (2ª mayor y 7ª menor).

### Ejercicio 4: El Tritono y su Resolución
- **Configuración:** Filtro con 4ª Justa, Tritono y 5ª Justa. Articulación: Ascendente y Armónica combinadas. Timbre: Synth Brass.
- **Objetivo:** Localizar de inmediato la tensión centrífuga del tritono frente al reposo absoluto de las consonancias perfectas contiguas.

### Ejercicio 5: Examen General de los 12 Intervalos
- **Configuración:** Preset "Todos (12)". Timbre: Sinte V1. Articulación: Aleatoria (alternando ascendente, descendente y armónica).
- **Objetivo:** Completar una serie de 30 ejercicios manteniendo un porcentaje de precisión superior al 85 %, transfiriendo cada respuesta al mapa del diapasón de guitarra y teclado de piano.