PianoTheory Pro — Manual del Usuario

1. Propósito y Enfoque Pedagógico

PianoTheory Pro es una estación analítica, visual y auditiva centrada en el teclado cromático de piano como referencia espacial universal de la armonía moderna y del Piano Roll de los DAWs contemporáneos.

Objetivos de Aprendizaje:

1. Comprender la geometría interválica en el teclado: Visualizar físicamente cómo las fórmulas teóricas (semitonos, terceras superpuestas, tensiones) se traducen en patrones visuales regulares sobre teclas blancas y negras.
2. Jerarquía visual Acorde vs. Escala: Diferenciar el esqueleto armónico (tónica y notas del acorde en azul) de las notas de paso y extensiones (escala en naranja).
3. Didáctica de deducción activa: Incorporar por defecto el estado de ocultación de acorde y escala para invitar a anticipar mentalmente las posiciones de las notas antes de activar la solución visual.
4. Agilidad en la localización de octavas y enarmonías: Entrenar la memoria espacial inmediata de las doce alturas a lo largo de un registro de tres octavas completas (C3 a C6, 37 teclas).

2. Mapa de la Interfaz

A. Barra Superior de Control de Modo y Notación

B. Caja de Reto (Modo Entrenamiento de Tónicas)

Visible exclusivamente al seleccionar el Modo Trainer:

• Indicador de Nota Objetivo: Muestra la altura asignada aleatoriamente con su correspondencia enarmónica cuando aplica (ejemplo: F# / Gb o C# / Db).
• Botón Nueva Nota Aleatoria: Dispara una nueva nota al azar acompañada de una referencia sonora inmediata para entrenar el oído y la memoria visual al unísono.

C. Matriz de Controles Armónicos (Modo Explorador)

Organizada en tres columnas independientes de selección:

1. Panel de Tónica (R):

• Rejilla de 12 selectores cromáticos: C, C#, D, Eb, E, F, F#, G, Ab, A, Bb, B.
• Al seleccionar una tónica, la nota fundamental se resalta en tono amarillo R sobre todas las octavas del teclado y se reproduce el acorde resultante.

2. Panel de Acorde (Tríadas & Acordes de 7ª):

• Botón "Ocultar Acorde": Activado por defecto para fomentar la deducción activa.
• Catálogo de 10 estructuras armónicas:
  • Tríadas: Mayor (1-3-5), Menor (1-b3-5), Disminuido (1-b3-b5), Aumentado (1-3-#5).
  • Acordes con Séptima: Mayor 7 (maj7), Menor 7 (m7), 7 Dominante (dom7), Semidisminuido (m7b5).
  • Suspensiones: Sus2 (1-2-5), Sus4 (1-4-5).
• Las notas que forman el acorde seleccionado se iluminan con marcadores en azul Klein Acorde.

3. Panel de Escala o Modo:

• Botón "Ocultar Escala": Mantiene el teclado limpio o focalizado solo en el acorde.
• Catálogo de 10 escalas y modos:
  • Modos Griegos Diatónicos: Mayor/Jónico, Dórico, Frigio, Lidio, Mixolidio, Eolio (Menor Natural), Locrio.
  • Escalas Menores Especiales: Menor Armónica, Menor Melódica.
  • Escala Pentatónica: Pentatónica Menor.
• Las notas que pertenecen a la escala pero no al acorde se destacan en tono naranja Escala, permitiendo apreciar visualmente tensiones disponibles (novenas, undécimas, trecenas).

D. Teclado de Piano Interactivo (3 Octavas: C3 a C6, 37 Teclas)

• Estructura física: 22 teclas blancas (anchura de 48 px) y 15 teclas negras (anchura de 28 px, suspendidas en la intersección superior).
• Marcadores Circulares Flotantes:
  • Círculo Amarillo: Fundamental / Tónica (R).
  • Círculo Azul: Notas estructurales del acorde (3, b3, 5, b5, #5, 7, b7).
  • Círculo Naranja: Notas de la escala / modo (2, b2, 4, #4, 6, b6).
• Etiquetas de Altura Absoluta: En el extremo inferior de cada tecla blanca se indica su nombre y número de octava científica (C3, D3, E3... C6).
• Interactividad Sonora Individual: Hacer clic sobre cualquier tecla dispara en tiempo real su tono correspondiente mediante un oscilador triangular suave en Web Audio API, con animación visual de pulsación (is-pressed).

E. Barra Inferior de Información Armónica

• Fórmula Armónica: Muestra la tónica activa, el tipo de acorde y la escala seleccionada.
• Secuencia de Notas: Lista los nombres exactos de las notas que componen el acorde (ejemplo: Notas del Acorde: C · E · G · B).

3. Teoría Explicada y Presets Canónicos

1. Los Semitonos Naturales del Piano

El teclado del piano evidencia de forma directa la estructura interválica irregular de la escala diatónica occidental:

• No todas las teclas blancas están separadas por una tecla negra.
• Existen dos pares de teclas blancas contiguas sin tecla negra intermedia: Mi - Fa (E - F) y Si - Do (B - C).
• Estos dos puntos señalan los semitonos diatónicos naturales de la escala de Do Mayor (grados 3-4 y 7-8).

2. La Jerarquía Armónica: Acorde vs. Escala

3. Las Tres Familias de Cuatríadas en el Teclado

• Familia Mayor (maj7): Fundamental + 3ª Mayor + 5ª Justa + 7ª Mayor. Distancias visuales de 4 semitonos + 3 semitonos + 4 semitonos.
• Familia Menor (m7): Fundamental + 3ª Menor + 5ª Justa + 7ª Menor. Distancias de 3 + 4 + 3 semitonos.
• Familia Dominante (dom7): Fundamental + 3ª Mayor + 5ª Justa + 7ª Menor. Distancias de 4 + 3 + 3 semitonos. Se aprecia el tritono visual formado entre la 3ª y la 7ª.