PARTE 0 — CONTEXTO

0.1 Herramientas para generar, explorar y transformar ideas musicales

El Editor Musical (MI y MIII) forma parte de un conjunto de aplicaciones dirigidas a la improvisación musical. Su finalidad es proporcionar un entorno de trabajo en el que el usuario pueda generar ideas musicales, experimentar con ellas, descubrir nuevas relaciones entre sus elementos y desarrollar materiales que puedan servir como punto de partida para la improvisación o la composición.

La aplicación no se plantea como un editor convencional cuya finalidad principal sea escribir una obra musical terminada. Su función es facilitar la interacción con materiales musicales y ofrecer distintas maneras de modificarlos, combinarlos y observar sus posibilidades. Una idea puede surgir de una secuencia introducida por el usuario, de un proceso generativo, de una transformación o de la combinación de varios materiales.

Para ello, reúne herramientas que permiten trabajar con:

• Materiales seriales y patrones: series simétricas, retrogradaciones, inversiones y series dodecafónicas.
• Estructuras a dos manuales (MI y MIII): distribución y organización de materiales entre ambos manuales.
• Pulsos y claquetas: herramientas para explorar e interiorizar la organización métrica y rítmica.
• Transformaciones musicales: operaciones que permiten obtener variantes de un material inicial y comparar sus resultados.
• Procesos generativos: combinación de materiales (por ejemplo, tonalidad y ritmo), aplicación de filtros, espaciamiento y realineamiento mediante el mínimo común múltiplo (MCM), así como exploración de la matriz dodecafónica. Nuevo
• Edición visual y textual sincronizada: posibilidad de trabajar desde la partitura o desde el texto musical, manteniendo la correspondencia entre ambas representaciones. Nuevo

La escucha y la observación son partes fundamentales de este proceso. El usuario puede generar un material, escucharlo, examinar su organización, modificarlo y volver a escucharlo para valorar el resultado. Así, la aplicación permite pasar de una idea inicial a distintas posibilidades musicales sin necesidad de que exista previamente una composición definida.

El objetivo es convertir la interacción con los materiales musicales en una forma de generar y desarrollar ideas. La escritura, la edición y la representación en partitura son medios para explorar esas ideas, no un fin en sí mismos.

0.2 Los dos manuales: MI y MIII

La aplicación trabaja con dos manuales del acordeón:

• MI — manual derecho. Puede ser de teclas o de botones, según el instrumento.
• MIII — manual izquierdo, de botones.

El manual MII (bajos estándar o Stradella) no se usa en esta app: el editor se centra en MI + MIII, la combinación típica de un acordeón con bajos cromáticos.

Ambos manuales tienen la misma extensión y se escriben de forma independiente: no hay dependencia entre ellos. Lo único que cambia es con qué mano se tocan (derecha = MI, izquierda = MIII).

Cada manual tiene su propio pentagrama:

• MI → pentagrama superior, clave de Sol por defecto.
• MIII → pentagrama inferior, clave de Fa por defecto.

Además, en el proceso generativo, MI puede actuar como serie tonal y MIII como serie rítmica, y fusionarse.

0.3 Qué aporta esta app a quien transforma material

0.4 Contexto de uso

La aplicación forma parte de un conjunto de aplicaciones dirigidas a la improvisación para acordeón.

PARTE I — GUÍA DE USO

Los flujos descritos en esta parte se realizan en el editor. Puedes abrirlo en otra pestaña: 🎼 Abrir el editor.

1. ¿Qué es esta aplicación?

Un entorno web que funciona con un solo archivo HTML para editar, transformar, visualizar y reproducir fragmentos musicales escritos en notación textual, renderizados como partituras de dos pentagramas enlazados por una llave y barras de sistema:

• MI → manual derecho (de teclas o de botones, según el instrumento). Por defecto en clave de Sol.
• MIII → manual izquierdo (de botones). Por defecto en clave de Fa.

Puede entenderse como un editor de ideas musicales: un entorno pensado principalmente para generar, explorar y desarrollar materiales mediante series, patrones simétricos, retrogradaciones, inversiones, procesos generativos y matrices dodecafónicas. La entrada y edición de notas permiten aportar o modificar materiales; la partitura y la reproducción ayudan a observarlos y escucharlos durante ese trabajo.

No se limita, por tanto, a preparar una partitura terminada: permite trabajar con materiales provisionales, probar variantes y decidir qué posibilidades merece la pena desarrollar.

Usa VexFlow 5 para el grabado musical, Web Audio API para el sonido y Web MIDI API para entrada desde teclados externos.

2. Estructura de la interfaz

2.1 Cabecera superior

2.2 Panel lateral izquierdo

Todo el panel lateral está compuesto por bloques colapsables. Se pueden plegar y desplegar individualmente, y el estado se guarda entre sesiones (§11bis). El orden es:

1. 📖 Sintaxis y Atajos (resumen).
2. ⚙️ Configuración de Claves y Sistemas.
3. ⏱️ Claqueta MIDI y Cuenta Atrás.
4. 🔍 Inspector (aparece al seleccionar algo). Agrupado por familias.
5. 🎹 Entrada rápida: incluye las dos representaciones visuales de MI — el piano (manual de teclas) y los botones (manual de botones). Ver §3.9.
6. 🎼 Proceso generativo — Iniciador → Generador → Voz → Historial → Matriz (ver Parte IV).
7. ⚡ Asistente de Patrones y Transformaciones — actúa sobre la selección o el manual activo; no encadena pasos.
8. Cuadros de texto Notas para MI y Notas para MIII.
9. Botones Generar Partituras y Limpiar.
10. 📋 Registro de actividad.

2.3 Área de partituras (derecha)

Cada sistema muestra MI arriba y MIII abajo, enlazados por llave y barra final. Esta zona puede verse a pantalla completa.

3. Entrada y edición de notas

3.1 Sintaxis básica

<duracion> <nota1> <nota2> ... <notaN>

Regla básica: la primera palabra de cada línea es la duración; todo lo que sigue son las notas del mismo evento (un acorde si hay varias). Para tener varios eventos, usa una línea por evento.

Ejemplos:

4 C4              ← una negra (C4)
4 C4 D4 E4 F4     ← un acorde de cuatro notas, todas negras
4 C4 E4 G4        ← un acorde de tres notas
4 rest            ← un silencio de negra
2. Bb3            ← una blanca con puntillo

4 C4
4 D4
4 E4
4 F4              ← cuatro negras consecutivas (una por línea)

• Cambios en los textareas reflejados en tiempo real (debounce de 200 ms).

3.2 Duraciones aceptadas

3.3 Notas

• Notación anglosajona: C4, D#5, Bb3, F#2…
• Alteraciones: # sostenido, b bemol, n becuadro.
• Octava numérica estándar (C4 = Do central).

3.4 Silencios

4 rest
rest 4
silencio 4
s 4

3.5 Ligaduras

El símbolo ~ al final de una línea liga su última nota con la primera nota de la línea siguiente, si tienen la misma altura.

4 C4 ~
4 C4

Se interpreta como una sola nota lógica con la duración sumada. Si cruza la barra de compás, se parte en trozos y se liga.

3.6 Cambio de compás

time 3/4
time 6/8
compas 2/4
m 5/4
t 7/8
c 2/2

Los cambios de compás pueden generar compases de silencio. Cuentan como contenido musical y participan en las transformaciones.

3.7 Entrada rápida e interactiva

Además de la entrada por texto, la app ofrece varias formas de introducir notas con el ratón y con el instrumento:

• Panel de botones rápidos: manual activo (MI / MIII) + duración + puntillo + desplazamiento de octava.
• Escribir en un compás seleccionado: haz clic en el espacio del compás y toca notas; se añaden allí. Si los compases anteriores están incompletos, la app inserta silencios para que la nota caiga en el compás elegido. Si haces clic sobre un silencio de relleno, la nota ocupa ese espacio y el resto conserva silencios. Si seleccionas la última nota del manual y escribes A–G, la nueva nota se añade en el compás siguiente; con Shift+A–G se añade allí un silencio. El compás anterior se completa automáticamente con silencios si hace falta.
• ⏸ Silencio (Shift+Tecla): inserta un silencio con la duración activa.
• Dos representaciones visuales de MI:
  • Piano: manual de teclas (disposición cromática horizontal).
  • Botones: manual de botones (disposición en filas diagonales).
• Teclado MIDI externo: detecta la pulsación física de un instrumento MIDI, mide duración real y aplica silencios inteligentes.

3.8 Entrada MIDI

• Medir duración real.
• Silencios automáticos (umbral configurable, por defecto 500 ms ≈ negra).
• Agrupación de acordes (40 ms).
• Contexto de alteraciones según lo ya escrito.

3.9 Las dos representaciones visuales de MI

MI es el manual derecho. Puede ser de teclas o de botones, según el instrumento. Para poder introducir notas con el ratón en cualquiera de las dos disposiciones, el editor ofrece dos representaciones visuales:

Comportamiento

• Al pulsar una tecla del piano o un botón, la app reproduce la nota y la inserta en el manual activo (MI o MIII) con la duración activa.
• La inserción respeta el contexto de alteraciones del manual activo.
• Ambas representaciones insertan en el manual que esté activo. Si el usuario tiene MIII seleccionado, la nota se inserta en MIII.

El piano se genera dinámicamente al cargar la página, con anchos proporcionales al espacio disponible. Los botones están fijos en el HTML, con su disposición de tres filas.

Relación con el teclado físico

El piano y los botones son representaciones visuales, no un teclado físico. Para tocar con un instrumento real, se usa la entrada MIDI (§3.8). Para escribir con el teclado del ordenador, se usan las teclas A–G y Shift + A–G (§9.7).

Nota histórica: en versiones anteriores del editor existía un "teclado virtual" cromático (C4–B5). Ha sido sustituido por estas dos representaciones, más fieles a los dos tipos de manual derecho.

4. Selección, inspector y deselección

4.1 Selección de compases

• Clic simple en un compás → lo selecciona (borde azul).
• Shift + clic en otro compás → selecciona el rango (borde azul).
• Aparece el Inspector: MI [cX–cY].

4.2 Selección de nota individual

• Clic en una nota → selecciona el acorde entero. Además, selecciona la línea correspondiente en el textarea (§12bis).
• Ctrl/Cmd + clic en una nota → alterna esa nota del acorde (toggle).
• Ctrl/Cmd + Shift + clic en una nota → añade esa nota a la multiselección no contigua (verde). Ver §13bis.
• Al seleccionar una nota individual, la app reproduce solo las notas seleccionadas como previsualización.
• Flechas ↑ / ↓ → mueven el foco entre las notas apiladas del acorde (de grave a agudo).
• Flechas ← / → → navegan secuencialmente por las notas del manual activo.

4.3 Deselección

• Esc → deselecciona siempre, incluso dentro de un textarea.
• Clic en zona vacía de la partitura → deselecciona.
• Botón "Deseleccionar" en el Inspector.

4.4 Panel Inspector (organizado por grupos)

Los grupos sin ningún botón visible se ocultan automáticamente.

5. Cruzada MI + MIII

La cruzada permite aplicar la misma transformación a dos rangos de compases, uno en cada manual, a la vez.

5.1 Cómo crear la cruzada

• Ctrl + clic en un compás del otro manual → añade la cruzada (borde violeta).
• Ctrl + Shift + clic en un compás del otro manual → extiende el rango cruzado.
• Botón "Aplicar a ambos manuales" → extiende la selección principal al otro manual (mismos índices de compás).

5.2 Cómo quitar la cruzada

• Botón "Quitar cruzada" en el Inspector.
• Esc → limpia principal y cruzada.
• Clic normal en cualquier compás → reemplaza la principal y borra la cruzada.

5.3 Restricciones de la cruzada

• La cruzada solo puede estar en el manual opuesto a la principal.
• Solo puede haber una cruzada activa a la vez.
• Es un gesto de selección, no de contenido.

5.4 Aplicar transformaciones a ambos manuales

• Con cruzada activa y el checkbox Aplicar transformaciones a ambos manuales marcado (por defecto), las transformaciones actúan sobre ambos manuales.
• Si se desmarca, solo actúan sobre el manual principal.

6. Copiar y pegar compases

6.1 Copiar

1. Selecciona un rango de compases (clic + Shift+clic).
2. Pulsa el botón 📋 Copiar compases del Inspector (o Ctrl+C fuera de un textarea).
3. Aparece el indicador: 📋 Portapapeles: N compás(es) de MI/MIII.

6.2 Pegar

1. Selecciona el compás o rango de destino (mismo u otro manual).
2. Pulsa el botón 📋 Pegar compases del Inspector (o Ctrl+V fuera de un textarea).
3. Los compases del destino se reemplazan por los copiados.

6.3 Notas

• El portapapeles es interno: se pierde al recargar la página.
• Al pegar, se hace un snapshot en el historial.
• Si el rango origen y destino tienen longitudes distintas, se reemplazan tal cual.

6bis. Copiar y pegar fragmentos musicales

Además del portapapeles de compases, la app incluye un portapapeles de fragmentos para copiar y pegar contenido musical dentro de un compás. Los dos portapapeles son independientes.

6bis.1 Seleccionar un fragmento

• Shift + clic sobre una nota o silencio → marca el inicio del fragmento.
• Shift + clic sobre otra nota o silencio del mismo manual → extiende el fragmento hasta ahí.
• El fragmento se pinta en naranja.

6bis.2 Indicador del portapapeles de fragmentos

🎼 Fragmento copiado: N beat(s) de MI (M eventos)

6bis.3 Copiar fragmento

1. Selecciona un fragmento con Shift+clic.
2. Pulsa 🎼 Copiar fragmento en el Inspector, o Ctrl+Shift+C.
3. La app corta las ligaduras exteriores.

6bis.4 Pegar sustituyendo (Ctrl+Shift+V)

• Reemplaza los primeros N beats del compás destino con el fragmento.
• Lo que hubiera después de los N beats se conserva.
• Si el compás queda incompleto, se rellena con silencios reales.

6bis.5 Pegar insertando (Ctrl+V)

• Inserta el fragmento al principio del compás destino, desplazando el resto hacia la derecha.
• Si el compás se desborda, el excedente se desplaza en cascada a los compases siguientes.

6bis.6 Reglas y limitaciones

• El portapapeles de fragmentos es interno: se pierde al recargar la página.
• El pegado se hace siempre en el manual del compás destino.
• Si el compás destino es de relleno, la app lo materializa primero como silencios reales.

6bis.7 Diferencia con el portapapeles de compases

7. Reproducción, claqueta y pantalla completa

