3. Entradas QWERTY, MIDI y otras 🎹

"No importa si tienes un Steinway de cola o el teclado de tu ordenador portátil; AulaChord está diseñado para que tu música fluya sin obstáculos técnicos."

Bienvenido a la sección dedicada a la puerta de entrada de tu creatividad. AulaChord es agnóstico al hardware: no te obliga a usar un dispositivo específico, sino que se adapta a lo que tengas a mano en cada momento. Aquí te explicamos cómo cada uno de estos "portales" entiende tu forma de tocar.

3.1 Teclado MIDI Externo (El Portal Físico)

Esta es la forma más natural y expresiva de interactuar con el software. Al conectar tu piano digital o controlador MIDI USB, la aplicación se convierte en una extensión táctil de tus dedos.

• Plug & Play con Detección Automática: Simplemente conecta tu teclado. AulaChord escanea los puertos MIDI automáticamente cada 2 segundos, así que tu dispositivo aparecerá en la lista sin que hagas nada. Si por alguna razón no aparece, usa Ayuda -> Refrescar MIDI para forzar un escaneo inmediato.
• MIDI Bluetooth: ¿Usas un teclado inalámbrico? AulaChord es compatible con dispositivos MIDI Bluetooth. Vincula tu teclado desde la configuración de tu sistema operativo y aparecerá en la lista de dispositivos MIDI.
• Manejo de Sensibilidad (Velocity):
  • Audio: Respetamos la fuerza de tu interpretación para que sientas el instrumento.
  • Notación: El pentagrama ignora la fuerza física para garantizar una partitura limpia y profesional, centrada en la claridad gramatical.

3.2 Teclado QWERTY (El Piano de Bolsillo) 💻

Tu ordenador es un instrumento sorprendentemente capaz. Ideal para cuando estás viajando o no tienes espacio para un teclado físico.

Mapeo Cromático Ergonómico (3 Filas de Teclas)

El teclado QWERTY se divide en tres filas lógicas que replican la estructura de un piano:

