Manual de Minuet

# Manual de Minuet

Sandro S. Andrade `<`(sandroandrade AT kde.org)`>`

Traductor: Eloy Cuadra
revisión 0.4 (KDE Gear 21.08) (2021-10-19)

Copyright © 2016 Sandro Andrade

Aviso Legal

Minuet es una aplicación para el aprendizaje musical. Contiene un conjunto de ejercicios de entrenamiento auditivo que contemplan el uso de intervalos, acordes y escalas.

Capítulo 1. Introducción
Introducción

# Capítulo 1. Introducción

Bienvenido a Minuet: el software musical educativo. Minuet está pensado para ayudar a estudiantes y profesores en diversos aspectos de la educación musical, como el entrenamiento auditivo, la lectura a primera vista, el solfeo, las escalas, el ritmo, la armonía y la improvisación. Minuet hace un amplio uso de las funcionalidades MIDI para proporcionar un completo conjunto de funciones sobre cambios de volumen, tempo y modulación, lo que hace de Minuet una valiosa herramienta tanto para el principiante como para el músico experimentado.

Minuet incluye un extenso conjunto de ejercicios para entrenamiento del oído y permite añadir fácilmente otros nuevos para poder extender sus funciones y adaptarlo a diversos contextos de educación musical.

Capítulo 2. Uso de Minuet
Uso de Minuet

# Capítulo 2. Uso de Minuet

En las dos siguientes secciones (Inicio de Minuet y Ejercicios de Minuet) le proporcionaremos los pasos necesarios para empezar a usar Minuet.

## Inicio de Minuet

Puede iniciar Minuet desde el lanzador de aplicaciones. Abra el menú global haciendo clic en el icono del lanzador de aplicaciones que hay en la barra de la parte inferior de su pantalla. Esto mostrará un menú. Mueva el cursor hasta la opción del menú global Aplicaciones → Educación → Varios → Minuet (Software educativo musical) o con Alt+F2 e introduciendo minuet en el campo de entrada.

Ejercicios y flujo de trabajo en Minuet
Ejercicios y flujo de trabajo en Minuet

## Ejercicios y flujo de trabajo en Minuet

La interfaz de usuario de Minuet contiene tres componentes principales:

Menú de navegación

  Le permite desplazarse por las categorías de ejercicios de Minuet y seleccionar un determinado ejercicio. El menú de navegación se crea de forma dinámica según los archivos de especificación de ejercicios, como se describe en Creación de ejercicios. Los ejercicios de Minuet se agrupan según su clase, como intervalos, escalas y acordes.

Vista del teclado

  Expone los eventos MIDI `note on` secuenciados por la ejecución de un archivo MIDI o de un ejercicio.

Vista de ejercicios

  Muestra, para un determinado ejercicio, botones para controlar la presentación del ejercicio y un conjunto de posibles respuestas para el ejercicio. La ejecución de un ejercicio comienza al pulsar el botón Iniciar la prueba. Minuet reproduce un intervalo, un acorde o una escala al azar y el estudiante debe seleccionar una respuesta de entre las posibles que se muestran. Minuet siempre presenta (como un pequeño círculo blanco en la vista del teclado) la primera nota del intervalo o escala seleccionado, o la nota raíz del acorde seleccionado. Al situar el cursor sobre una posible respuesta, Minuet resalta su correspondiente representación visual en el visor del teclado. Las notas restantes de la respuesta se muestran como pequeños círculos cuyo color es idéntico al del botón de la respuesta sobre el que se ha situado el cursor. El estudiante puede escuchar el ejercicio de nuevo pulsando el botón Reproducir la pregunta, pulsar el botón de la respuesta escogida u obtener la respuesta correcta pulsando el botón Me rindo. Se puede volver a ejecutar el mismo ejercicio pulsando el botón Detener la prueba y volviendo a pulsar el botón Nueva pregunta.

Capítulo 3. Creación de nuevos ejercicios de Minuet
Creación de nuevos ejercicios de Minuet