7.1 Reproductor integrado

• Reproduce partitura completa o rango seleccionado.
• Si hay cruzada activa, reproduce el rango de MI y el de MIII simultáneamente.
• Web Audio API con osciladores senoidales.
• MI: volumen 0.2. MIII: volumen 0.15.

7.2 Reproducir / Parar

• Cuando no hay reproducción: ▶ Reproducir.
• Al pulsarlo, empieza la reproducción y el botón cambia a ⏹ Parar (rojo).
• Al pulsarlo de nuevo, la reproducción se detiene al instante.
• Al terminar de forma natural, el botón vuelve a ▶ Reproducir.
• Marca 🔁 Bucle en la cabecera antes de reproducir para repetir continuamente la partitura o el rango seleccionado.
• Las notas de la vuelta siguiente se programan antes de que termine la actual para evitar una pausa audible. Pulsa ⏹ Parar para detener el bucle.
• Enter → alterna Play/Stop desde cualquier parte (salvo si el foco está en un <textarea>, <input> o <button>).

7.3 Sincronización visual en vivo

• MI → naranja #ea580c.
• MIII → verde #16a34a.
• Sincronización por requestAnimationFrame anclado a audioCtx.currentTime.

7.4 Claqueta, cuenta atrás y grabación MIDI

• BPM configurable (40–240).
• Cuenta atrás opcional de 1 compás (4 beats).
• Espacio inicia/detiene la claqueta. Mientras suena, la app queda en modo grabación MIDI.

7.5 Pantalla completa

• Botón ⛶ Pantalla completa en la cabecera.
• Al comenzar la reproducción, la partitura entra automáticamente en pantalla completa (si no lo estaba ya).
• Al terminar o detenerse, sale automáticamente — solo si fue la reproducción quien la activó.
• El SVG se reescala proporcionalmente gracias a su viewBox.
• Esc también sale de pantalla completa (nativo del navegador).

7.6 🔔 Pulso de reproducción

• Checkbox 🔔 Pulso en la cabecera.
• Mientras suena la reproducción, se escucha un click por cada tiempo.
• Acento en el primer tiempo de cada compás (1600 Hz, 0.25); el resto de tiempos, click normal (1000 Hz, 0.12).
• El acento se calcula usando el timeSig del primer compás de MI.
• Se silencia al pulsar ⏹ Parar, junto con las notas.

Limitación: el pulso usa un único timeSig (el del primer compás de MI). Si la pieza tiene cambios de compás (4/4 → 3/4), el acento se descuadra a partir del cambio.

7.7 Compartir por enlace

• Pulsa 🔗 Compartir en la cabecera para copiar un enlace con MI, MIII y los ajustes esenciales, incluidos tempo, pulso y bucle.
• Al abrirlo, el ejercicio se carga automáticamente. El destinatario puede verlo y pulsar ▶ Reproducir.
• Con https://, el enlace abre la app alojada en esa dirección. Con file://, solo funciona en el equipo que tiene el archivo y en la misma ruta.
• El contenido está comprimido, no cifrado: cualquiera que tenga el enlace puede ver la partitura. Para ejercicios demasiado largos, usa Exportar JSON.
• La carga se puede deshacer con Ctrl+Z.

8. Transformaciones musicales

Las transformaciones permiten explorar distintas posibilidades de un mismo material. No presuponen que una variante sea la definitiva: se pueden escuchar y comparar los resultados, combinarlos con otros materiales o seguir transformándolos.

8.1 Generador de series simétricas

Diálogo guiado por prompts: nota base, nº de intervalos, tamaño en semitonos, dirección (asc, desc, o 2,2), duración.

8.2 Retrogradación (R)

Invierte el orden temporal de las unidades de sonido.

8.3 Inversión (I)

• Eje: primera nota con altura del ámbito.
• Fórmula: nueva = eje − (original − eje).
• En modo Por compás, cada compás usa su propio eje.
• Las ligaduras se conservan si los dos extremos siguen teniendo la misma altura.

8.4 Transposición cromática (↑ / ↓ o + / -)

• Nota individual seleccionada: transpone esa nota ±1 semitono.
• Rango de compases seleccionado: transpone todas las notas del rango.
• Multiselección no contigua: si hay notas multiseleccionadas (verde), transpone solo esas notas. Ver §13bis.
• Fragmento seleccionado (Shift+clic, naranja): transpone solo el fragmento. Ver §8.8.
• Con cruzada activa y checkbox marcado: transpone también el rango del otro manual.
• Atajos: ↑ / ↓, + / -, Shift+↑ / Shift+↓ (±1 octava).

Prioridad de destinos al transponer con +/-: multiselección > fragmento > nota individual > rango de compases. El primer destino que esté activo es el que se transpone.

8.5 Selector de alcance

Global / Por compás.

8.6 Aplicar transformaciones a ambos manuales

• El checkbox Aplicar transformaciones a ambos manuales aparece cuando hay cruzada activa.
• Marcado por defecto: las transformaciones actúan sobre ambos manuales.

8.7 Cambio de duración con preservación de posición

Al cambiar la duración de una nota o silencio seleccionado (con 1/2/4/8/S), si el checkbox Preservar posición temporal del panel generativo está marcado:

• Si la nota se acorta, se inserta un silencio explícito justo después con la diferencia de beats.
• Si la nota se alarga, no se inserta nada.

Si el checkbox está desmarcado, el cambio de duración deja que el editor rellene el hueco al final del compás.

8.8 Transponer un fragmento (Shift+clic / naranja)

Cuando hay un fragmento seleccionado (Shift+clic en notas o silencios contiguos), las teclas + / - transpongan solo las notas de ese fragmento.

• El rango está delimitado por la primera y la última nota del fragmento.
• El resto del manual no se toca.
• El fragmento se resalta en naranja durante toda la operación.

9. Atajos de teclado

9.1 Selección y edición

9.2 Deshacer / Rehacer

Deshacer y Rehacer funcionan siempre, incluso con el foco dentro de un textarea.

9.3 Claqueta, grabación MIDI y manual

9.4 Portapapeles

9.5 Transformaciones

9.6 Duración y puntillo

9.7 Entrada por teclado

9.8 Paneles colapsables Nuevo

Ver §11bis para el detalle del sistema.

9.9 Sincronización textarea ⇄ pentagrama Nuevo

Ver §12bis para el detalle del sistema.

9.10 Interfaz Nuevo

9.11 Regla general sobre el foco

10. Flujos de trabajo típicos

Los siguientes ejemplos muestran maneras de trabajar con la aplicación, no recetas obligatorias ni procedimientos destinados necesariamente a obtener una obra terminada. Cuando el flujo lo permita, conviene escuchar y observar cada resultado, valorar qué ha cambiado y decidir si se conserva, se modifica o se utiliza como punto de partida para otro paso.

10.1 Crear una serie e invertirla

1. Generar Series Simétricas → responde los prompts.
2. Selecciona un rango de compases (clic + Shift+clic).
3. I (o botón Invertir).
4. ▶ Reproducir con el rango aún seleccionado.

10.2 Dictado MIDI

1. Conectar teclado MIDI.
2. Activar Medir duración real y Silencios automáticos.
3. Tocar en tiempo real; las notas se insertan cuantizadas.

10.3 Exportar a MuseScore

1. Pulsa 💾 MusicXML.
2. Abre el archivo .musicxml en MuseScore / Sibelius / Finale.

10.4 Copiar y pegar compases

1. Selecciona un rango de compases en el manual de origen.
2. Pulsa 📋 Copiar compases.
3. Selecciona el compás o rango de destino.
4. Pulsa 📋 Pegar compases.

10.5 Copiar un motivo y repetirlo dentro de un compás

1. Con Shift+clic, selecciona el motivo.
2. Pulsa 🎼 Copiar fragmento (o Ctrl+Shift+C).
3. Haz clic en el compás donde quieras pegar el motivo.
4. Elige modo: 🎼 Insertar o 🎼 Sustituir.

10.6 Trabajar con MI y MIII a la vez

1. Selecciona un rango en MI.
2. Pulsa Aplicar a ambos manuales.
3. Pulsa R o I o ↑ / ↓.

10.7 Reproducir, ver en pantalla completa y parar

1. Selecciona (o no) un rango de compases.
2. Pulsa ▶ Reproducir o Enter. La partitura entra en pantalla completa.
3. Si quieres marcar el pulso, activa 🔔 Pulso.
4. Detén con ⏹ Parar o Enter.

10.8 Ligaduras y transposición

1. Escribe 2 F4 / 4 D4 / 4 D4 ~ / 4 D4 / 2 rest.
2. Selecciona ambos compases.
3. Pulsa ↑.

10.9 Fusión MI (tonal) + MIII (rítmica)

1. Escribe una serie tonal en MI y una serie rítmica en MIII.
2. Panel generativo → Bloque 2 → Fusionar MI (tonal) + MIII (rítmica).
3. Elige parámetros y Destino.
4. Pulsa Aplicar generador.

10.10 Realinear dos voces por MCM

1. Ten contenido en MI y en MIII.
2. En Voz: duración y MCM, activa Repetir las dos voces hasta su MCM.
3. Pulsa Realinear ambas voces.

10.10.a Completar una serie hasta el MCM de un compás

1. En Voz: duración y MCM, elige MI o MIII en Manual.
2. En Compás, selecciona el compás de destino, por ejemplo 4/4.
3. Pulsa Completar ciclo en este manual (MCM). Solo se repite el manual elegido; el otro no cambia.

Ejemplo: 7 negras duran 7 tiempos. En 4/4, MCM(7, 4) = 28; la app repite la serie 4 veces y la escribe en 7 compases de 4/4.

10.11 Recorrer la matriz dodecafónica

1. Escribe una fila dodecafónica en MI (12 alturas distintas).
2. Panel generativo → Bloque 5 → Serie de = MI, Enviar a = MIII, Valor = 4.
3. Pulsa Generar matriz.
4. Haz clic en cualquier etiqueta P, R, I o RI. La forma se escribe en MIII.

10.12 Revisar y revertir pasos del proceso generativo

1. Aplica varios pasos en el panel generativo.
2. Consulta el Bloque 4 — Historial y comparación.
3. Si quieres volver a un punto anterior, pulsa ↶ Volver.
4. El paso y los posteriores se descartan.

10.13 Introducir notas con el piano o los botones

1. Selecciona el manual activo: MI o MIII.
2. Elige la duración (1/2/4/8/S) y, si quieres, el puntillo.
3. Si necesitas otra octava, pulsa 8va ↓ o 8va ↑ (ver §15bis).
4. Haz clic en una tecla del piano o en un botón de las tres filas.
5. La nota se reproduce y se inserta en el manual activo con la duración elegida.

10.14 Sincronizar texto y pentagrama Nuevo

1. Haz clic en una nota del pentagrama.
2. La línea correspondiente del textarea se resalta con un fondo azul claro (overlay).
3. Alternativamente, selecciona con el ratón varias líneas del textarea; las notas correspondientes se resaltan en violeta en el pentagrama.

10.15 Transponer varias notas sueltas a la vez Nuevo

1. Haz clic en una nota para seleccionarla (azul).
2. Haz Ctrl+Shift+clic en otras notas sueltas para añadirlas a la multiselección (verde).
3. Pulsa + o - para transponer todas las notas multiseleccionadas ±1 semitono.
4. Pulsa Shift++ o Shift+- para ±1 octava.
5. Pulsa Esc para limpiar la multiselección.

10.16 Navegar por los paneles con el teclado Nuevo

1. Pulsa Alt+↓ repetidamente para recorrer los paneles del sidebar en orden.
2. Cada pulsación abre un panel y cierra los demás (modo acordeón).
3. El panel activo se marca con un borde naranja y hace scroll hasta quedar visible.
4. Pulsa Alt+Enter para abrir o cerrar el panel enfocado sin cerrar los demás.
5. Pulsa Alt+Shift+Q para alternar: cierra todos si hay alguno abierto; los abre todos si están todos cerrados.

10.17 Filtrar posiciones del material Nuevo

1. Genera o escribe material en un manual (por ejemplo con el Iniciador).
2. Panel generativo → Bloque 2 → Tipo: Filtrar posiciones.
3. Fuente: Iniciador (o el manual que corresponda). Destino: MI o MIII.
4. Elige Patrón (Impar, Par, Cada N, Lista personalizada) y conserva o no los silencios.
5. Pulsa Aplicar generador.

Ver §29bis para el detalle completo.

10.18 Airear una serie con silencios Nuevo

1. Ten material en un manual.
2. Panel generativo → Bloque 2 → Tipo: Espaciar eventos.
3. Elige Fuente, Destino, número de Slots y posición del silencio (Antes o Después).
4. Pulsa Aplicar generador.

Ver §29ter para el detalle completo.

10.19 Combinar filtro y espaciado Nuevo

1. Iniciador: por ejemplo, Serie dodecafónica.
2. Generador 1: Filtrar posiciones con Patrón Cada N=3. Destino MIII.
3. Generador 2: Espaciar eventos con Fuente Generador anterior, Slots 2, Posición Después. Destino MIII.

Resultado: subconjunto de la serie con silencios intercalados.

10.20 Ejemplos guiados: MCM, alternancia, fusión e inversión Nuevo

En la app, pulsa 📚 Ejemplos para cargar el punto de partida o el resultado de cada ejercicio. Cada carga se puede deshacer. Usa el resultado como referencia y reconstruye el proceso con los pasos siguientes.

Ejemplo A — 7 negras en 4/4

Una serie de siete negras dura siete tiempos; una barra de 4/4, cuatro. Buscamos el primer instante en que coinciden el comienzo de la serie y el primer tiempo del compás: MCM(7, 4) = 28. Por tanto, la serie se repite cuatro veces y ocupa siete compases. Los comienzos sucesivos caen en los pulsos 1, 4, 3, 2 y 1.

1. En 📚 Ejemplos, carga el punto de partida de «MCM: 7 negras en 4/4».
2. En modo avanzado, abre Voz (valor y bucle), elige MI y el compás 4/4.
3. Pulsa Completar ciclo en este manual (MCM).
4. Compara el pentagrama con Cargar resultado y reproduce ambos.

Ejemplo B — alternancia regular entre MI y MIII: eco u O/R

Las dos opciones parten de la sucesión de doce alturas del ejemplo adjunto «alternancia regular». La sucesión original es:

4 C4
4 C#4
4 A4
4 G#4
4 F#4
4 B4
4 D4
4 E4
4 F4
4 G4
4 D#4
4 A#4