Nota: Las tres filas producen las mismas alturas en términos de pitch (Do# = Reb), pero la escritura en el pentagrama usará la enarmonía correspondiente según la fila que pulses. Esto te da control preciso sobre cómo se escribe la música. (¿Buscas un Dob? Ingresa un Si natural usando la fila media y presiona la tecla Q para rotar su enarmonía).

El Secreto del Orden: Agrupación Automática de Acordes ⏱️

Es humanamente imposible pulsar tres teclas al mismo milisegundo. En un editor normal, esto escribiría letras seguidas. AulaChord soluciona esto: El sistema detecta cuándo mantienes varias teclas presionadas simultáneamente y las agrupa en un acorde vertical perfecto en lugar de arpegios desorganizados. Mientras sigas sujetando teclas, el acorde seguirá "armándose" visualmente. Solo cuando sueltes todas las teclas, el acorde se consolidará.

Atajos Maestros de Construcción 🏗️

Si tienes una nota seleccionada en el pentagrama, puedes "armar" un acorde vertical en milisegundos:

• Shift + [2-9]: Añade el intervalo correspondiente hacia arriba (ej. Shift + 3 para la tercera).
• Shift + Alt + [2-9]: Añade el intervalo hacia abajo (ej. Shift + Alt + 3 para la tercera inferior).
• Space (Espacio): Avanza al siguiente pulso de la grabación.
  (Válido para teclas del 2 al 9). Es como tener un arquitecto de acordes bajo tus dedos.

Control de Octavas

Usa las teclas Flecha Arriba y Flecha Abajo para cambiar de octava. Mira la Barra de Estado inferior para confirmar tu registro actual (ej. Octava: 4).

¿Y si tengo el panel de guitarra activo? El QWERTY siempre escribe en el pentagrama, sin importar qué panel esté visible. El panel de guitarra o de piano no cambia el destino de las notas del teclado QWERTY. Si quieres ingresar notas a través del instrumento visual, hazlo con el ratón: haz clic en las teclas del piano virtual o en los trastes del diapasón. Esos clics sí interactúan directamente con el panel activo antes de enviarse al pentagrama.

3.3 Piano Virtual en Pantalla 🖱️

Ideal para pantallas táctiles o para buscar melodías rápidas con el ratón.

• Interacción Visual: Haz clic en las teclas para que suenen. Si tu pantalla es multitouch, puedes tocar acordes con varios dedos.
• Código de Colores (Ejecución vs. Análisis): En el Piano Virtual: 🟡 Amarillo = nota activa o en foco de navegación (←/→); 🔵 Azul = nota individual seleccionada con clic de ratón (modo edición); 🔴 Rojo = cualquier alerta de validación. En el Pentagrama el amarillo tiene un segundo rol pedagógico (advertencia de disposición) y los niveles de color son más detallados — ver §8.5 para la explicación completa. En Modo Digitación el piano usa Cian y Rosa en lugar de los colores de ejecución.

3.4 El Diapasón de Guitarra (Click-to-Build)

Ideal para guitarristas que quieren "dibujar" sus propias posiciones:

• Selectores de Barra: La manera más rápida de agregar un acorde es a través de las listas desplegables ubicadas en la barra de controles del panel de guitarra (la banda horizontal entre el pentagrama y el diapasón). Selecciona la Raíz, la Calidad y la Inversión del acorde, y AulaChord dibujará y validará la posición automáticamente en el diapasón.
• Construir Acorde (Modo Manual): Activa este botón para entrar en el modo de edición punto a punto. Haz clic en los trastes para añadir notas.
• Botón ↑ (Commit): Una vez que tu diseño en el diapasón sea perfecto, pulsa el botón ↑ en la barra de controles o la tecla Enter (asegurándote de que el panel de la guitarra tenga el foco de acción) para enviarlo al pentagrama.

Nota sobre el Semáforo de Entrada: El botón ↑ y la tecla Enter en el panel de guitarra siempre escriben en el pentagrama, independientemente del estado del Semáforo de Entrada (ON/OFF). A diferencia de la entrada MIDI o QWERTY —que respetan el estado del Monitor—, el Commit es una acción editorial explícita: cuando diseñas un acorde en el diapasón y confirmas, tu intención de escribirlo es inequívoca. Ver §5.3 para más detalle.

• Botón Guías: Activa o desactiva la visualización de los nombres de las notas diatónicas sobre el mástil según la tonalidad activa.
• Notas Exactas: Usa este selector para decidir si AulaChord debe buscar el voicing más ergonómico o respetar exactamente los trastes que tú elijas.
• Ergonomía Real: Si marcas una posición físicamente imposible (ej. traste 1 y traste 10 a la vez), el sistema te permitirá escribirla, pero el análisis te recordará que es un reto ergonómico.

3.5 Pegar desde Portapapeles (Ctrl/Cmd + V) 📋

Una de las funciones más potentes y menos conocidas: puedes copiar una progresión de acordes desde cualquier fuente de texto (una página web, un documento, un chat) y pegarla directamente en AulaChord.

Cómo funciona:

1. Copia un texto con nombres de acordes, por ejemplo: Am7 | Dm7 | G7 | Cmaj7
2. En AulaChord, presiona Ctrl/Cmd + V.
3. El sistema parsea el texto, reconoce los acordes, y los inserta en el pentagrama con voicings automáticos.

Consejo: Los separadores comunes (|, -, ,, espacios) son reconocidos automáticamente. No necesitas formatear el texto de una manera específica.

Duración rítmica predeterminada: Todos los acordes pegados desde texto plano se insertan automáticamente con una duración fija de negras (1 pulso), ignorando la figura rítmica que tengas seleccionada en la barra de herramientas. AulaChord transcribe la arquitectura armónica al instante (los acordes correctos), pero asume un ritmo constante de negras. Tú debes usar los controles de duración del pentagrama para darle el 'groove' rítmico real de la canción. Puedes editar la duración de cada acorde libremente en el pentagrama una vez pegados. Nota: Al pegar desde JSON de IA, AulaChord respeta las duraciones matemáticas incluidas en las respuestas generadas por el asistente.

💡 Tip: Una vez pegados los acordes, selecciónalos en el pentagrama y presiona 6 (blanca), 7 (redonda) o . (puntillo) para ajustarlos al groove real de la canción.

3.5.1 Copia Interna (Voicing Exacto)

A diferencia del pegado desde fuentes externas que usa un algoritmo heurístico para crear nuevos voicings en tiempo real, la copia interna dentro de AulaChord clona la disposición exacta de las voces preservando idénticamente tu voicing, las inversiones y las alteraciones sin cambios ni reinterpretaciones.

Procedimiento:

1. Selecciona el evento (acorde o nota) que deseas duplicar haciendo clic sobre él en el pentagrama.
2. Presiona Ctrl/Cmd + C para copiarlo.
3. Presiona Ctrl/Cmd + V para pegarlo.
   • Si hay un evento seleccionado al pegar, el clon se insertará justo después de ese evento.
   • Si no hay nada seleccionado, el clon se añade al final del documento.

Extracción Inteligente de Acordes (Lyrics Filter)

AulaChord puede extraer solo los acordes de un texto que mezcla cifrados con letras de canciones. Por ejemplo, si pegas:

C             G7
Noche de paz
C                   G7
Noche de amor
F           G7               C
Todo duerme en derredor

El sistema usará heurísticas inteligentes para identificar que C, G7 y F son acordes, mientras que "Noche", "de", "paz", etc. son palabras normales que se ignoran. Esto te permite copiar directamente desde sitios de letras con acordes sin necesidad de limpiar el texto.

Integración con Inteligencia Artificial

AulaChord puede parsear directamente las respuestas JSON de ChatGPT, Gemini o Claude:

1. Usa Ctrl/Cmd + Shift + A para generar un prompt profesional con tu contexto musical.
2. Copia el prompt y pégalo en tu IA favorita.
3. La IA responderá con un JSON estructurado.
4. Copia la respuesta y pégala en AulaChord (Ctrl/Cmd + V).
5. Los acordes aparecerán con voicings, y los metadatos educativos de la IA se preservarán en el archivo.

3.6 Control del Flujo de Trabajo (ON/OFF) 🚦

El Semáforo de Entrada (Atajo: Ctrl/Cmd + K) es tu mejor aliado estratégico:

1. 🔴/⚪ Monitor (OFF): Es tu laboratorio. Prueba sonidos, busca la melodía adecuada. Todo suena y se analiza, pero el papel se mantiene limpio.
2. 🟢 Escritura (ON): Es tu cámara de grabación. Cada nota que toques se añade a la historia del pentagrama.

Override Manual (El Toque Maestro)

Tú siempre tienes la última palabra. Si quieres mover una nota, cambiar su enarmonía o reinterpretar el análisis de un acorde, usa los siguientes atajos:

• Ctrl/Cmd + ↑/↓: Desplaza la nota seleccionada un semitono arriba o abajo (transposición cromática).
• Ctrl/Cmd + Alt + ↑/↓: Desplaza la nota seleccionada una octava completa arriba o abajo.
• Q (con un evento o nota seleccionada): Cicla entre las enarmonías disponibles. Si tienes una nota individual seleccionada, cambia solo esa nota (Do# ↔ Reb) y reescribe el resto del acorde en consecuencia. Si tienes el acorde completo seleccionado, cicla la ortografía de la raíz y reescribe todas las notas del acorde según el nuevo nombre (ej. Gb∆7 ↔ F#∆7).
• Ctrl/Cmd + A (con un acorde seleccionado): El motor puede ver el mismo grupo de notas como varios acordes igualmente válidos. Por ejemplo, Do-Mi-Sol-La puede ser C6 o Am7/C. Cada pulsación rota a la siguiente lectura, cambiando el cifrado, el grado romano y —si es necesario— la ortografía enarmónica de las notas para que sea coherente con el nuevo análisis. Las alturas MIDI no se alteran.
• Del (con un evento seleccionado): Borra el evento del pentagrama sin necesidad de usar el ratón. Útil para eliminar una nota o acorde mal ingresado justo después de tocarlo. El resto de la secuencia se reajusta automáticamente.
• Ctrl/Cmd + Z: Deshace la última acción. Puedes retroceder hasta 50 pasos. Si borrar con Del fue demasiado, este atajo es tu red de seguridad inmediata.