# Capítulo 3. Creación de nuevos ejercicios de Minuet

Los ejercicios de Minuet se definen en archivos de especificación de ejercicios, escritos en formato JSON:

    {
      "exercises": [
        {
          "name": "Intervalos",
          "root": "21..104",
          "playMode": "scale",
          "children": [
            {
              "name": "Intervalos melódicos ascendentes",
              "children": [
                {
                  "name": "Segundas",
                  "options": [
                    {
                      "name": "Segunda menor",
                      "sequenceFromRoot": "1"
                    },
                    {
                      "name": "Segunda mayor",
                      "sequenceFromRoot": "2"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

Los archivos de especificación de ejercicios de Minuet contienen un objeto JSON de nivel superior que incluye la tabla de `ejercicios`. Esta tabla define una estructura jerárquica de ejercicios, agrupados por categorías. Cada categoría o ejercicio posee un nombre. Los objetos JSON de categorías contienen una propiedad llamada `children` que describe las subcategorías o ejercicios que contiene dicha categoría. Los objetos JSON de ejercicios contienen una propiedad llamada `options` que define las posibles respuestas para dicho ejercicio. Cada vez que se ejecuta un ejercicio, Minuet selecciona al azar una respuesta entre las posibles y se espera que el estudiante pulse el botón de la respuesta que se corresponda con la respuesta seleccionada.

Cualquier (sub)categoría puede definir un parámetro `root` para indicar el intervalo del que se escogerá al azar la nota inicial del intervalo, acorde o escala para todos los ejercicios de dicha categoría. Este intervalo corresponde a los números de notas MIDI estándares y sigue el formato `<valor-mín>..<valor-máx>`. El ejemplo mostrado anteriormente usa todo el intervalo del teclado como posibles notas raíz (21..104). El parámetro `playMode` indica cómo se deben reproducir las posibles respuestas: como una `escala` (una nota tras otra) o como un `acorde` (todas las notas sonando simultáneamente).

Cada opción del ejercicio define un nombre y una secuencia de notas que se deben reproducir desde la nota raíz seleccionada al azar cada vez que se ejecuta el ejercicio. Dicha secuencia de notas se define como distancias relativas desde la nota raíz, describiendo el intervalo que forma cada nota en conjunción con la nota raíz. Por ejemplo, para una escala mayor, la secuencia de notas es «2 4 5 7 9 11 12», que representa respectivamente la estructura de la escala mayor «entera entera media entera entera entera media». El parámetro `sequenceFromRoot` puede contener notas de cualquier longitud. Además, el núcleo de Minuet se asegura de que solo se seleccionen al azar las respuestas cuyas notas caigan dentro del intervalo del teclado.

Para proporcionar una mejor infraestructura para organizar un gran conjunto de archivos de especificación de ejercicios, el núcleo de Minuet permite el uso de varios archivos de especificación, que se fusionan automáticamente para componer la jerarquía de ejercicios final que se muestra en el menú de navegación. Los ejercicios se fusionan correctamente siempre y cuando los distintos archivos de especificación usen el mismo nombre de (sub)categoría para definir los ejercicios. Hasta ahora, Minuet no proporciona ninguna GUI para crear especificaciones de ejercicios, por lo que usted deberá crear manualmente estos archivos JSON. Los archivos de especificación de ejercicios de Minuet se pueden instalar para todo el sistema o de forma local en la carpeta `minuet/exercises/` situada en `qtpaths `--paths GenericDataLocation``

Capítulo 4. Créditos y licencia
Créditos y licencia

# Capítulo 4. Créditos y licencia

Minuet

Copyright del programa 2016 Sandro Andrade `(sandroandrade AT kde.org)`

Copyright de la documentación (c) 2016 Sandro Andrade `(sandroandrade AT kde.org)`

Traducido por Eloy Cuadra `(ecuadra AT eloihr.net)`.

Esta documentación está sujeta a los términos de la Licencia de Documentación Libre GNU.

Este programa está sujeto a los términos de la Licencia Pública General GNU.