1. En 📚 Ejemplos, carga el punto de partida de «Alternancia entre MI y MIII: dos opciones».
2. En modo avanzado, aplica el Iniciador Serie dodecafónica (fila dada) con las doce notas anteriores, valor Negra (4) y manual MI. Así O queda guardada como fuente del proceso.

Opción A — Eco O/O. En Generador, aplica Espaciar eventos con Fuente Iniciador, Slots 2, Posición Después y Destino MI. Vuelve a aplicar Espaciar eventos con la misma fuente y Slots, pero Posición Antes y Destino MIII. MI toca en los pulsos impares y MIII responde en los pares con la misma sucesión.

Opción B — O/R. Aplica primero Retrogradar (R) desde Fuente Iniciador a Destino MIII. Después aplica Espaciar eventos a Texto actual de MIII, con Slots 2 y Posición Después. Por último, aplica Espaciar eventos desde Iniciador a MI, con Slots 2 y Posición Antes. MIII presenta R en los pulsos impares y MI responde con O en los pares.

La tarjeta permite cargar el resultado de cada opción. En ambos casos, cada manual ocupa 24 pulsos (seis compases de 4/4). La app no tiene un botón único de alternancia: las dos versiones se construyen combinando los generadores disponibles.

Ejemplo C — MCM de dos ciclos: 12 fusas y 7 semicorcheas

Ahora se busca que dos voces que empiezan juntas terminen juntas. Tomamos la fusa como unidad común: MI contiene 12 fusas; MIII contiene 7 semicorcheas, equivalentes a 14 fusas. Por tanto, MCM(12, 14) = 84 fusas. MI repite su serie 7 veces y MIII, 6. Ambas duran 10,5 tiempos de negra.

1. En 📚 Ejemplos, carga el punto de partida de «MCM de dos ciclos: 12 fusas y 7 semicorcheas».
2. Comprueba que MI contiene 12 eventos con duración 32 y MIII, 7 eventos con duración 16.
3. En modo avanzado, abre Proceso generativo → Voz: duración y MCM y deja marcada Repetir las dos voces hasta su MCM. La casilla solo afecta al botón de realineación.
4. Pulsa Realinear ambas voces. El registro debe indicar MI ×7, MIII ×6 y un ciclo total de 10,5 tiempos.
5. Compara con Cargar resultado y pulsa ▶ Reproducir. Los ataques iniciales coinciden y las dos series acaban tras la misma duración.

La app representa esa duración como un compás de 84/32: 84 fusas equivalen a 10,5 negras. Es una métrica larga y poco habitual. En este ejercicio, el MCM alinea los finales de las voces; no hace que el final caiga en una barra convencional de 4/4.

Ejemplo D — fusionar melodía y ritmo

MI aporta una melodía de ocho alturas; MIII aporta un patrón rítmico de cuatro eventos. La fusión conserva las alturas de MI y toma de MIII las duraciones y la alternancia entre notas y silencios. Como el modo es cíclico, el patrón rítmico se repite dos veces.

1. En 📚 Ejemplos, carga el punto de partida de «Fusión: melodía de MI con ritmo de MIII».
2. En modo avanzado, abre Proceso generativo → Generador y elige Fusionar MI (tonal) + MIII (rítmica).
3. Configura Fuente: Texto actual de MI, Dirección rítmica: Directa, Modo de longitud: Cíclico y Destino: MI.
4. Elige Omitir silencios: No (usar también silencios), pulsa Aplicar generador y compara con Cargar resultado (NO: conservar silencios). D4 y F4 quedan en silencio.
5. Cambia a Omitir silencios: Sí (ignorar silencios), vuelve a aplicar y compara con Cargar resultado (SÍ: omitir silencios). Ahora suenan las ocho alturas; las duraciones 8 y 2 se alternan porque los silencios se eliminan antes de asignar el ritmo.

El primer ciclo con NO produce 8 C4, 8 rest, 2 E4, 4 rest; el segundo vuelve a empezar con G4. Con SÍ, el resultado es 8 C4, 2 D4, 8 E4, 2 F4, 8 G4, 2 A4, 8 B4, 2 C5. Las alturas C3 y G3 escritas en MIII solo marcan que esos eventos son notas: la fusión usa sus duraciones, y la altura de salida procede de MI. El generador mantiene MIII intacto y escribe el resultado en el manual de Destino. Los botones de referencia cargan estados de partitura; para reconstruir cada resultado hay que escoger el valor correspondiente de Omitir silencios y aplicar el generador.

Ejemplo E — Inversión: qué fija el eje

La inversión cambia el signo de cada intervalo: lo que sube, baja. Para un motivo dado, el contorno invertido es siempre el mismo. Lo que el eje decide es dónde se coloca ese contorno: qué nota del original se queda fija y en qué registro aparece el resultado.

Partimos del motivo D4–F4–A4–C5 (cuatro negras, intervalos +3, +4, +3). Las tres inversiones comparten los intervalos −3, −4, −3 y, por tanto, descienden.

• Eje = primera nota (D4): D4 B3 G3 E3. D4 queda fija al principio; es la nota más aguda del resultado.
• Eje = punto medio (G4): C5 A4 F4 D4. El eje es la media entre D4 (62) y C5 (72), que cae en G4 (67). Ninguna nota queda fija, pero los pares se reflejan alrededor de G4.
• Eje = última nota (C5): A#5 G5 D#5 C5. C5 queda fija al final; es la nota más grave del resultado.

Los tres resultados son la misma figura descendente en tres registros, no tres contornos distintos. El ejercicio sirve para ver cómo el eje determina la ubicación de la inversión y qué punto queda anclado, mientras la sucesión de intervalos invertidos se conserva.

El generador escribe A#5 y D#5 en lugar de sus equivalentes enarmónicos Bb5 y Eb5: como el motivo original no contiene bemoles, la app usa la enarmonía con sostenidos por defecto.

1. En 📚 Ejemplos, carga el punto de partida de «Inversión: qué fija el eje»: MI contiene D4 F4 A4 C5; MIII está vacío.
2. En modo avanzado, abre Proceso generativo → Generador.
3. Elige Tipo: Invertir (I). Fuente: Texto actual de MI. Destino: MIII.
4. En Eje, elige Primera nota. Pulsa Aplicar generador. Observa que D4 no se mueve.
5. Pulsa ↶ Deshacer. Cambia Eje a Punto medio. Pulsa Aplicar generador. Observa que D4 y C5 intercambian sus posiciones.
6. Pulsa ↶ Deshacer. Cambia Eje a Última nota. Pulsa Aplicar generador. Observa que ahora C5 es la que no se mueve.
7. Reproduce MI y MIII: el original sube (+3, +4, +3); el invertido baja (−3, −4, −3). Compara las tres versiones sucesivamente, cargando cada una con su botón.

En los tres casos se conservan duración, número de notas y contorno interválico. Cambian el registro y qué nota del original permanece anclada.

11bis. Paneles colapsables y su atajo único Nuevo

Todos los bloques del panel lateral (sidebar) son colapsables: se pueden plegar y desplegar individualmente con un clic en su cabecera. Además, un único par de teclas permite recorrerlos como un acordeón, abriendo el que interese y cerrando los demás.

11bis.1 Paneles colapsables

Los paneles que se pueden plegar son:

1. 📖 Sintaxis y Atajos Completos.
2. ⚙️ Configuración de Claves y Sistemas.
3. ⏱️ Claqueta MIDI y Cuenta Atrás.
4. ⚙️ Opciones avanzadas de MIDI (dentro de Entrada rápida).
5. 🎼 Iniciador (bloque 1 del panel generativo).
6. 🎼 Generador (bloque 2).
7. 🎼 Voz (bloque 3).
8. 🎼 Historial y comparación (bloque 4).
9. 🎼 Matriz dodecafónica (bloque 5).
10. ⚡ Asistente de Patrones y Transformaciones.
11. 📋 Registro de actividad.

Por defecto, se muestran abiertos el bloque verde (Configuración) y el bloque 1 (Iniciador). Los demás están plegados.

11bis.2 Indicador visual

Cada cabecera tiene una flechita ▸ a la derecha. Al abrir el panel, la flecha gira 90° y queda apuntando hacia abajo (▾).

11bis.3 Persistencia

El estado (abierto/cerrado) de cada panel se guarda en localStorage. Al recargar la página, cada panel recupera el estado que tenía la última vez.

Esto significa que:

• Si el usuario cierra un panel, sigue cerrado tras recargar.
• Si abre un panel que por defecto estaba cerrado, sigue abierto tras recargar.
• El comportamiento es independiente para cada panel.

11bis.4 Atajo único acordeón Nuevo

En lugar de 11 atajos individuales, se ha implementado un único par de teclas que recorre los paneles en el orden en que aparecen en el sidebar:

Comportamiento

• La primera pulsación de Alt+↓ abre el primer panel del sidebar (la ayuda de atajos). La primera de Alt+↑ abre el último (el Registro de actividad).
• Las siguientes pulsaciones avanzan o retroceden una posición por el ciclo.
• El ciclo es circular: después del último vuelve al primero y viceversa.
• Al abrir un panel, se cierran los demás — es un acordeón estricto.
• El panel enfocado se marca con un borde naranja y se hace scroll hasta quedar visible en el sidebar.
• La acción se anota en el Registro de actividad con el nombre del panel.

Si el usuario abre un panel con el ratón, el índice del acordeón se resincroniza: la próxima pulsación de Alt+↓ continúa desde el panel que él abrió, no desde donde se quedó el teclado.

11bis.5 Ejemplo de uso

1. El usuario está trabajando y quiere consultar los atajos.
2. Pulsa Alt+↓: se abre la ayuda "📖 Sintaxis y Atajos".
3. La lee.
4. Pulsa Alt+↓ cinco veces más: pasa por Configuración, Claqueta, Opciones MIDI, Iniciador y Generador (cada uno se abre y cierra el anterior).
5. Pulsa Alt+↑: vuelve a Iniciador.
6. Pulsa Alt+Enter: ahora Iniciador y Generador quedan abiertos a la vez.
7. Pulsa Alt+Shift+Q: como en ese momento hay paneles abiertos, se cierran todos. Si lo vuelves a pulsar, se abren todos de nuevo.

11bis.6 Compatibilidad con el modo Iniciación

Si un panel está oculto (por ejemplo, porque el modo Iniciación oculta las herramientas avanzadas), el atajo sigue funcionando internamente: cambia el estado abierto/cerrado aunque el panel no esté visible en ese momento. Al volver al modo avanzado, el panel aparece con el estado que le hayamos dejado.

11bis.7 Diferencia entre "colapsable" y "condicional"

12bis. Sincronización textarea ⇄ pentagrama Nuevo

El editor tiene una sincronización bidireccional entre lo que se ve en el pentagrama y lo que se ve en los cuadros de texto "Notas para MI" y "Notas para MIII". Sirve para orientarse rápidamente: no hace falta contar líneas a mano para saber qué nota corresponde a qué línea del texto.

12bis.1 Pentagrama → textarea

Al seleccionar algo en el pentagrama, la parte del texto que corresponde a lo seleccionado se marca visualmente:

Overlay visual

Cuando el pentagrama tiene el foco (no la textarea), el navegador no suele dibujar la selección nativa del textarea. Para que se vea igualmente, el editor dibuja un overlay: un rectángulo azul translúcido, con un borde azul sólido a la izquierda, que se superpone sobre las líneas afectadas del textarea.

El overlay es puramente visual: no interfiere con el teclado ni con el ratón. Desaparece cuando la textarea recibe el foco (porque entonces ya se ve la selección nativa).

Detalle técnico

El overlay usa el line-height real del textarea para calcular en qué píxel empieza cada línea. Como el CSS del textarea declara un line-height explícito (1.4), el cálculo es exacto: no hay desfase aunque haya 30 líneas.

12bis.2 Textarea → pentagrama

