4. 🎹 El Piano: Arquitectura y Conducción

"Más que un teclado virtual, el piano de AulaChord es un cerebro que entiende la topografía de las teclas y las leyes de la armonía clásica para que tú solo te preocupes de la música."

El panel de piano es el corazón visual de la aplicación. No solo sirve para que "suenen notas"; es la interfaz inteligente donde el software traduce tus movimientos físicos en decisiones gramaticales impecables. Aquí te explicamos cómo funciona su lógica interna.

Atajo Rápido: Ctrl/Cmd + 1 para mostrar/ocultar este panel.

4.1 Lógica de Escritura Automática (El Asistente Silencioso)

Uno de los mayores retos al transcribir música es decidir qué nota pertenece a la mano izquierda (Clave de Fa) y cuál a la derecha (Clave de Sol). AulaChord elimina esta tarea tediosa por ti.

El Algoritmo Smart Split Point

En lugar de un punto de división rígido (como el Do central), el sistema utiliza una lógica de División Dinámica basada en cómo tocamos los humanos:

• La Regla de la Brecha (Gap Detection): El sistema escanea constantemente la distancia entre tus notas. Si detecta un "hueco" de 7 semitonos (una quinta justa) o más, asume inteligentemente que ese es el espacio natural entre tus pulgares. Así, la melodía sube al pentagrama superior y el acompañamiento baja al inferior de forma orgánica.
• Centro de Gravedad: Si tus notas están muy juntas (formando un cluster), el sistema calcula el promedio de altura. Las notas por debajo del Do Central (MIDI 60) tienden a la Clave de Fa, y por encima a la Clave de Sol, manteniendo siempre el equilibrio visual.
• Consistencia de Memoria: Para evitar que las notas "salten" de una clave a otra de forma errática mientras tocas, AulaChord intenta mantener el mismo punto de división mientras los acordes guarden una relación lógica entre sí.

Corrección Manual de Distribución

Si no estás de acuerdo con la distribución automática, puedes ajustarla manualmente:

• Ctrl/Cmd + F (Switch Staff): Mueve la nota seleccionada del pentagrama de Sol al de Fa (o viceversa) sin alterar su altura real (Pitch MIDI). Es la herramienta definitiva para corregir visualmente la distribución de manos de un acorde cruzado sin cambiar la música.
• Ctrl/Cmd + ↑: Desplaza la nota seleccionada un semitono hacia arriba.
• Ctrl/Cmd + ↓: Desplaza la nota seleccionada un semitono hacia abajo.
• Ctrl/Cmd + Alt + ↑: Desplaza la nota seleccionada una octava hacia arriba (puede moverla al pentagrama superior si cruza el umbral).
• Ctrl/Cmd + Alt + ↓: Desplaza la nota seleccionada una octava hacia abajo (puede moverla al pentagrama inferior si cruza el umbral).

4.2 Modos de Conducción (Voice Leading)

Esta es la configuración que define la "personalidad" de tu asistente. Puedes ajustarla desde la barra de herramientas (botón de Modo de Conducción) o desde el menú Configuración -> Modo de Conducción.

🔴 SATB Estricto (El Maestro Clásico)

Ideal para estudiantes de conservatorio y amantes de la polifonía coral. Aquí el Motor de Conducción actúa en su nivel más estricto:

• Alertas de Paralelas: Verás avisos inmediatos si escribes Quintas o Octavas Paralelas, el error más común en la armonía tradicional. (Recuerda que puedes activar las líneas de conexión visuales desde Menú Ver → Mostrar líneas de conducción.)
• Control de Cruce de Voces: El sistema vigila que la Soprano no baje del registro de la Contralto, ni que el Bajo suba por encima del Tenor, preservando la independencia de cada línea.
• Regla de Espaciado Coral: Las tres voces superiores (Soprano, Contralto, Tenor) no pueden separarse por más de una octava entre ellas; si lo hacen, el sistema te avisará que la sonoridad está perdiendo cohesión.
• Resoluciones Obligatorias: Si tocas una Sensible o una Séptima de dominante, el motor te recordará hacia dónde deben resolver para sonar con elegancia clásica.

