# Armonía Lab Manual del Usuario

## Dictado de Escalas y Modos

Autor: Pablo Schvarzman

---

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

El **Dictado de Escalas y Modos** de Armonía Lab es un entorno de entrenamiento auditivo horizontal diseñado para interiorizar la identidad interválica y el color emotivo de las escalas diatónicas, los modos griegos derivados de la escala mayor y las escalas menores analíticas de la armonía tradicional y del jazz.

### Objetivos Pedagógicos:
1. **Identificación de Notas Características:** Enseñar al estudiante a localizar la nota diferencial o eje de color de cada modo (por ejemplo, la cuarta aumentada del modo Lidio o la segunda menor del modo Frigio) en lugar de intentar memorizar secuencias inconexas.
2. **Entrenamiento en Múltiples Direcciones Melódicas:** Capacidad de percibir la escala de forma ascendente, descendente y en recorrido completo de ida y vuelta.
3. **Integración Multi-instrumental:** Visualización gráfica simultánea del conjunto modal en el pentagrama vectorial en clave de sol (con tipografía SMuFL Bravura), en el teclado de piano cromático y en el diapasón de guitarra con sus digitaciones canónicas.
4. **Variabilidad Tímbrica de Escucha:** Cinco motores de síntesis Web Audio (Piano acústico, Pluck percusivo, Synth Brass, Synth Strings analógicas y Sinte V1) para entrenar la flexibilidad auditiva del productor e intérprete.
5. **Filosofía del Error Analítico:** Posibilidad de múltiples intentos ante fallos, facilitando el contraste entre la escala emitida y la seleccionada erróneamente.

---

## 2. Mapa de la Interfaz

### A. Cabecera y Contadores Minimalistas
* **Marcador de Aciertos:** Indicador numérico sobrio y compacto que presenta exclusivamente los aciertos sobre el total completado (`0/0`).
* **Botón Reiniciar:** Permite poner a cero los contadores de la sesión en cualquier momento.
* **Icono de Información (Manual):** Acceso directo a la documentación pedagógica y técnica completa.

---

### B. Barra de Ajustes: Sonido y Checklist Desplegable
* **Selector Desplegable de Sonido:**
  - *Piano:* Ataque de martillo y armónicos de cuerda natural.
  - *Pluck:* Ataque instantáneo de 2 ms y caída rápida; idóneo para percibir las notas de paso a tempos ágiles.
  - *Synth Brass:* Sonoridad potente de metales sintéticos que resalta las disonancias modales.
  - *Synth Strings:* Textura cálida con ataque suave de arco y desafinación coral ($\pm 6\text{ cents}$).
  - *Sinte V1:* Generador triangular puro, neutro y cristalino, enfocado en la altura tonal elemental.
* **Selector Desplegable con Casillas Check (Escalas):**
  - Despliega un panel flotante con presets rápidos (*Mayor vs Menor*, *Modos Mayores*, *Modos Menores*, *Todos los Modos*) y casillas de verificación individuales para cada escala o modo.
  - El botón exterior resume de forma dinámica el total de escalas activas en el test (ejemplo: `Escalas activas (3/11)`).

---

### D. Modo de Dirección y Controles de Reproducción
* **Selector de Dirección:**
  - *Ascendente (↑):* Emite la escala desde la tónica grave hasta la octava aguda.
  - *Descendente (↓):* Emite la escala desde la octava superior descendiendo hacia la tónica.
  - *Ambas (↑↓):* Ejecuta el recorrido completo de subida y bajada.
* **Repetir Audio (Atajo: Barra Espaciadora):** Vuelve a reproducir la escala del ejercicio activo.
* **Siguiente Ejercicio (Atajo: Tecla Enter):** Pasa al siguiente reto auditivo sobre una tónica aleatoria una vez resuelto.
* **Rendirme y ver solución:** Desvela el nombre de la escala, la nota característica y abre los visualizadores.

---

### E. Rejilla de Respuesta
Botones de respuesta clasificados por familias:
* *Familia Mayor:* `Jónico (Mayor)`, `Lidio`, `Mixolidio`.
* *Familia Menor:* `Dórico`, `Eolio (Menor)`, `Frigio`, `Locrio`.
* *Escalas Especiales:* `Menor Armónica`, `Menor Melódica`, `Pentatónica Menor`.

---

### F. Panel de Retroalimentación y Triple Visualizador
1. **Fórmula Teórica y Nota Característica:** Resalta la nota diferencial de la escala (ejemplo: `Dórico: 1 - 2 - b3 - 4 - 5 - 6 - b7 · Nota característica: 6ª Mayor`).
2. **Pentagrama en Clave de Sol (SMuFL Bravura):** Dibuja todas las notas en orden melódico con sus bemoles o sostenidos exactos.
3. **Teclado de Piano SVG:** Ilumina la tónica en dorado, las notas modales en azul y la nota característica con borde distintivo.
4. **Diapasón de Guitarra SVG:** Representa el patrón escalístico en el mástil con las alteraciones cromáticas indicadas sobre los trastes.

---

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

### Tabla de Modos Griegos y Escalas Analíticas