Al seleccionar texto con el ratón en la textarea, las notas correspondientes del pentagrama se resaltan en violeta (color #a855f7).

• Se marca una sola línea si solo está seleccionada una línea.
• Se marcan varias líneas si el rango abarca varias.
• Las notas resaltadas no se confunden con la selección azul (clic normal) ni con el fragmento naranja (Shift+clic) ni con la multiselección verde (Ctrl+Shift+clic).

Cuándo se actualiza

• Al soltar el botón del ratón (mouseup).
• Al mover el cursor con el teclado dentro de la textarea (keyup).
• Al recibir el foco la textarea.
• Al desplazar el contenido de la textarea (scroll), por si la selección queda fuera de la vista.

12bis.3 Interacción con las demás selecciones

Los tres modos de selección del editor (clic simple azul, fragmento naranja, multiselección verde) conviven con la sincronización:

• Clic simple: selecciona la nota (azul) y sincroniza su línea con el textarea.
• Shift+clic (fragmento): selecciona el fragmento (naranja) y sincroniza el rango de líneas con el textarea.
• Ctrl+Shift+clic (multiselección): acumula notas (verde) y sincroniza el rango envolvente con el textarea.

Al deseleccionar (Esc o clic en zona vacía), la sincronización también se limpia.

12bis.4 Ventajas prácticas

• Localizar rápidamente en el texto la nota que se acaba de oír.
• Localizar en la partitura la línea de texto sobre la que se está trabajando.
• Revisar un fragmento largo sin contar líneas a mano.
• Detectar líneas vacías o time intercaladas entre las notas.

12bis.5 Limitaciones

• La sincronización es lineal por índice de línea: si el texto tiene la misma nota repetida en varias líneas, todas ellas se comportan igual.
• Las líneas vacías y las líneas de time x/y no generan nota en el pentagrama, así que seleccionarlas en el textarea no resalta nada en el SVG.
• En la multiselección no contigua, el rango que se marca en el textarea es el envolvente (de la primera a la última nota multiseleccionada), no las notas exactas.

13bis. Multiselección no contigua Nuevo

Además de las selecciones ya existentes (nota individual azul, fragmento naranja, rango de compases azul), la app permite marcar varias notas sueltas a la vez, sin que formen una secuencia contigua. Se pintan en verde (color #16a34a).

13bis.1 Cómo se crea

• Se hace un clic normal en la primera nota (se vuelve azul).
• Se hace Ctrl+Shift+clic en cada nota adicional para añadirla a la multiselección.
• Si se repite Ctrl+Shift+clic en una nota ya multiseleccionada, se quita de la selección.

Al hacer el primer Ctrl+Shift+clic, la nota que ya estaba seleccionada en azul se añade automáticamente a la multiselección. Así no hay que hacer un gesto especial para arrancar.

13bis.2 Comportamiento

• Las notas multiseleccionadas se resaltan en verde.
• El registro de actividad muestra cuántas notas hay en la multiselección: Multiselección en MI: 3 nota(s) [líneas 5, 9, 12].
• Al pulsar Esc se limpia la multiselección.
• La multiselección es por manual: si se cambia a notas del otro manual, la anterior se limpia.

13bis.3 Transponer la multiselección

Una vez que hay una o varias notas multiseleccionadas, se pueden transponer todas a la vez con:

En algunos teclados, escribir + requiere mantener Shift; en ese caso la app lo interpreta como una transposición de octava. Para subir un semitono, pulsa = sin Shift (o usa + del teclado numérico).

13bis.4 Prioridad de destinos al transponer

Cuando se pulsa + o -, el editor decide a qué aplicarlo según esta prioridad:

1. Multiselección no contigua (verde): si hay al menos una nota multiseleccionada.
2. Fragmento (naranja): si hay un fragmento definido con Shift+clic.
3. Nota individual (azul): si hay una sola nota seleccionada.
4. Rango de compases (azul con borde): si hay uno o varios compases seleccionados.

13bis.5 Ejemplo

1. En el compás 1, hay 4 C4 D4 E4 F4.
2. El usuario hace clic en C4 → se vuelve azul.
3. Hace Ctrl+Shift+clic en D4 → ambos se vuelven verdes.
4. Hace Ctrl+Shift+clic en F4 → los tres se vuelven verdes; E4 queda sin marcar.
5. Pulsa + una vez → resultado: 4 C#4 D#4 E4 F#4.
6. Pulsa Esc para limpiar la multiselección.

13bis.6 Limitaciones

• La multiselección no se puede duplicar ni mover como bloque: solo se transpone y se copia (a través del portapapeles de fragmentos si las notas están en el mismo rango continuo).
• En el textarea no se puede seleccionar un conjunto no contiguo: siempre se marca el rango envolvente. La multiselección verde no tiene equivalente exacto en la textarea.
• Al aplicar un cambio de duración con 1/2/4/8/S, la multiselección no se tiene en cuenta: solo se cambia la duración de la última nota seleccionada (azul) o del fragmento (naranja).

14bis. Modo Iniciación Nuevo

El editor incluye un Modo Iniciación: una interfaz simplificada para niños o para primeros contactos con la aplicación. Se activa y desactiva con el botón 🔰 Iniciación de la cabecera, o con el atajo Alt+M.

14bis.1 Qué hace

• Oculta las herramientas avanzadas del sidebar: opciones MIDI, Cruzada, Copiar/pegar avanzado, Inspector, Panel generativo completo, Asistente de Patrones, ayudas técnicas, etc.
• Muestra solo lo esencial: el teclado (piano + botones), las dos textareas, los botones "Generar Partituras" y "Limpiar", y un aviso explicativo.
• Amplía las textareas (fuente 15 px) y las reduce en altura (90 px) para que quepan mejor en pantallas pequeñas.
• Cambia el texto del botón de modo: cuando está activo, el botón dice ⚙️ Avanzado, para poder volver.

14bis.2 Aviso de iniciación

En lugar de la ayuda técnica, aparece un mensaje amable:

🎵 Escribe notas y pulsa ▶ Reproducir
Ejemplo (una nota por línea, cuatro negras):
4 C4 · 4 D4 · 4 E4 · 4 F4
Si escribes las cuatro notas en una sola línea, sonarán a la vez (un acorde), no una tras otra.
También puedes pulsar las teclas del piano o los botones de colores.

14bis.3 Atajo Alt+M Nuevo

Se puede alternar entre Modo Iniciación y Modo Avanzado sin usar el ratón:

El atajo se ignora cuando el foco está en un <textarea> o <input>, para no interferir con la escritura.

Al cambiar de modo con el atajo, la acción se anota en el Registro de actividad con el modo al que se ha cambiado.

14bis.4 Persistencia

El modo elegido se guarda en localStorage. Al recargar la página, la app arranca en el último modo usado.

• Si nunca se ha usado el editor, arranca por defecto en Modo Iniciación (útil para niños que abren la app por primera vez).
• Si el usuario ha pulsado "⚙️ Avanzado", la próxima vez que abra el editor arranca en modo avanzado.
• Lo mismo al revés.

14bis.5 Qué sigue funcionando en modo Iniciación

• Todos los atajos de selección y edición básicos (clic, Shift+clic, flechas).
• La reproducción (▶ Reproducir y Enter).
• Los atajos de paneles colapsables (aunque la mayoría de los paneles estén ocultos).
• La introducción de notas desde el piano y desde los botones.
• El borrado y deshacer con Ctrl+Z.
• El atajo Alt+M para volver al modo avanzado.

14bis.6 Qué se oculta

• Configuración de claves y sistemas.
• Claqueta MIDI y cuenta atrás.
• Inspector de selección.
• Opciones avanzadas de MIDI.
• Panel generativo completo.
• Asistente de patrones.
• Registro de actividad.
• Ayuda técnica de atajos.

Se puede salir en cualquier momento pulsando ⚙️ Avanzado o Alt+M.

15bis. Octava del teclado Nuevo

La entrada del piano y de los botones se puede desplazar una octava arriba o abajo con dos botones situados en la fila de opciones de "Entrada rápida".

15bis.1 Los botones

Entre ambos hay una etiqueta de estado que muestra el desplazamiento actual:

• −1 → una octava por debajo del rango por defecto.
• 0 → rango por defecto (E2–E5).
• +1 → una octava por encima del rango por defecto.

15bis.2 Estados posibles

Solo hay tres estados de desplazamiento:

Si se intenta ir más allá de los límites, aparece en el Registro de actividad un mensaje:

Límite inferior (E1–E4).
Límite superior (E3–E6).

15bis.3 Qué cambia al desplazar

El desplazamiento afecta a toda la entrada visual:

• Las teclas del piano: cada tecla pasa a representar la nota de la octava desplazada.
• Los botones de las tres filas: sus etiquetas (F2, Ab2, B2, …) se recalculan al vuelo.
• El preview sonoro de cada tecla y botón: al pulsar suena la nota de la octava actual.
• La inserción en el textarea: la nota escrita es la del rango desplazado.

El resto del editor (pentagrama, reproducción de la partitura, atajos de transposición, etc.) no se ve afectado: el desplazamiento es solo una ayuda para introducir notas fuera del rango por defecto.

15bis.4 Ejemplo

1. El usuario abre el editor. La etiqueta muestra 0 y el piano cubre E2–E5.
2. Pulsa 8va ↓. La etiqueta pasa a −1 y el piano cubre E1–E4.
3. Pulsa una tecla. Se inserta un Mi1 (antes era Mi2).
4. Pulsa 8va ↑ dos veces: la etiqueta vuelve a 0 y luego pasa a +1. El piano cubre E3–E6.
5. Pulsa una tecla. Se inserta un Mi5.

En el Registro de actividad aparecen mensajes del tipo:

🎹 Entrada −1 octava(s). Rango: E1 – E4.
🎹 Entrada +0 octava(s). Rango: E2 – E5.
🎹 Entrada +1 octava(s). Rango: E3 – E6.

15bis.5 Interacción con el manual activo

El desplazamiento de octava es independiente del manual activo. Si el usuario está escribiendo en MI y luego pasa a MIII, la octava seleccionada se mantiene. No hay dos desplazamientos separados: uno solo, global a los dos manuales.

15bis.6 Interacción con MIDI

La entrada MIDI no se ve afectada por este desplazamiento. Cuando el usuario toca en un teclado MIDI externo, se registra la nota real que llega por el puerto MIDI, sin transponerla. El desplazamiento solo afecta a la entrada visual (piano y botones en pantalla).

15bis.7 Limitaciones

• Solo hay tres estados: no se puede desplazar más de una octava arriba o abajo.
• El desplazamiento no se persiste entre sesiones: al recargar la página, vuelve a 0.
• No hay atajo de teclado para los botones: solo se pueden pulsar con el ratón.
• Al cambiar de octava, el piano se regenera por completo: puede haber un pequeño parpadeo.

PARTE II — NORMAS DE ESCRITURA

Esta parte describe las reglas que sigue la app para escribir música.

16. Decisiones de diseño

D1. Sin armadura de clave

La app no maneja armaduras. Todas las alteraciones se escriben explícitamente cuando son necesarias.

D2. Ligaduras entre compases

Las ligaduras entre compases sí están soportadas. Una nota ligada es una sola unidad de sonido.

D3. Sin dobles alteraciones

La app no escribe 𝄪 ni 𝄫. Si una transposición produce una doble alteración, se escribe con la enarmonía simple más cercana.

D4. Alteración explícita siempre que se necesite

El editor escribe siempre la alteración explícita (# o b) cuando el sonido efectivo de la nota no es natural.

D5. Sin modo pedagógico (accidentales de cortesía)

No hay accidentales de cortesía.

D6. Los tokens no tocados conservan su sonido

Al transponer o modificar una nota, las demás notas del compás conservan su sonido previo.

D7. Silencios automáticos como contenido

La app puede generar silencios automáticos al completar compases incompletos. Esos silencios cuentan como contenido musical real.

D8. Unidades de sonido

Una nota ligada es una sola unidad de sonido: un solo ataque, duración total.

D9. Partición de eventos que no caben

Cuando un evento no cabe entero en el compás actual, la app lo parte automáticamente.

D10. Preservación de posición temporal

Al cambiar la duración de notas o silencios (con el checkbox Preservar posición temporal activo), la app inserta silencios explícitos para que las notas siguientes no se desplacen.

D11. Indiferencia al tipo de manual derecho

MI puede ser un manual de teclas o de botones. La notación textual, el render y la reproducción son idénticos en ambos casos: la diferencia está solo en cómo se toca el instrumento, no en cómo se escribe.

D12. Sincronización por índice de línea Nuevo

La correspondencia entre el textarea y el pentagrama se hace por número de línea: la línea n del texto corresponde al lineIndex n del evento en el parseador. Esto permite que la sincronización sea exacta y barata, sin heurísticas.

D13. Desplazamiento de octava como ayuda de entrada Nuevo

El desplazamiento de octava del piano y de los botones es una ayuda de entrada visual, no un cambio en el modelo musical. No altera la partitura, ni el audio de reproducción, ni la entrada MIDI. Solo cambia la octava que se escribe al pulsar una tecla o botón en pantalla.

D14. Generadores como transformadores puros Nuevo

Los generadores de transformación (Retrogradar, Invertir, Transponer, Filtrar posiciones, Espaciar eventos, Fusionar MI+MIII) no modifican el material de entrada. Solo escriben el resultado en el manual de Destino. La fuente (Iniciador, texto de MI, texto de MIII o generador anterior) permanece intacta.

17. Normas vigentes

N1. Formato de nota

letra + alteración opcional + octava

• Letra: a–g (mayúscula o minúscula).
• Alteración: # (sostenido), b (bemol), n (becuadro) o vacío.
• Octava: número entero.

N2. Herencia por letra y octava

Dentro de un compás, una alteración explícita afecta a las notas siguientes de la misma letra y octava.

N3. Reinicio por compás

La alteración vigente se reinicia al empezar cada compás.

N4. Escritura tipográfica

1. Se consulta la alteración vigente.
2. Si el sonido es # o b, siempre se escribe el signo.
3. Si el sonido es natural, se escribe n solo si la vigente era # o b.

N5. Reducción

Los signos redundantes se eliminan al Generar Partituras.

N6. Transposición

Se transpone desde el sonido efectivo previo. Las demás notas conservan su sonido (D6).

N7. Modificación puntual (Inspector)

Las notas modificadas cambian; las demás conservan su sonido previo.

N8. Normalización ("Generar Partituras")

Reescribe cada compás con la norma tipográfica usando los sonidos efectivos actuales. No cambia sonidos.

N9. Render

El pentagrama dibuja el sonido efectivo de cada nota, pero el signo gráfico solo se escribe cuando cambia respecto a la vigente.

N10. Audio

El audio reproduce el sonido efectivo de cada nota.

N11. Unidades de sonido

Una nota ligada es una sola unidad de sonido. Las transformaciones tratan cada unidad como un bloque indivisible.

N12. Consolidación de bloques

Un bloque ligado que ocupe varios items se consolida en su forma canónica si cabe entero en un compás.

N13. Padding

El silencio de "padding" cuenta como un silencio más del fragmento. Los silencios consecutivos se fusionan en una sola unidad.

N14. Retrogradación

Invierte el orden temporal de las unidades de sonido.

N15. Inversión

Refleja cada unidad de sonido alrededor de un eje.

N16. Partición automática

Cuando un evento no cabe entero en el compás, la app lo parte (ver D9).

N17. Cálculo de la duración al aplicar valor

Al aplicar un valor (1/2/4/8/16) a un manual desde el bloque Voz, la nueva duración se calcula indexando durMap con el valor tal como se escribe ("1", "2", "4"…), no con el código interno ("w", "h", "q"…).

N18. Filtrar posiciones Nuevo

El generador transform.filterPositions conserva el evento n-ésimo del material de entrada según el patrón elegido (Impar, Par, Cada N, Lista personalizada). Si Conservar silencios está desactivado, los silencios que caigan en posición válida también se descartan.

N19. Espaciar eventos Nuevo

El generador transform.spaceEvents expande cada evento del material de entrada en N "slots" del mismo valor que el evento. Los slots que no ocupa el evento se rellenan con silencios de la misma duración. La posición del silencio (Antes / Después) determina si el silencio va antes o después del evento.

18. Relación con la notación musical estándar

Lo que sigue la norma universal

• Formato de nota.
• Herencia por letra y octava dentro del compás.
• Reinicio por compás.
• Becuadro establece natural hasta el final del compás.
• Reducción de signos redundantes.
• Transposición desde el sonido efectivo.
• Ligaduras entre compases como una sola nota lógica.

Lo que es decisión de esta app

• D1 (sin armadura): la notación estándar sí contempla armaduras.
• D3 (sin dobles alteraciones): sustituidas por enarmonías simples.
• D4 (alteración explícita siempre): la notación estándar prefiere la forma compacta.
• D5 (sin accidentales de cortesía): no permitidos en esta app.
• D11 (indiferencia al tipo de manual derecho): el editor no distingue entre teclas y botones en la notación.
• D12 (sincronización por índice de línea): decisión de implementación, invisible al usuario pero que explica el comportamiento exacto de §12bis.
• D13 (desplazamiento de octava como ayuda visual): no afecta a la notación ni al audio.
• D14 (generadores como transformadores puros): los generadores de transformación nunca modifican la fuente.

Tabla comparativa

19. Pendientes

Estos temas no están implementados en la app.

P1. Armadura de clave Pendiente

No soportada.

P2. Dobles alteraciones Pendiente

No soportadas (𝄪, 𝄫).

P3. Selección individual de notas en acordes Parcial

Con Ctrl+clic se puede alternar la selección de notas individuales, pero el render y algunas transformaciones aún tratan el acorde entero como bloque.

P4. Modo pedagógico Pendiente

No soportado.

P5. Tresillos y otras divisiones Pendiente

La cuantización MIDI redondea a la figura más cercana; no soporta tresillos.

P6. Semilla RNG visible al usuario Pendiente

Los generadores usan una semilla fija (12345), salvo "Barajar fila" y "Fila nueva". La semilla no es visible ni editable.

P7. Pulso con cambios de compás Pendiente

El pulso de reproducción usa un único timeSig (el del primer compás de MI). No respeta cambios de compás dentro de la pieza.

P8. Multiselección con cambio de duración Pendiente

La multiselección no contigua (verde) solo se puede transponer con +/-. No se puede cambiar la duración de las notas multiseleccionadas a la vez.

P9. Sincronización multiselección exacta en la textarea Pendiente

El textarea solo admite selecciones contiguas, así que la multiselección no contigua se marca como rango envolvente en el texto. No hay forma de marcar solo las líneas exactas sin que las intermedias queden también marcadas.

P10. Reordenar o mover bloques de la interfaz Pendiente

Los paneles colapsables están en un orden fijo. No se pueden arrastrar para reordenar.

P11. Atajo de teclado para la octava Pendiente

Los botones 8va ↓ / 8va ↑ solo funcionan con el ratón. No hay atajo de teclado asociado.

P12. Persistencia del desplazamiento de octava Pendiente

El desplazamiento de octava vuelve a 0 al recargar la página. No se guarda en localStorage.

P13. Filtrar posiciones con rango personalizado Pendiente

El generador "Filtrar posiciones" no admite rangos del tipo "2-5" en la lista personalizada. Solo acepta posiciones individuales separadas por comas.

P14. Espaciar eventos con silencios de duración independiente Pendiente

Los silencios que genera "Espaciar eventos" siempre tienen la misma duración que el evento original. No se puede elegir otra duración para el silencio.

P15. Otros pendientes

Se añadirán a medida que surjan.

PARTE III — REFERENCIA TÉCNICA

20. Persistencia y exportación

20.1 JSON del proyecto

{
  "mi": "texto de MI",
  "miii": "texto de MIII"
}

• Exportación: descarga partitura_proyecto.json.
• Importación: reemplaza el contenido actual (con opción de deshacer).

20.2 JSON del proceso generativo

{
  "version": "2.0",
  "process": {
    "iniciador": { "generator": "source.row12", "params": {...}, "manual": "MI", "events": [...] },
    "generador": { "generator": "transform.filterPositions", "source": "iniciador", "params": {...}, "manual": "MIII", "events": [...] },
    "voces": {
      "MI":   { "value": 4, "loop": true },
      "MIII": { "value": 4, "loop": true }
    }
  },
  "texts": { "MI": "...", "MIII": "..." }
}

20.3 MusicXML

• Estándar score-partwise versión 3.1.
• Dos partes: P1 (MI) y P2 (MIII).
• divisions = 16 por negra.
• Acordes con etiqueta <chord/>.
• Alteraciones exportadas como <alter> + <accidental>.
• Silencios como <rest/>.
• Cambios de compás exportados como <time>.
• Ligaduras exportadas como <tie> + <tied>.
• Silencios de relleno (__padding) también se exportan para que cada compás sume la duración exacta de su compás.

20.4 Persistencia en localStorage Nuevo

La app guarda tres claves en localStorage:

El editor no guarda automáticamente el contenido de las textareas: para eso hay que pulsar 📤 Exportar JSON. Tampoco se persiste el desplazamiento de octava.

21. Arquitectura interna

21.1 Módulos principales

21.2 Estructura de un compás en memoria

[
  {
    type: "note" | "rest",
    duration: "4",
    keys: [{ key: "c/4", accidental: "" }, ...],
    rawLine: "4 C4 E4",
    lineIndex: 3,
    timeSig: "4/4",
    __stableId: "note-mi-7",
    __padding: false,
    tieNext: false,
    tiePrev: true,
    tieOriginIndex: 2
  },
  ...
]

21.3 Estructura del proceso generativo

{
  iniciador: { generator, params, manual, events },
  generador: { generator, source, params, manual, events },
  voces: {
    MI:   { value, loop, preservePosition },
    MIII: { value, loop, preservePosition }
  }
}

21.4 Estructura del historial generativo

history = [
  {
    label: "Iniciador «Serie dodecafónica» → MI",
    before: { mi: "...", miii: "..." },
    after:  { mi: "...", miii: "..." }
  },
  ...
]

21.5 Estructura de la matriz dodecafónica

M[i][j] = (p[j] + p[0] - p[i]) mod 12

donde p = [pc_0, pc_1, ..., pc_11]  son las 12 pitch classes de la fila,
      todas en el rango 0..11.

Fila 0     = P original (P0)
Columna 0  = I original (I0)
Diagonal   = p[i] (pitch class de la fila en posición i)

21.6 Las dos representaciones visuales de MI

La función initPianoAndAcordeon() construye ambas representaciones:

• Piano: rango E2–E5 por defecto. Calcula los anchos de teclas blancas y negras proporcionalmente al ancho del contenedor de botones, y las coloca en un <div id="piano"> generado dinámicamente. El rango se desplaza con window.__shiftNote.
• Botones: 3 filas cromáticas (filas 3, 4 y 5 del manual de botones) en HTML estático (#acordeon). Sus etiquetas también se recalculan con window.__shiftNote.
• Ambas insertan notas en el manual activo con la duración activa, usando addManualNote() que aplica midiNumberToNoteNameWithContext.

21.7 Sincronización textarea ⇄ pentagrama Nuevo

La sincronización se apoya en tres piezas:

• Mapeo por lineIndex: cada evento del parser guarda su número de línea del texto original. Los mapas svgNoteHeadElements[manual] usan lineIndex:tokenIdx como clave, así que la correspondencia texto → SVG es inmediata.
• Selección en la textarea: selectLinesInTextarea(manual, startLine, endLine) usa setSelectionRange para marcar el rango de caracteres correspondiente. No hace focus() para no robar el teclado al pentagrama.
• Overlay visual: como una textarea sin foco no siempre pinta la selección, se dibuja un <div class="sync-line-overlay"> posicionado sobre las líneas afectadas, calculado a partir del line-height, el padding y el scroll del textarea.

El color del resaltado en el pentagrama (cuando se selecciona texto en la textarea) es violeta (.nota-desde-textarea).

21.8 Paneles colapsables Nuevo

Los paneles se implementan con el elemento nativo <details>:

<details class="collapsible-panel" id="panelX" open>
  <summary>Título del panel</summary>
  <div class="collapsible-content">...</div>
</details>

• El estado abierto/cerrado lo gestiona el navegador.
• Un listener global de toggle guarda el estado en localStorage.
• La flechita ▸/▾ es CSS puro (::after en summary).

21.9 Atajo único acordeón Nuevo

Un módulo escucha keydown en fase de captura y gestiona Alt+↓, Alt+↑, Alt+Enter y Alt+Shift+Q. Mantiene un índice current que apunta al panel enfocado. Al abrir un panel:

1. Se cierran todos los demás (openOnly).
2. Se pinta el foco naranja (.kb-focused).
3. Se hace scroll hasta el panel con scrollIntoView.

Un listener de click sobre summary resincroniza el índice cuando el usuario abre un panel con el ratón. Alt+Shift+Q actúa como toggle: si hay algún panel abierto los cierra todos; si están todos cerrados los abre todos.

21.10 Modo Iniciación + Alt+M Nuevo

El modo se gestiona con la clase mode-iniciacion en el <body>:

• Los elementos con clase advanced-only se ocultan con display: none !important.
• Los elementos con clase initiation-only se muestran.
• Las textareas cambian de altura y tamaño de fuente por CSS.

Un listener global escucha Alt+M en fase de captura. Antes de actuar, comprueba que el foco no esté en <textarea> ni <input>, para no interferir con la escritura.

21.11 Octava de entrada Nuevo

Se gestiona con una variable global window.__inputOctaveOffset (valores: −1, 0, +1) y una función window.__shiftNote(noteName) que devuelve el nombre de nota desplazado en octavas. Al pulsar 8va ↓ o 8va ↑:

1. Se comprueba el límite (±1).
2. Se actualiza window.__inputOctaveOffset.
3. Se llama a applyOffset(), que:
   • Reescribe las etiquetas y los dataset.nota de los botones.
   • Regenera el piano llamando a initPianoAndAcordeon().
   • Actualiza la etiqueta #octaveOffsetLabel.
   • Escribe el rango actual en el Registro de actividad.

La entrada MIDI no consulta __shiftNote: las notas del puerto MIDI se insertan tal cual.

21.12 Filtrar posiciones Nuevo

El generador transform.filterPositions recorre el array de eventos de la fuente y construye un Set con las posiciones a conservar (1-based). Parámetros:

pattern: "odd" | "even" | "everyN" | "customList"
n: entero 2–12 (solo para everyN)
customList: array de enteros (solo para customList)
keepRests: "false" | "true"

• odd: posiciones 1, 3, 5, …
• even: posiciones 2, 4, 6, …
• everyN: posiciones 1, 1+N, 1+2N, …
• customList: posiciones de la lista, filtrando valores < 1.

Si keepRests = "false", los eventos de tipo rest se descartan aunque caigan en posición válida. El resultado se escribe en el manual Destino.

21.13 Espaciar eventos Nuevo

El generador transform.spaceEvents expande cada evento en N slots del mismo duration que el evento. Parámetros:

slots: entero 2–8 (forzado a mínimo 2 y máximo 8)
position: "after" | "before"

Para cada evento se emiten los silencios correspondientes (N-1) y el evento limpio:

• La función durCodeOf(ev) extrae el código de duración (1, 2, 4, 8, 16) saltando prefijos de tuplet y aceptando tanto códigos numéricos como nombres de figura.
• La función sinTilde(raw) elimina el sufijo ~ de la nota original para romper ligaduras colgantes.
• Se elimina tieOriginIndex de la nota limpia.
• Los silencios heredan la duración del evento original.

21.14 Gestión del foco en el teclado

handleMuseScoreKeyDown comprueba el elemento activo antes de interceptar teclas. Solo Ctrl+Z, Ctrl+Y, Ctrl+Shift+Z, Esc y Alt+M se interceptan de forma incondicional. Los atajos de paneles usan Alt combinado con otras teclas, que no interfiere con la escritura.

22. Índice rápido de funciones JS

23. Limitaciones conocidas

• Solo se manejan cambios de compás por línea; no hay armadura de tonalidad.
• Los silencios de relleno (__padding) son visibles y participan en las transformaciones, pero no son editables directamente desde el texto.
• El motor de audio usa osciladores senoidales puros.
• La cuantización MIDI redondea a la figura más cercana; no soporta tresillos.
• El máximo de pasos de deshacer es 100.
• El bucle es opcional: activa 🔁 Bucle antes de reproducir. Si está desactivado, la pieza o el rango suenan una sola vez.
• El portapapeles de compases y el de fragmentos son internos: se pierden al recargar.
• El fragmento se pega siempre en el manual del compás destino.
• La cruzada solo puede estar en el manual opuesto a la principal.
• No hay arrastrar y soltar de compases.
• Las dobles alteraciones no están soportadas.
• La armadura de clave no está soportada.
• La semilla RNG no es visible ni editable (salvo "Barajar fila" y "Fila nueva").
• Los generadores no encadenan múltiples generadores: solo un "generador anterior".
• La fusión MI+MIII se escribe siempre en un solo manual.
• El panel generativo no entra en el historial de deshacer como una sola operación compuesta.
• El historial del panel generativo vive en memoria: se pierde al recargar la página.
• El historial no se reescribe al hacer Ctrl+Z: son dos mecanismos independientes.
• La matriz dodecafónica exige exactamente 12 pitch classes distintas.
• La matriz envía las formas como notas sueltas en octava 4.
• La matriz sobreescribe el manual destino sin avisar.
• El pulso de reproducción usa un único timeSig.
• El piano cubre por defecto E2–E5, pero es desplazable a E1–E4 o E3–E6 con los botones 8va ↓ / ↑ (3 estados).
• El piano se regenera al cargar la página y al cambiar de octava. No se reescala automáticamente al cambiar el tamaño de la ventana.
• Los botones están fijos en HTML (3 filas concretas). No se pueden ampliar ni redistribuir desde la interfaz.
• Piano y botones insertan en el manual activo (MI o MIII); si hay un compás seleccionado en ese manual, la nota se escribe en él.
• La multiselección no contigua solo se puede transponer, no cambiar de duración ni copiar como bloque.
• La sincronización textarea ⇄ pentagrama marca en la textarea solo el rango envolvente de la multiselección, no las notas exactas (limitación del propio textarea).
• Las líneas vacías y líneas de time del textarea no generan nota en el pentagrama, así que no se resaltan al seleccionarlas.
• El Modo Iniciación no se puede configurar: la lista de paneles que oculta es fija.
• El atajo único acordeón no funciona en móviles sin teclado físico.
• El desplazamiento de octava solo tiene 3 estados (E1–E4, E2–E5, E3–E6). No se puede ir más allá sin editar el código.
• El desplazamiento de octava no se persiste entre sesiones: al recargar, vuelve a 0.
• El desplazamiento de octava no tiene atajo de teclado: solo los botones con el ratón.
• El desplazamiento de octava no afecta a la entrada MIDI: el instrumento externo se registra en su octava real.
• El filtro de posiciones Nuevo no admite rangos del tipo 2-5 en la lista personalizada: solo posiciones individuales.
• El espaciado de eventos Nuevo no permite elegir una duración distinta para el silencio: siempre hereda la del evento.
• Los tuplets se rompen Nuevo tanto al filtrar como al espaciar: los eventos se tratan como figuras independientes.

PARTE IV — PROCESO GENERATIVO

El proceso generativo reúne bloques que permiten crear materiales, transformarlos y ajustar su organización temporal. Según lo que se quiera explorar, el usuario puede aplicar uno o varios bloques, encadenar operaciones o detenerse en cualquier punto. El ajuste a un ciclo común mediante el MCM es una posibilidad de trabajo, no el objetivo obligatorio de todo proceso.

24. Concepto: Iniciador → Generador → Voz

Esta secuencia describe una organización posible del trabajo con materiales: partir de una fuente, transformarla y ajustar su realización temporal. No es un proceso automático que tenga que completarse siempre de principio a fin. El usuario decide qué material utilizar, qué operación aplicar, dónde escribir el resultado y cuándo detenerse, volver atrás o iniciar otra exploración. La escucha, la observación y la comparación orientan esas decisiones.

24.1 Los tres bloques originales

24.2 Los dos bloques nuevos

24.3 Diagrama de flujo actualizado

┌─────────────────────┐
│  1. INICIADOR       │
│  source.row12       │
│  source.row         │
│  source.serieA      │
│  source.serieB      │
│  source.serieC      │
│  source.intervals   │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│  2. GENERADOR       │
│  transform.retro    │
│  transform.invers   │
│  transform.transp   │
│  transform.filter   │◄── nuevo
│  transform.space    │◄── nuevo
│  transform.fuse     │◄── lee MI y MIII directamente
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│  3. VOZ             │
│  valor por manual   │
│  puntillo           │
│  compás             │
│  bucle hasta MCM    │
│  preservar posición │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│  4. HISTORIAL       │
│  registro de pasos  │
│  comparación        │
│  «↶ Volver»         │
└─────────────────────┘

┌─────────────────────┐
│  5. MATRIZ          │
│  P / R / I / RI     │
│  envío a manual     │
└─────────────────────┘

25. Bloque Iniciador

El Iniciador crea un material de partida a partir de los parámetros elegidos por el usuario. Ese material puede servir como punto inicial de una exploración o como fuente para una transformación posterior; no constituye por sí mismo una composición terminada.

Al pulsar Aplicar iniciador:

1. Se hace un snapshot de undo.
2. Se leen los parámetros del generador seleccionado.
3. Se ejecuta el generador.
4. El resultado se serializa a texto y se escribe en el manual elegido.
5. Se renderiza la partitura.
6. Se guarda el material internamente para que el Generador pueda usarlo como fuente.
7. Se registra el paso en el historial (§31).

Ojo: aplicar un Iniciador crea un proceso nuevo. Si ya había un Generador aplicado, se pierde.

25.1 Controles

25.2 source.row12 — Serie dodecafónica (fila dada)

• row: 12 notas. Por defecto: C4 C#4 D4 D#4 E4 F4 F#4 G4 G#4 A4 A#4 B4.
• value: valor (1/2/4/8/16). Por defecto: 4.

25.3 source.row — Fila dada (cualquier longitud)

Igual que source.row12, pero admite cualquier número de notas.

25.3a source.serieA — Serie A (12 notas · fusas) Nuevo

Serie de 12 notas predefinida, pensada para escribir con fusas. Es un caso particular de source.row12 con los parámetros ya rellenos.

El usuario puede editar la lista de notas y el valor antes de pulsar Aplicar iniciador.

25.3b source.serieB — Serie B (7 notas · semicorcheas) Nuevo

Serie de 7 notas predefinida, pensada para escribir con semicorcheas. Es un caso particular de source.row con los parámetros ya rellenos.

El usuario puede editar la lista de notas y el valor antes de pulsar Aplicar iniciador.

25.3c source.serieC — Serie C (12 notas) Nuevo

Serie dodecafónica de 12 alturas distintas, predefinida. Como todas las series, el usuario puede editar las notas y el valor antes de aplicar.

Las tres series (serieA, serieB, serieC) son opcionales: aparecen como opciones adicionales en el desplegable Tipo del bloque Iniciador, junto a las ya existentes. Si el usuario no las usa, no le afectan.

25.4 source.intervals — Por intervalos

El intervalo se elige recorriendo la lista en ciclo: con la lista [1, 3, -1] el resultado es +1, +3, −1, +1, +3, −1…. La dirección del movimiento (subir o bajar) la decide el desplegable Modo. En mixed se sortea en cada paso con semilla fija 12345.

26. Bloque Generador

El Generador aplica una operación al material de la fuente seleccionada. La elección de la fuente, de los parámetros y del destino permite probar distintas relaciones y variantes. El resultado puede escucharse y observarse antes de decidir si se utiliza como nueva fuente, si se compara con el original o si se descarta.

26.1 Controles

26.2 Fuentes disponibles

26.3 transform.retrograde — Retrogradar (R)

Invierte el orden temporal del material. Corta las ligaduras exteriores.

26.4 transform.inversion — Invertir (I)

• axis: first / last / middle.
• Fórmula: nueva = 2·eje − original.

26.5 transform.transpose — Transponer

• semitones: entero entre −36 y +36. Por defecto: 3.

26.6 transform.fuseManuals — Fusionar MI (tonal) + MIII (rítmica)

Este generador ignora la Fuente seleccionada y lee siempre los textareas de MI y MIII directamente.

Se detalla en §29.

26.7 transform.filterPositions — Filtrar posiciones Nuevo

Conserva solo los eventos del material de entrada que caen en ciertas posiciones (impar, par, cada N, lista personalizada). Sí usa la Fuente seleccionada. Se detalla en §29bis.

26.8 transform.spaceEvents — Espaciar eventos Nuevo

Intercala silencios alrededor de cada evento para separarlo en el tiempo. Sí usa la Fuente seleccionada. Se detalla en §29ter.

27. Bloque Voz (valor, puntillo y compás)

El bloque Voz permite explorar la realización temporal del material ya escrito. No transforma alturas. «Aplicar valor» cambia duraciones; «Completar ciclo» repite un manual hasta una barra; «Realinear» puede repetir ambos manuales hasta que coincidan. La casilla MCM solo controla esta última acción. Estos ajustes permiten comprobar cómo cambia el resultado musical al modificar su organización temporal, sin alterar necesariamente el material de alturas.

27.1 Controles

27.2 Aplicar valor a un manual

Al pulsar Aplicar valor a este manual:

1. Se leen los eventos del manual.
2. Se divide en compases según el compás elegido (o el del material).
3. Para cada evento:
   • Se calcula la nueva duración según el modo de puntillo.
   • Si la nota se acorta y Preservar posición está activo, se inserta un silencio explícito justo después.
4. Si el último compás queda incompleto, se rellena con silencios.

27.3 Realineación por MCM

Cuando MI y MIII tienen distinta longitud en beats, Realinear ambas voces repite el material de cada manual las veces necesarias para que ambos ciclos coincidan.

1. Calcula los beats totales de MI y MIII.
2. Calcula el MCM.
3. Para cada manual: repeticiones = MCM / beats_del_manual.
4. Si loop = false, no se repite.

27.4 Completar el ciclo de un solo manual

Completar ciclo en este manual (MCM) compara la duración de la serie del manual seleccionado con la duración del compás elegido. Repite la serie el menor número de veces para que termine en un límite de compás. No modifica el otro manual ni cambia el compás seleccionado.

1. Selecciona el manual (MI o MIII) y el compás.
2. Pulsa Completar ciclo en este manual (MCM).
3. La app indica el número de repeticiones y compases. El cambio se puede deshacer.

27.5 Ejemplos

4 C4
4 D4
4 E4
4 F4

8 C4
8 D4
8 E4
8 F4
4 rest

4 C4
4 D4
4 E4
4 F4

8 C4
8 rest
8 D4
8 rest
8 E4
8 rest
8 F4
8 rest

4 C4
4 D4
4 E4

4. C4
4. D4
4. E4
4. rest

4 C4
4 D4
4 E4
4 F4
4 G4
4 A4

time 3/4
4 C4
4 D4
4 E4
4 F4
4 G4
4 A4

28. Aleatorización de filas

Cuando el Iniciador es source.row12 o source.row, aparecen dos botones extra bajo los parámetros.

28.1 🎲 Barajar fila

Reordena aleatoriamente las notas que ya están en el campo Fila (Fisher-Yates).

28.2 🎲 Fila nueva

Reemplaza el campo Fila por una fila dodecafónica nueva: las 12 pitch classes en orden aleatorio, todas en la octava 4.

29. Fusión MI (tonal) + MIII (rítmica)

El generador transform.fuseManuals cruza dos materiales independientes:

• MI = serie tonal (alturas).
• MIII = serie rítmica (duraciones, incluyendo silencios).

Este generador ignora la Fuente. Lee siempre los textareas de MI y MIII.

29.1 Algoritmo

1. Lee MI y MIII.
2. Filtra MI a notas.
3. Filtra MIII a notas y silencios (o solo notas si ignoreRests = true).
4. Aplica la dirección rítmica (direct / retrograde / shuffle).
5. Para cada paso i:
   • truncate: recorre min(len(MI), len(MIII)).
   • cyclic: recorre len(MI), accede a MIII[i mod len(MIII)].
   • Emite un evento con la altura de MI[i] y la duración de MIII[i].

29.2 Parámetros

29.3 Ejemplos

4 C4
4 D4
4 E4
4 F4

8 rest
8 rest
2 rest
4 rest

8 C4
8 D4
2 E4
4 F4

4 C4
4 D4
4 E4
4 F4
4 G4
4 A4
4 B4
4 C5

4 rest
8 rest
2 rest

4 C4
8 D4
2 E4
4 F4
8 G4
2 A4
4 B4
8 C5

4 C4
8 D4
2 E4

4 C4
2 D4
4 E4
8 F4

8 C4
8 rest
4 D4
4 E4

8 C4
4 D4
4 E4
8 F4

29bis. Filtrar posiciones (transform.filterPositions) Nuevo

El generador transform.filterPositions recorre el material de entrada evento a evento (una nota o un silencio = un evento) y conserva solo los que caen en ciertas posiciones. Los demás se descartan. Es un "tamiz" posicional.

Este generador sí usa la Fuente seleccionada (Iniciador, texto de MI o MIII, o generador anterior). Escribe el resultado en el manual de Destino. El material de entrada no se modifica.

29bis.1 Parámetros

29bis.2 Ejemplo 1 — Patrón «Impar»

Iniciador: Fila dada con C4 D4 E4 F4 G4 A4 B4 C5 (8 notas, negras).

Generador: Filtrar posiciones → Fuente: Iniciador → Destino: MIII → Patrón: Impar.

Resultado en MIII:
4 C4
4 E4
4 G4
4 B4

En el log: 🔎 filterPositions: 8 eventos → 4 (patrón odd).

29bis.3 Ejemplo 2 — Patrón «Cada N = 3»

Mismo material. Patrón Cada N, N = 3.

Resultado en MIII:
4 C4
4 F4

En el log: 🔎 filterPositions: 8 eventos → 2 (patrón everyN, N=3).

29bis.4 Ejemplo 3 — Patrón «Lista personalizada»

Lista: 2, 5, 7.

Resultado en MIII:
4 D4
4 A4
4 B4

En el log: 🔎 filterPositions: 8 eventos → 3 (patrón customList, lista=2,5,7).

29bis.5 Ejemplo 4 — Con silencios

Entrada con silencios intercalados (6 eventos):

4 C4
4 rest
4 E4
4 rest
4 G4
4 rest

Con Patrón Impar y Conservar silencios = No:

4 C4
4 E4
4 G4

Con Patrón Impar y Conservar silencios = Sí:

4 C4
4 rest
4 E4
4 rest
4 G4
4 rest

29bis.6 Ejemplo 5 — Combinado con otro generador

1. Iniciador: fila de 12 notas → MI.
2. Generador 1: Filtrar posiciones, Patrón Par, Destino MIII. → 6 notas.
3. Generador 2: Fuente Generador anterior, Retrogradar, Destino MIII.

Resultado: subconjunto par de la serie, retrogradado.

29bis.7 Comportamiento en casos límite

29ter. Espaciar eventos (transform.spaceEvents) Nuevo

El generador transform.spaceEvents toma cada evento del material de entrada y lo expande en N "slots", donde cada slot tiene la misma duración que el evento original. Los slots que no ocupa el evento se rellenan con silencios.

Este generador sí usa la Fuente seleccionada. El material de entrada no se modifica: solo se escribe el resultado expandido en el manual de Destino.

29ter.1 Parámetros

29ter.2 Ejemplo 1 — Slots=2, silencio después

Iniciador: Fila dada con C4 D4 E4 F4 (4 negras).

Generador: Espaciar eventos → Slots: 2 → Posición: Después.

Resultado en el manual destino:
4 C4
4 rest
4 D4
4 rest
4 E4
4 rest
4 F4
4 rest

En el log: ↔️ spaceEvents: 4 eventos → 8 (slots=2, silencio after).

29ter.3 Ejemplo 2 — Slots=2, silencio antes

Mismo material, Posición Antes:

4 rest
4 C4
4 rest
4 D4
4 rest
4 E4
4 rest
4 F4

29ter.4 Ejemplo 3 — Slots=3

Posición Después, Slots = 3 (2 silencios por evento):

4 C4
4 rest
4 rest
4 D4
4 rest
4 rest
4 E4
4 rest
4 rest
4 F4
4 rest
4 rest

29ter.5 Ejemplo 4 — Con material rítmico variado

Si la entrada tiene duraciones distintas, cada evento genera silencios de su propia duración.

Entrada:

2 C4
4 D4
8 E4

Slots=2, Después:

2 C4
2 rest
4 D4
4 rest
8 E4
8 rest

La blanca genera un silencio de blanca, la negra un silencio de negra, la corchea uno de corchea.

29ter.6 Ejemplo 5 — Con tuplets

Entrada con tresillo:

t3:2 8 C4
8 D4
8 E4

Slots=2, Después:

8 C4
8 rest
8 D4
8 rest
8 E4
8 rest

Los silencios salen como corcheas normales (no forman parte del tresillo). El generador rompe el tuplet intencionadamente: la expansión no conserva la agrupación.

29ter.7 Ejemplo 6 — Con ligaduras

Entrada con ligadura:

4 C4 ~
4 C4
4 D4

Slots=2, Después:

4 C4
4 rest
4 C4
4 rest
4 D4
4 rest

La ligadura se elimina explícitamente. Si no se hiciera, al insertar silencios la segunda C4 dejaría de ser continuación de la primera y la ligadura quedaría colgando.

29ter.8 Ejemplo 7 — Combinado con filtro

1. Iniciador: 8 notas.
2. Generador 1: Filtrar posiciones, Patrón Par → 4 notas.
3. Generador 2: Fuente Generador anterior, Espaciar eventos, Slots 3, Antes.

Resultado: 4 notas, cada una precedida de 2 silencios de su misma duración.

29ter.9 Comportamiento en casos límite

29quater. Diferencias entre los dos nuevos generadores

29quater.1 Recetas combinadas

Receta A — Serie con huecos regulares

1. Iniciador: Serie dodecafónica, Valor Negra (4), Destino MI.
2. Generador: Espaciar eventos → Fuente Iniciador → Destino MIII → Slots 2, Después.
3. Voz: Manual MIII, Valor Negra, Preservar posición activado.

Resultado: 12 notas en MI, 12 notas + 12 silencios en MIII.

Receta B — Subconjunto con acentos

1. Iniciador: serie dodecafónica.
2. Generador 1: Filtrar posiciones → Patrón Impar → 6 notas.
3. Generador 2: fuente Generador anterior, Espaciar eventos → Slots 2, Después.
4. Voz: aplicar Valor Negra a MIII.

Resultado: 6 notas + 6 silencios, alternando.

Receta C — Canon rítmico

1. Iniciador → MI.
2. Generador 1 (destino MIII): Filtrar posiciones → Patrón Cada N = 3.
3. Generador 2 (destino MIII): fuente Texto actual de MIII, Espaciar eventos → Slots 3, Antes.
4. Matriz dodecafónica: usar MI como serie base y enviar formas a MIII.

Resultado: dos voces que dialogan con materiales derivados del mismo origen.

28quater. Reparto automático de una serie entre MI y MIII Nuevo

Esta herramienta toma las notas escritas en un manual y las distribuye entre MI y MIII en bloques alternos. Sirve para espacializar una serie generada o escrita previamente, manteniendo su secuencia temporal.

28quater.1 Opciones

• Serie de: el manual que contiene el material de partida.
• Empieza en: MI o MIII, según dónde quieras oír/ver la primera nota.
• Alternar cada: tamaño del bloque de notas antes de pasar al otro manual. Con «1 nota», el reparto va MI–MIII–MI–MIII…; con «2 notas», MI–MI–MIII–MIII…

Pulsa Repartir entre manuales. El contenido anterior de ambos manuales se sustituye por el resultado; ↶ Deshacer restaura el estado previo.

Nota sobre el historial: esta operación sí se puede deshacer mediante el sistema general de deshacer, pero no se incorpora al bloque «Historial y comparación» del panel generativo. Por tanto, no aparece allí como un paso registrado ni genera una comparación antes/después.

28quater.2 Qué conserva

Se conservan el orden, la duración de cada evento, los cambios de compás y las ligaduras válidas. Cada nota y sus continuaciones ligadas quedan en el mismo manual. Los silencios de la serie de partida se escriben en ambos manuales, de modo que mantienen su posición temporal. Los acordes cuentan como un evento para el reparto.

28quater.3 Ejemplo

Con esta serie en MI, el tamaño de bloque 1 y «Empieza en MI»:

4 C4
8 D4
4. E4
4 F4

MI conserva C4 y E4; MIII recibe D4 y F4. En las posiciones asignadas al otro manual se insertan silencios de la misma duración:

MI:                 MIII:
4 C4                4 rest
8 rest              8 D4
4. E4               4. rest
4 rest              4 F4

La duración total y el instante de cada nota se mantienen, aunque la distribución gráfica y sonora pasa a alternar entre manuales.

30. Guardar y cargar proceso

30.1 Estructura del JSON

{
  "version": "2.0",
  "process": {
    "iniciador": { "generator": "source.row12", "params": {...}, "manual": "MI", "events": [...] },
    "generador": { "generator": "transform.inversion", "source": "iniciador", "params": {...}, "manual": "MIII", "events": [...] },
    "voces": {
      "MI":   { "value": 4, "loop": true, "preservePosition": true },
      "MIII": { "value": 4, "loop": true, "preservePosition": true }
    }
  },
  "texts": { "MI": "...", "MIII": "..." }
}

30.2 Al guardar

1. Se serializa genProcess.
2. Se añaden los textos actuales.
3. Se descarga como proceso_generativo.json.

30.3 Al cargar

1. Snapshot de undo.
2. Se restauran los textos.
3. Se restauran los selectores y sus parámetros.
4. Se renderiza.

31. Historial y comparación

El bloque 4. Historial y comparación registra cada paso aplicado en el panel generativo y permite volver a un estado anterior. Además de servir para deshacer, facilita revisar el recorrido seguido y comparar cómo ha evolucionado el material entre operaciones.

31.1 Qué se registra

Se registra un paso cada vez que se pulsa uno de estos botones:

• Aplicar iniciador (bloque 1).
• Aplicar generador (bloque 2).
• Aplicar valor a este manual (bloque 3).
• Completar ciclo en este manual (MCM) (bloque 3).
• Realinear ambas voces (bloque 3).
• Cualquier etiqueta P/R/I/RI de la matriz (bloque 5).

31.2 Etiqueta del paso

• Iniciador «Serie dodecafónica» → MI
• Generador «Invertir» → MIII
• Voz MI: valor 2 con puntillo, compás 3/4
• Realinear ambas voces (MCM)
• Matriz: P0 → MIII

31.3 Comparación antes/después

Al registrar un paso, se muestra bajo la lista una comparación entre los dos estados de cada manual que cambió:

MI
antes:   C4 D4 E4 F4
después: C4 D4 E4 F4 G4

MIII
antes:   (vacío)
después: C3 D3 E3 F3

31.4 Botón «↶ Volver»

Cada paso tiene un botón ↶ Volver que:

1. Hace un snapshot de undo (puedes deshacer con Ctrl+Z).
2. Restaura los dos textareas al estado anterior a ese paso.
3. Descarta el paso y todos los posteriores.

31.5 Relación con el Ctrl+Z general

El historial del panel y el Ctrl+Z del editor son mecanismos independientes. Pulsar «↶ Volver» sí hace un snapshot, así que puedes deshacerlo con Ctrl+Z.

31.6 Persistencia

El historial vive en memoria (history[]). Se pierde al recargar la página. No se guarda en el JSON del proceso.

32. Matriz dodecafónica

El bloque 5. Matriz dodecafónica construye la matriz clásica P/R/I/RI de una fila dodecafónica y permite enviar cualquier forma a un manual.

32.1 Concepto

Dada una fila dodecafónica (las 12 pitch classes en un orden determinado), se definen cuatro formas:

32.2 Algoritmo

M[i][j] = (p[j] + p[0] − p[i]) mod 12

donde p = [pc_0, pc_1, …, pc_11] son las 12 pitch classes de la fila,
      todas en el rango 0..11.

32.3 Interfaz

32.4 Tabla

La tabla muestra 12 filas y 12 columnas, con cuatro bandas de etiquetas clicables:

• Cabecera superior: etiquetas I0–I11. Envía la columna hacia abajo (I).
• Columna izquierda: etiquetas P0–P11. Envía la fila hacia la derecha (P).
• Columna derecha: etiquetas R0–R11. Envía la fila hacia la izquierda (R).
• Cabecera inferior: etiquetas RI0–RI11. Envía la columna hacia arriba (RI).

La diagonal principal aparece resaltada en naranja.

Los números n de las etiquetas indican la pitch class con la que empieza la forma (0 = C, 1 = C#, 2 = D, …, 11 = B).

32.5 Envío de una forma

1. Se hace un snapshot de undo.
2. Se escribe el manual destino con una nota por línea, con la forma elegida y el valor seleccionado (todas en octava 4).
3. Se renderiza la partitura.
4. Se registra el paso en el historial (§31).
5. Se muestra el mensaje ✅ P5 enviada a MIII.

32.6 Ejemplo

Entrada en MI (fila dodecafónica por defecto):

4 C4 C#4 D4 D#4 E4 F4 F#4 G4 G#4 A4 A#4 B4

1. Serie de = MI, Enviar a = MIII, Valor = 4.
2. Pulsa Generar matriz.
3. Pulsa la etiqueta P5.

Resultado en MIII:

4 G4
4 G#4
4 A4
4 A#4
4 B4
4 C5
4 C#5
4 D5
4 D#5
4 E5
4 F5
4 F#5

32.7 Limitaciones

• La matriz exige exactamente 12 pitch classes distintas.
• Las formas se envían como notas sueltas en octava 4.
• La forma enviada sobreescribe el manual destino sin avisar.
• La matriz no distingue enarmonías: C# y Db son la misma pitch class.

33. Notas de implementación y decisiones abiertas

33.1 Semilla RNG

33.2 Sincronización textarea ⇄ pentagrama Nuevo

La sincronización es unidireccional en cada sentido, pero las dos direcciones conviven:

• Cuando el foco está en el textarea, la selección nativa del textarea dirige el resaltado del SVG.
• Cuando el foco está en el pentagrama (o en cualquier otro sitio), el clic en el pentagrama dirige la selección del textarea y, si la textarea no tiene foco, se dibuja el overlay.

El cambio de "quién dirige" es transparente: no hay que configurar nada.

33.3 Multiselección no contigua y guardado

La multiselección no se guarda en el JSON del proyecto ni en el del proceso. Es un estado transitorio de la sesión.

33.4 Paneles colapsables, modo Iniciación y octava

Los dos primeros se persisten en localStorage. La octava, no.

Esto significa que dos usuarios en el mismo navegador comparten preferencias de panel y modo. Si se necesita aislar, habría que usar un prefijo distinto por usuario o un backend.

33.5 Encadenamiento de generadores

La Fuente generador anterior permite encadenar G1 → G2, pero solo un nivel.

33.6 Undo del proceso generativo

Cada botón que escribe texto hace su propio snapshot de undo. El historial propio del panel (§31) permite volver a un paso concreto, pero es un mecanismo aparte del Ctrl+Z general.

33.7 Pulso con cambios de compás Pendiente

El pulso usa un único timeSig. No respeta cambios de compás dentro de la pieza.

33.8 Filtrar posiciones y espaciar eventos Nuevo

Ambos generadores siguen la convención general: no modifican la fuente. Escriben el resultado en el manual de Destino. Por eso son intercambiables con el resto de generadores y se pueden encadenar usando la fuente generador anterior.

34. Apéndice de ejemplos largos

34.1 Flujo completo: fila dodecafónica → inversión → MCM

1. Iniciador source.row12, fila por defecto, valor 4, Manual MI.
2. Generador transform.inversion, Fuente = Iniciador, axis = first, Destino = MIII.
3. Voz MI: valor 8, Preservar posición = OFF.
4. Realizar por MCM (loop ON en ambos).

MCM(6, 12) = 12
MI:   12 / 6 = 2 repeticiones
MIII: 12 / 12 = 1 repetición

34.2 Flujo completo: matriz dodecafónica

1. Escribir la fila en MI.
2. Generar matriz (Serie de = MI, Enviar a = MIII, Valor = 4).
3. Pulsar "P5" para enviar la forma a MIII.
4. Pulsar "R0" para enviar la retrogradación a MIII.
5. Consultar el historial.

Aparecen 2 pasos. Pulsar «↶ Volver» en el primero descarta el segundo.

34.3 Flujo completo: fusión tonal-rítmica

1. Escribir MI tonal y MIII rítmico a mano.
2. Fusionar, direct, cyclic, ignoreRests = false, Destino = MI.

34.4 Flujo completo: fila nueva + inversión + historial

1. Iniciador source.row12, pulsar "🎲 Fila nueva".
2. Generador transform.inversion, axis = middle, Destino = MIII.
3. Ver el historial: 2 pasos. Pulsar «↶ Volver» en el paso 1 revierte todo el proceso.

34.5 Flujo completo: filtro y espaciado encadenados Nuevo

1. Iniciador source.row12, Valor Negra, Manual MI.
2. Generador 1: Filtrar posiciones, Patrón Cada N = 3, Destino MIII. → 4 notas (posiciones 1, 4, 7, 10).
3. Generador 2: Espaciar eventos, Fuente Generador anterior, Slots 2, Posición Después, Destino MIII.
4. Voz: Manual MIII, Valor Negra, Preservar posición ON.

Resultado en MIII: 4 notas + 4 silencios, alternando.

APÉNDICES

Apéndice A — Glosario

• Alteración: signo (#, b, n) que modifica la altura de una nota.
• Alteración vigente: alteración activa para una letra y octava en un punto del compás.
• Bloque ligado: secuencia de items consecutivos unidos por ~.
• Botones: representación visual de un manual de botones (MI de botones). Tres filas cromáticas dispuestas diagonalmente.
• Cruzada: selección simultánea de dos rangos de compases, uno en cada manual.
• Cuantización: ajuste de duraciones reales a figuras notacionales.
• Eje: nota de referencia para la inversión.
• Fila dodecafónica: las 12 pitch classes en un orden determinado.
• Filtro de posiciones Nuevo: generador que conserva solo los eventos en ciertas posiciones. Ver §29bis.
• Forma (P/R/I/RI): las cuatro formas canónicas de una fila dodecafónica.
• Fragmento: secuencia continua de notas y silencios dentro del mismo manual.
• Fusión MI+MIII: cruzar la serie tonal de MI con la serie rítmica de MIII.
• Generador: en el proceso generativo, transforma material (paso 2).
• Historial: pila de pasos del proceso generativo, con comparación antes/después.
• Iniciador: produce material desde cero (paso 1).
• Inversión (I): reflejo de alturas alrededor de un eje.
• Manual: término genérico para un conjunto de teclas o botones de un acordeón. En esta app: MI (derecho) y MIII (izquierdo).
• Manual de teclas: manual con teclado tipo piano. Es el MI de teclas.
• Manual de botones: manual con botones dispuestos en filas diagonales. Es el MI de botones.
• Matriz dodecafónica: tabla 12×12 con todas las formas P/R/I/RI de una fila.
• MCM: mínimo común múltiplo de duraciones. Se usa para igualar dos voces o completar una serie hasta un número entero de compases.
• MI: manual derecho. Puede ser de teclas o de botones.
• MII: manual izquierdo de bajos estándar o Stradella. No usado en esta app.
• MIII: manual izquierdo, de botones.
• Modo Iniciación Nuevo: interfaz simplificada para niños. Oculta las herramientas avanzadas. Se alterna con Alt+M.
• Multiselección no contigua Nuevo: conjunto de notas sueltas marcadas con Ctrl+Shift+clic (verde).
• Octava de entrada Nuevo: desplazamiento visual de la octava del piano y de los botones. Tres estados: −1, 0, +1.
• Overlay Nuevo: rectángulo azul translúcido que se dibuja sobre las líneas seleccionadas del textarea cuando esta no tiene el foco.
• Padding: silencio automático para completar compases incompletos.
• Panel colapsable Nuevo: bloque del sidebar que se puede plegar y desplegar. Implementado con <details>.
• Pantalla completa: modo de visualización del área de partitura.
• Piano: representación visual de un manual de teclas (MI de teclas). Rango desplazable.
• Pitch class: clase de altura, sin octava. 0 = C, 1 = C#, …, 11 = B.
• Portapapeles de compases: almacén temporal de un rango de compases.
• Portapapeles de fragmentos: almacén temporal de notas/silencios contiguos.
• Prima (P): forma original de una fila dodecafónica.
• Proceso generativo: flujo Iniciador → Generador → Voz → Historial / Matriz.
• Pulso: click audible por tiempo durante la reproducción.
• Retrogradación (R): inversión del orden temporal de las unidades de sonido.
• Retrogradación de la inversión (RI): forma que combina retrogradación e inversión.
• Semilla (RNG): valor inicial de un generador pseudoaleatorio.
• Serie simétrica: sucesión de intervalos con patrón de direcciones repetido.
• Sincronización textarea ⇄ pentagrama Nuevo: correspondencia bidireccional entre líneas del texto y notas del pentagrama.
• Slots Nuevo: número de casillas que ocupa cada evento en el generador "Espaciar eventos". Ver §29ter.
• Sonido efectivo: altura real de una nota, considerando la herencia.
• Stable ID: identificador único asignado a cada nota en render.
• Unidad de sonido: una nota lógica (con su ataque) más su duración total.
• Voz: define la realización temporal (valor, puntillo, compás, bucle, MCM).

Apéndice B — Tabla resumen de atajos

B.1 Sintaxis de entrada

Regla base: la primera palabra de cada línea es la duración. Todo lo que sigue son las notas del mismo evento: una sola nota, o varias formando un acorde (todas simultáneas). Para tener varios eventos, usa una línea por evento.

B.2 Atajos de teclado

Apéndice C — Cómo funciona el resaltado sincronizado

1. Cada nota de VexFlow recibe un atributo data-note-id único.
2. Al pulsar ▶ Reproducir, playAudio() programa cada nota con su tiempo exacto de inicio y duración. Con 🔁 Bucle, programa por adelantado las notas de la vuelta siguiente para mantener la continuidad.
3. Un bucle requestAnimationFrame (updateVisuals) comprueba si now está dentro del intervalo de cada evento.
4. Cuando una nota entra en su intervalo, se le añade la clase .playing y se llama a setNoteHighlight(el, color).
5. Al salir del intervalo, se llama a setNoteHighlight(el, null) para restaurar los colores originales.
6. Al pulsar ⏹ Parar o al terminar, se llama a stopAudio().

Por qué no basta el CSS: VexFlow 5 dibuja las cabezas de nota como <ellipse> con fill aplicado inline. Hay que recorrer los descendientes y modificar el atributo directamente.

C.1 Resaltado desde la textarea (violeta) Nuevo

Es un mecanismo aparte del resaltado de reproducción. Se activa al seleccionar texto en la textarea y añade la clase .nota-desde-textarea a las cabezas de nota correspondientes. Se limpia al perder el foco o al deseleccionar.

C.2 Overlay visual sobre la textarea Nuevo

Cuando el pentagrama selecciona una línea (clic simple, fragmento, compás, multiselección), se dibuja un <div class="sync-line-overlay"> encima de esa línea en el textarea. Se calcula con getExactLineHeight(), que mide el line-height real de la textarea (con un div espejo si el CSS no lo declara). El overlay se oculta cuando la textarea recibe el foco (porque entonces ya se ve la selección nativa).

Apéndice D — Comportamiento de teclas según el foco

Apéndice E — Ejemplos completos

E.1 Herencia simple

4 F#4 F4 F4 F4

• Sonido: F#4 F#4 F#4 F#4.
• Render: Fa# Fa Fa Fa.

E.2 Becuadro

4 F#4 Fn4 F4 F4

• Sonido: F#4 F4 F4 F4.
• Render: Fa# Fa♮ Fa Fa.

E.3 Transposición de compás sin ligadura

Entrada:

4 F4
4 F4
4 F4
4 F4

Acción: seleccionar compás, pulsar ↑.

4 F#4
4 F#4
4 F#4
4 F#4

Tras Generar Partituras:

4 F#4
4 F4
4 F4
4 F4

E.4 Ligadura dentro del mismo compás

4 C4 ~
4 C4

Retrogradar (R): el resultado es 2 C4.

E.5 Ligadura entre compases + transposición

Entrada:

2 F4
4 D4
4 D4 ~
4 D4
2 rest

Tras ↑:

2 F#4
4 D#4
4 D#4 ~
4 D#4
2 rest

E.6 Retrogradación con padding

Entrada:

2 F4
4 D4
4 D4 ~
4 D4
2 rest

Tras R:

2. rest
4 D4 ~
4 D4
4 D4
2 F4

E.7 Inversión con ligadura

Entrada:

2 F4
4 G#4
4 G#4 ~
4 G#4
2 rest

Tras I con eje F4:

2 F4
4 D4
4 D4 ~
4 D4
2 rest

E.8 Normalización

4 F#4 F#4 F#4

Tras Generar Partituras:

4 F#4 F4 F4

E.9 Copiar un fragmento y sustituir

Entrada en MI:

4 C4 D4 E4 F4

1. Shift+clic en C4 y Shift+clic en D4 → fragmento de 2 beats.
2. 🎼 Copiar fragmento.
3. Clic en el compás.
4. 🎼 Sustituir.

Resultado: sin cambios.

E.10 Copiar un fragmento e insertarlo

4 C4 D4 E4 F4

1. Shift+clic en C4 dos veces → fragmento de 1 beat.
2. 🎼 Copiar fragmento.
3. Clic en el compás.
4. 🎼 Insertar.

Resultado:

4 C4 C4 D4 E4
4 F4 rest rest rest

E.11 Cambio de valor a negra con puntillo forzado

Entrada en MI: 4 C4 / 4 D4 / 4 E4.

Acción: Voz MI, Valor = 4, Puntillo = "Con puntillo", Preservar posición = OFF.

Resultado:

4. C4
4. D4
4. E4
4. rest

E.12 Forzar compás 3/4

Entrada en MI: 4 C4 … 4 A4 (6 negras).

Acción: Voz MI, Valor = 4, Compás = 3/4.

Resultado:

time 3/4
4 C4
4 D4
4 E4
4 F4
4 G4
4 A4

E.13 Reproducir con pulso activo

1. Activa el checkbox 🔔 Pulso en la cabecera.
2. Pulsa ▶ Reproducir.
3. Se oye un click por tiempo, con acento en el primer tiempo de cada compás.
4. Al pulsar ⏹ Parar, los clicks se detienen junto con las notas.

E.14 Matriz dodecafónica: enviar P5 a MIII

Entrada en MI (fila dodecafónica): 4 C4 C#4 D4 D#4 E4 F4 F#4 G4 G#4 A4 A#4 B4.

1. Panel generativo → Bloque 5 → Serie de = MI, Enviar a = MIII, Valor = 4.
2. Pulsa Generar matriz.
3. Pulsa la etiqueta P5 (fila 5, columna izquierda).

Resultado en MIII:

4 G4
4 G#4
4 A4
4 A#4
4 B4
4 C5
4 C#5
4 D5
4 D#5
4 E5
4 F5
4 F#5

E.15 Historial: volver a un paso anterior

1. Aplica un Iniciador, un Generador y un cambio de Voz.
2. El bloque 4 muestra los 3 pasos.
3. Pulsa ↶ Volver en el paso 1.
4. Los textareas vuelven al estado anterior al paso 1.
5. Los pasos 2 y 3 se descartan del historial.
6. Puedes deshacer este "volver" con Ctrl+Z.

E.16 Insertar una nota desde el piano o los botones

1. Selecciona el manual activo: MI o MIII.
2. Elige la duración con los botones 1/2/4/8/S y, si quieres, activa el puntillo con ..
3. Si tu instrumento es de teclas, pulsa una tecla del piano.
4. Si tu instrumento es de botones, pulsa un botón de las tres filas.
5. La nota se reproduce y se inserta en el manual activo con la duración elegida.

E.17 Sincronización textarea ⇄ pentagrama Nuevo

Entrada en MI:

4 C4
4 D4
4 E4
4 F4

1. Haz clic en la nota E4 del pentagrama.
2. La línea 3 del textarea (4 E4) queda marcada con un overlay azul claro.
3. Alternativamente, selecciona con el ratón las líneas 2 y 3 del textarea (4 D4 y 4 E4).
4. En el pentagrama, las cabezas de nota de D4 y E4 se resaltan en violeta.
5. Al hacer clic en un lugar vacío del pentagrama, la sincronización se limpia.

E.18 Transponer tres notas sueltas con multiselección Nuevo

Entrada en MI: 4 C4 D4 E4 F4.

1. Clic en C4 → se vuelve azul.
2. Ctrl+Shift+clic en D4 → ambos se vuelven verdes (multiselección).
3. Ctrl+Shift+clic en F4 → los tres se vuelven verdes; E4 queda sin marcar.
4. Pulsa + una vez → resultado: 4 C#4 D#4 E4 F#4.
5. Pulsa Esc para limpiar la multiselección.

E.19 Navegar por los paneles con el teclado Nuevo

1. Pulsa Alt+↓: se abre la ayuda "📖 Sintaxis y Atajos".
2. Pulsa Alt+↓ cinco veces: recorres Configuración, Claqueta, Opciones MIDI, Iniciador, Generador (cada uno se abre y cierra el anterior).
3. Pulsa Alt+↑: vuelves a Iniciador.
4. Pulsa Alt+Enter: Iniciador y Generador quedan abiertos a la vez.
5. Pulsa Alt+Shift+Q: como hay paneles abiertos, se cierran todos. Si lo vuelves a pulsar, se abren todos.

E.20 Alternar Modo Iniciación Nuevo

1. Al abrir el editor por primera vez, arranca en Modo Iniciación: solo se ven el piano, los botones, las dos textareas, los botones Generar Partituras y Limpiar, y un aviso.
2. El botón de la cabecera dice ⚙️ Avanzado.
3. Pulsa Alt+M o haz clic en ⚙️ Avanzado: aparecen todas las herramientas avanzadas (Inspector, Panel generativo, Asistente de patrones, etc.).
4. El botón ahora dice 🔰 Iniciación.
5. Pulsa Alt+M otra vez para volver al modo Iniciación.
6. Al recargar la página, la app arranca en el modo que estaba activo.

E.21 Desplazar la entrada una octava Nuevo

Objetivo: escribir una nota grave (Mi1) sin cambiar la partitura general.

1. Comprueba la etiqueta #octaveOffsetLabel: muestra 0.
2. Pulsa 8va ↓. La etiqueta pasa a −1 y el piano ahora cubre E1–E4.
3. Pulsa una tecla del piano. Se inserta la nota en la octava desplazada (por ejemplo, 4 E1).
4. Si quieres volver al rango original, pulsa 8va ↑ una vez. La etiqueta vuelve a 0.
5. Si quieres escribir en la octava alta, pulsa 8va ↑ dos veces. La etiqueta muestra +1 y el piano cubre E3–E6.
6. Pulsa una tecla: se inserta la nota en la octava +1 (por ejemplo, 4 E6).

En el Registro de actividad aparecen los mensajes del cambio de octava con el rango resultante.

E.22 Semicorchea con S o con 9 Nuevo

Ambas teclas hacen lo mismo:

1. Sin selección: S o 9 fijan la duración base de entrada a semicorchea.
2. Con una nota o silencio seleccionado: S o 9 cambian la duración del elemento seleccionado a semicorchea.

En teclados sin Numpad, S está más cerca de la mano izquierda; en teclados con Numpad, 9 es más rápido de pulsar.

E.23 Filtrar posiciones — subconjunto impar Nuevo

1. Iniciador Fila dada, Notas: C4 D4 E4 F4 G4 A4 B4 C5, Valor Negra (4), Manual MI.
2. Generador Filtrar posiciones, Fuente Iniciador, Patrón Impar (1, 3, 5, 7…), Conservar silencios No, Destino MIII.

Resultado en MIII: 4 C4 / 4 E4 / 4 G4 / 4 B4.

E.24 Espaciar eventos — airear una serie Nuevo

1. Partiendo del ejemplo E.23, MIII tiene 4 notas.
2. Generador Espaciar eventos, Fuente Texto actual de MIII, Slots 2, Posición Después, Destino MIII.

Resultado en MIII: 4 C4 / 4 rest / 4 E4 / 4 rest / 4 G4 / 4 rest / 4 B4 / 4 rest.

E.25 Filtro + espaciado combinados Nuevo

1. Iniciador source.row12, valor Negra, Manual MI.
2. Generador 1: Filtrar posiciones, Patrón Cada N, N = 3, Destino MIII.
3. Generador 2: Espaciar eventos, Fuente Generador anterior, Slots 3, Posición Antes, Destino MIII.

Resultado en MIII: 4 notas (posiciones 1, 4, 7, 10 de la serie), cada una precedida de 2 silencios de su misma duración.

Apéndice F — Mantenimiento del documento

• Las normas vigentes describen el comportamiento actual del código.
• Los pendientes describen funcionalidades no implementadas.
• Al implementar un pendiente, se promueve a normas vigentes y se actualiza la numeración.
• Al cambiar una decisión de diseño, se actualiza la Parte II y se revisan las normas afectadas.
• Al añadir una sección nueva de guía de uso, se añade al índice.
• Los ejemplos del Apéndice E se actualizan cuando cambia el comportamiento de las transformaciones.
• La Parte IV (proceso generativo) se actualiza al añadir nuevos bloques al panel.
• Al añadir una funcionalidad transversal (como la sincronización, el modo Iniciación o la octava de entrada), se añade una sección «NNbis» dentro de la Parte I y se refleja en la tabla de la §0.3.
• Al añadir un nuevo generador al panel generativo, se añade su descripción en §26, y si es largo se le dedica una sección «§29X» (como §29bis y §29ter).
• Al cambiar un atajo de teclado, actualizar SIEMPRE los cinco sitios siguientes:
  1. Tabla §9 correspondiente del manual.
  2. Apéndice B.2 (tabla resumen de atajos).
  3. Apéndice D (comportamiento según foco).
  4. Sección temática donde se describa el atajo (p. ej. §11bis.4 para el acordeón).
  5. Panel interno de ayuda del editor (em.html).

Manual Unificado V11.1 — Editor Musical (MI y MIII).
La aplicación forma parte de un conjunto de aplicaciones dirigidas a la improvisación para acordeón.

🎼 Volver al editor