🟡 Teclado Estricto (El Enfoque Pianístico)

Es el punto medio perfecto para la mayoría de los intérpretes clásicos:

• Mantiene el Rigor: Sigue avisándote de paralelas y resoluciones prohibidas.
• Libertad Física: Entiende que en un piano la mano derecha a menudo abarca más de una octava. El sistema es más permisivo con el espaciado siempre que la base armónica en la mano izquierda sea sólida.
• Espaciado Flexible: No penaliza clusters pianísticos donde las voces superiores están muy juntas, siempre que el bajo mantenga su independencia.

🟢 Libre (Teclado) (Improvisación Total)

Diseñado para el Rock, el Pop y el Jazz moderno, donde las "reglas" se usan como herramientas creativas y no como muros:

• Libertad de Movimiento: Puedes moverte en bloques paralelos (Planing) o usar "Power Chords" sin que el sistema te interrumpa.
• Creatividad sin Límites: No hay alertas por cruces de voces ni por saltos interválicos grandes. Es el modo ideal para cuando solo quieres que la música fluya sin juicios académicos.
• Voicings Abiertos: Explora voicings Jazz con séptimas y tensiones sin restricciones de espaciado tradicional.

4.3 Control de Visualización

Zoom del Pentagrama

Ajusta el tamaño de la notación según tus preferencias:

• + (Más): Aumenta el zoom (elementos musicales más grandes).
• - (Menos): Reduce el zoom (más música visible en pantalla).
• También disponible en Ver -> Zoom del menú principal.

El Splitter Vertical

La línea horizontal que separa el pentagrama del piano es interactiva:

• Arrastrar hacia arriba: Da más espacio al piano, reduciendo el pentagrama.
• Arrastrar hacia abajo: Da más espacio al pentagrama, reduciendo el piano.
• El sistema recuerda tu preferencia entre sesiones.

Ocultar/Mostrar el Panel de Piano

• Usa los iconos de instrumento en la barra de herramientas para alternar entre piano, guitarra, o ninguno.
• Cuando el panel está oculto, el pentagrama ocupa todo el espacio vertical.

Scroll del Piano (88 Teclas)

El piano virtual muestra 88 teclas reales. Para navegar:

• Usa la rueda del ratón mientras el cursor está sobre el piano para desplazarte horizontalmente.
• Las teclas activas (las que estás tocando) siempre intentan mantenerse visibles automáticamente.

4.4 Asistentes de Ejecución y Didáctica

La Traducción de Colores: Pentagrama vs. Piano

Para evitar ambigüedades visuales, AulaChord separa intencionalmente el lenguaje de análisis del lenguaje de ejecución:

• Pentagrama (paleta analítica, 5 niveles): distingue masa estructural, gravedad tonal, reglas de disposición y errores estrictos. La lógica pedagógica detallada de cada nivel — incluyendo el doble rol del amarillo — está en §8.5: Sistema de Gravedad Tonal.
• Piano Virtual (paleta de ejecución, 3 niveles): 🟡 Amarillo = nota activa/presionada o evento en foco de navegación (←/→), 🔵 Azul = nota individual seleccionada con clic de ratón (activa modo de edición: Del, transposición, enarmonía), 🔴 Rojo = cualquier alerta/error de validación.

En otras palabras: lo que en el pentagrama aparece como advertencia de disposición (amarillo pedagógico) o infracción grave (rojo), en el piano se resume siempre en rojo para priorizar una lectura rápida mientras tocas.

La Alarma Unificada del Piano