| Escala / Modo | Familia | Fórmula Interválica | Nota Característica | Color y Clima Emocional |
| :--- | :--- | :--- | :--- | :--- |
| **Lidio** | Mayor | $1 - 2 - 3 - \sharp 4 - 5 - 6 - 7$ | $\sharp 4$ (Cuarta Aumentada) | Místico, flotante, etéreo, épica cinematográfica. |
| **Jónico** | Mayor | $1 - 2 - 3 - 4 - 5 - 6 - 7$ | $4$ (Cuarta Justa) | Brillante, afirmativo, estable, diatonismo clásico. |
| **Mixolidio** | Mayor | $1 - 2 - 3 - 4 - 5 - 6 - \flat 7$ | $\flat 7$ (Séptima Menor) | Festivo, bluesy, sonido Rock, Funk y folklore celta. |
| **Dórico** | Menor | $1 - 2 - \flat 3 - 4 - 5 - 6 - \flat 7$ | $6$ (Sexta Mayor) | Melancolía elegante, sonoridad Jazz, Funk y Santana. |
| **Eolio** | Menor | $1 - 2 - \flat 3 - 4 - 5 - \flat 6 - \flat 7$ | $\flat 6$ (Sexta Menor) | Tristeza solemne, dramatismo natural, épica pop y metal. |
| **Frigio** | Menor | $1 - \flat 2 - \flat 3 - 4 - 5 - \flat 6 - \flat 7$ | $\flat 2$ (Segunda Menor) | Exotismo andaluz, flamenco, oscuridad tensa, misterio. |
| **Locrio** | Disminuida | $1 - \flat 2 - \flat 3 - 4 - \flat 5 - \flat 6 - \flat 7$ | $\flat 5$ (Quinta Disminuida) | Máxima inestabilidad, atmósfera siniestra y opresiva. |
| **Menor Armónica** | Menor | $1 - 2 - \flat 3 - 4 - 5 - \flat 6 - 7$ | $7$ (Sensible Mayor) | Tensión arábiga y clásica; salto de 2ª aumentada ($\flat 6 - 7$). |
| **Menor Melódica** | Menor | $1 - 2 - \flat 3 - 4 - 5 - 6 - 7$ | $6\text{ y }7$ mayores | Sofisticación de Jazz; menor en el grave y mayor en el agudo. |
| **Pentatónica Menor** | Menor | $1 - \flat 3 - 4 - 5 - \flat 7$ | Estructura de 5 notas | Economía melódica directa, lenguaje Blues, Soul y Rock. |

---

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

1. **Diferenciación Inicial Mayor / Menor:**
   - Active el preset "Básicos (Mayor y Menor)" y escuche el tercer grado de la escala. Si la tercera es mayor, el modo pertenece al grupo luminoso; si es menor, pertenece al grupo sombrío.
2. **Localización de la Nota Clave:**
   - Si la escala es mayor y suena mística o mágica, busque la cuarta aumentada ($\sharp 4$ del Lidio).
   - Si es mayor con sabor blues y resolución relajada, preste atención a la séptima menor ($\flat 7$ del Mixolidio).
   - Si la escala es menor y contiene un segundo grado a medio tono de la tónica, se trata del modo Frigio ($\flat 2$).
   - Si la escala es menor pero tiene una sexta mayor luminosa, se trata del Dórico ($6$).
3. **Identificación de Escalas Menores Especiales:**
   - Un salto exótico y dramático de tono y medio entre los grados 6 y 7 delata a la Menor Armónica.
   - Un inicio menor que culmina con sensación mayor y sensible clásica señala a la Menor Melódica.
4. **Respuesta y Fijación Visual:** Haga clic sobre el botón correspondiente y observe en el teclado y diapasón cómo se sitúan las notas características.

---

## 5. Ejercicios Prácticos

### Ejercicio 1: Los Tres Modos Mayores (Jónico, Lidio, Mixolidio)
- **Configuración:** Filtro activado con Jónico, Lidio y Mixolidio. Timbre: Piano. Dirección: Ascendente.
- **Objetivo:** Identificar 15 escalas consecutivas buscando activamente la presencia de la cuarta aumentada (Lidio) o la séptima menor (Mixolidio) frente a la pureza diatónica del Jónico.

### Ejercicio 2: El Duelo Menor (Dórico vs. Eolio)
- **Configuración:** Filtro activado únicamente con Dórico y Eolio. Timbre: Synth Strings. Dirección: Ascendente y Descendente.
- **Objetivo:** Aprender a captar el brillo inesperado de la sexta mayor del Dórico en contraste con la caída melancólica de la sexta menor del Eolio.

### Ejercicio 3: La Tensión Flamenca del Modo Frigio
- **Configuración:** Filtro activado con Frigio, Eolio y Locrio. Timbre: Pluck. Dirección: Ascendente.
- **Objetivo:** Aislar el impacto inmediato del semitono inicial ($\flat 2$) del Frigio y diferenciar su quinta justa frente a la caída desestabilizadora de la quinta disminuida del Locrio.

### Ejercicio 4: Menor Natural vs. Menor Armónica y Melódica
- **Configuración:** Preset "Menores Avanzadas". Timbre: Synth Brass. Dirección: Ascendente.
- **Objetivo:** Detectar el intervalo de 2ª aumentada de la menor armónica y la doble alteración ascendente ($6 - 7$) de la menor melódica.

### Ejercicio 5: Prueba Integral de los 7 Modos Griegos
- **Configuración:** Preset "7 Modos Griegos". Timbre: Sinte V1. Dirección: Ambas (↑↓).
- **Objetivo:** Completar una ronda de 25 preguntas logrando una precisión mayor al 85 %, reconociendo la identidad modal sin titubeos.