Mientras trabajas, necesitas reaccionar rápido. Por eso el Piano Virtual usa una alarma visual unificada: cualquier nota que aparezca como Amarilla (Regla de Disposición) o Roja (Error Estricto) en el pentagrama se iluminará en Rojo en el teclado del piano. No diferenciamos entre "aviso moderado" y "error grave" porque en ese momento necesitas saber que hay algo que revisar, sin el ruido visual de múltiples colores.

Piensa en el Pentagrama como tu panel de diagnóstico (detallado, con 5 colores) y el Piano como tu alarma general (rápida, con 3 colores: Amarillo = activo/en foco, Azul = nota individual editando con clic, Rojo = revisar).

El Semáforo de Errores Visuales

Cuando violas una regla del modo de conducción seleccionado, el sistema te lo comunica de forma visual e interactiva para que aprendas de tus errores:

1. Notas Rojas (automático) y Líneas de Conducción (opcional): Las notas que causan el conflicto se pintan automáticamente de color rojo — esto ocurre siempre, sin ninguna configuración previa. Las líneas rojas que conectan visualmente las voces infractoras son una función separada y desactivada por defecto para evitar saturación visual: actívalas en Menú Ver → Mostrar líneas de conducción. Una vez activas, y si estás en modo SATB Estricto o Teclado Estricto, aparecerán al detectarse un movimiento paralelo prohibido (ej. octavas o quintas), indicándote exactamente de dónde a dónde ocurrió el error.

2. Veredicto al Clic: Al dar clic sobre una de estas notas rojas, un mensaje claro te explica qué ha pasado en la Barra de Estado (Footer) (ej. "Quintas paralelas entre Bajo y Tenor").

3. Panel del Tutor (Ctrl/Cmd + T): La herramienta para llevar tu progresión a otro nivel. El Tutor propone caminos creativos basados en la transición actual:

   • Voicings modificados que suavizan el movimiento entre voces.
   • Extensiones o inversiones que enriquecen el color armónico.
   • Acordes alternativos funcionalmente equivalentes pero más sofisticados.

Nota: Los errores de conducción de voces se visualizan en el pentagrama (notas rojas, líneas rojas opcionales) y el diagnóstico exacto aparece en la Barra de Estado al hacer clic sobre la nota roja. El Panel del Tutor no muestra errores; te da las herramientas para superarlos con soluciones musicalmente sólidas.

4.5 Digitación de Piano: Tu Partitura de Interpretación 🖐️

El Modo de Digitación convierte el teclado visual en una superficie de anotación pedagógica. Lo activas con el botón de Digitación (👋) en la barra de herramientas del panel de piano.

Importante: Mientras el modo Digitación está encendido, el clic sobre el piano queda reservado exclusivamente para asignar dedos — ya no produce sonido ni registra notas en el pentagrama. Para escuchar el acorde mientras digitas, usa tu teclado MIDI o el QWERTY; ambos funcionan con normalidad en cualquier estado del modo Digitación.

El Color que te Dice Cuál Mano Usa Qué Tecla

Aquí la novedad más visible: cuando el modo de Digitación está activo, las teclas del piano ya no se ponen todas del mismo color amarillo. El color cambia según la clave musical en que está escrita la nota en el pentagrama:

Ese color no lo decides tú; lo decide la posición de la nota en el pentagrama. Si un Re3 está escrito en el pentagrama de Fa, aparecerá en rosa. Si está en el de Sol, aparecerá en cian. El software lee la partitura y te traduce la visión en el teclado.

Piénsalo así: el piano te muestra en color la "geografía de manos" que el compositor ya decidió al escribir las notas. No tienes que calcular nada: miras el color y sabes qué mano va ahí.

Cómo Asignar Dedos: Clic Izquierdo

Al hacer clic izquierdo sobre cualquier tecla en modo de digitación:

• Tecla sin número: Se añade un indicador circular con el siguiente número de dedo sugerido (1=pulgar, 5=meñique). El sistema avanza solo: 1→2→3→4→5→1.
• Tecla con número (primer clic): Se selecciona el indicador (queda resaltado).
• Tecla con número seleccionado (segundo clic): Se elimina el indicador.

La Magia de la Auto-Detección de Mano

Aquí está el dato más importante de este modo: cuando haces clic en una tecla vacía, el sistema detecta automáticamente si esa nota pertenece a la mano derecha o a la izquierda, basándose en su clave en el pentagrama.

Lo que antes requería que tú seleccionaras "mano derecha" o "mano izquierda" en un menú, ahora simplemente sucede:

• Notas en clave de Sol → se asignan a la mano derecha con contador ascendente (1→2→3…).
• Notas en clave de Fa → se asignan a la mano izquierda con contador descendente (5→4→3…).

Esto significa que puedes seleccionar un acorde completo de dos claves — por ejemplo, un Am7 con Sol grave en la clave de Fa y Mi4/Do4/La4 en la de Sol — hacer clic en todas las teclas de izquierda a derecha, y el sistema asignará los dedos correctos a cada mano sin que tú tomes ninguna decisión.

💡 Pro-Tip: Switch Staff para corregir de raíz. Ya que el color y la mano se detectan según el pentagrama, la forma más estructural de arreglar una digitación es arreglar la partitura. Si tienes una nota en la clave de Sol (Cian/Derecha) que por ergonomía debe tocarse con la mano izquierda, selecciónala en el pentagrama y presiona Ctrl/Cmd + F (Switch Staff). La nota pasará a la clave de Fa, y automáticamente el piano la tratará como mano izquierda (Rosa).

Cambiar de Mano: Clic Derecho Instantáneo

Si la auto-detección no coincide con lo que quieres tocar (quizás decides cruzar las manos para un efecto específico), un clic derecho sobre cualquier indicador ya colocado alterna su mano al instante:

¿Asignado a Mano Derecha (cian)?  →  Clic derecho  →  Pasa a Mano Izquierda (rosa)
¿Asignado a Mano Izquierda (rosa)? →  Clic derecho  →  Pasa a Mano Derecha (cian)

No aparece ningún menú. El cambio es inmediato. El color del indicador se actualiza al instante.

Cambiar el Número de Dedo

¿El sistema sugirió "3" pero quieres usar el "2"? Una vez que el indicador está seleccionado (primer clic), pulsa la tecla numérica 1, 2, 3, 4 o 5 de tu teclado de escritura para reemplazar el número. El sistema recalibra automáticamente el contador del ciclo para que el siguiente dedo siga siendo lógico.

La Digitación Viaja con el Acorde

Esta es la característica que cambia todo el flujo de trabajo para la pedagogía: la digitación se guarda automáticamente dentro del acorde, sin que tú hagas nada.

Funciona así:

1. Seleccionas un acorde en el pentagrama (flecha ← →).
2. Activas el modo de digitación y anotas los dedos.
3. Navegas a otro acorde con las flechas del teclado.
4. Regresas al acorde anterior.
5. Los dedos que anotaste siguen exactamente donde los dejaste, con sus colores de mano correctos.

No hay botón "Guardar Digitación". No hay archivos adicionales. La digitación es parte del acorde, igual que las notas o el análisis armónico. Si guardas el archivo .aula, la digitación se guarda también. Si abres el archivo en otra sesión, la digitación sigue ahí.

Es como si cada acorde tuviera su propia "memoria de manos". Puedes digitizar toda una pieza acorde por acorde, navegando con las flechas del teclado, y el resultado es una partitura interactiva de interpretación completa.

Limpiar la Digitación

Si quieres empezar de cero para un acorde específico, el botón de limpiar en la barra del piano borra todos los indicadores del acorde activo. También puedes borrar indicadores individuales haciendo doble clic sobre ellos (seleccionar + segundo clic).

Resumen Visual del Modo de Digitación